Create or update products and listings

Create listings

Every merchant working with us can create a sale offer or a "Listing" of a Product in order to sell it on our marketplace. Our algorithm decides which Listing will win "The Backbox" and therefore which Listing will be displayed on our website for the consumer to purchase.

In this section we will describe an endpoint that allows you either to create Listings matching existing Products or to create both Products and Listings for these products at the same time. We will also present how to create Listings matching existing Products. Please refer to the section Create products to know how to create both Products and Listings for these Products in the same API call.

Note that we limit the size of the CSV file that you can send to 15000 lines.

You can find the list of columns for the catalog field in the Back Market back-office following the tab "Options > Batch Listing Creation".

In the catalog field, a unique (case insensitive) sku must be provided by the merchant to identify the Listing.

Besides, either the product_id field or ean must be provided to match the Product you'd like to make an offer on. product_id prevails in case of conflict.

You can find the list of columns for the catalog field in the Back Market back-office following the tab "Options > Batch Listing Creation".

Update several listings

It is possible to update several Listings at a time using CSV files, which you can send with an API call. For example you might want to add another country to the listings. You might also need to change their prices, comments or the available stocks (quantities).

To put a Listing offline, just set its quantity to 0.

The endpoint below is not as efficient as the one described in "update specific listing", because the update will NOT be taken into account in real-time.

Indeed, you will have to wait for the task to be processed and to check the task for possible errors. Yet, you will be able to update several Listings at a time using the endpoint below, as opposed to the one described in "update specific listing".

We advise you not to use this endpoint to deal with stocks. Nevertheless, it can be useful if you'd like to update prices for your whole catalog for instance.

Note that we limit the size of the CSV file that you can send to 15000 lines.

For the catalog field, the sku must be provided to match the Listing you want to update (sku is case insensitive).

Create products

In this section, we'll guide you through the process of creating a Product on Back Market.

Overview

If you wish to sell a Product that is not currently available on Back Market, you can propose the creation of a new Product. This proposal will be reviewed and either approved or rejected by our team.

Important: It is not possible to create a Product without a corresponding Listing using our API.

Creating Products and Listings

This section explains how to create both Products and their corresponding Listings in a single API call.

• Each row in the CSV file you upload via the API can perform different actions based on the values provided.
• You can also create and update Listings for existing Products within the same API call.

CSV File Requirements

• The CSV file you submit must not exceed 15,000 lines.
• You can generate a CSV file with all the required columns based on the product category in your back office by navigating to: Options > Batch Listing Creation.

By following these guidelines, you can efficiently manage your product listings on Back Market.

Update products

After creation, since Products are multi-merchant, they cannot be directly updated after validation by our team. You will have to contact us for all requests related to this matter.

In the case a Product hasn't been validated by our team yet, the merchant who created this Product can update it as long as it's not been validated. To do so, you need to perform the same actions you made during the product creation, but this time providing modified values.

If you try to update a Product, which is already existing (EAN or Back Market id match a Product in our Database) and has already been validated by our team, it won't return any error but the modification won't be taken into account. The product will still remain unchanged.

{
  "catalog": "sku,quantity,price\nMY_SKU,50,123.45",
  "quotechar": "\"",
  "delimiter": ",",
  "encoding": "utf-8"
}

{
  "statuscode": 200
}