Create Listings POST /api/classifieds/list/v1

Create multiple Classifieds listings.

This API requires an access token.

This method supports query string params, or JSON input if the Content-Type is application/json.

Documentation

Input
  • token - Your backpack.tf account's access token. (XXXXXXXX)
  • listings - An array of listings to create.
    • intent - 0 (Buy) or 1 (Sell). Required.
    • id - Used if the intent is 1 (Sell); current id of the item to list.
    • item - Used if the intent is 0 (Buy); item specifier. This may change at any time.
      • quality - Quality name or id. Supports elevated qualities (e.g. Strange Unusual), use a space.
      • item_name - Name of the item or its defindex. Supports Killstreaks and Australium (prefix the name with the killstreak in question, or "Australium").
      • craftable? - Use 0 or 'Non-Craftable' to list a non-craftable item.
      • priceindex? - Priceindex of the item (see IGetPrices).
    • offers? - Set to 0 to only accept Steam friend requests.
    • buyout? - Set to 0 to allow negotiation.
    • promoted? - Set to 1 to promote this listing. You must have promote listings (and therefore be Premium), otherwise it is ignored. Only supported by sell listings.
    • details? - Listing comment. Limited to 200 characters.
    • currencies - Mapping of internal currency name (see IGetCurrencies) to its price you wish to list the item for (e.g. "metal": 10).
Output
  • message - If the status code is not 2xx, this contains the reason for failure.
  • listings - Listing creation results. Keyed by item id (sell orders) or item name (buy orders), in the same order as the input.
    • created - If set, the listing was created successfully.
    • error - If set, an error occured. See the failure enum below.
    • retry - Set if the error is RelistTimeout. Unix timestamp, at which the listing may be relisted.
    • used - Set if the error is ListingCapExceeded. How many listings you currently have.
    • cap - Set if the error is ListingCapExceeded. What your listing cap is.

Listing Failure Reason enum

enum {
    OK = 0;
    ItemNotInInventory = 1;
    InvalidItem = 2;
    ItemNotListable = 3;
    ItemNotTradable = 4;
    MarketplaceItemNotPriced = 5;
    RelistTimeout = 6;
    ListingCapExceeded = 7;
    CurrenciesNotSpecified = 8;
    CyclicCurrency = 9;
    PriceNotSpecified = 10;
    UnknownIntent = 11;
}