Sync and modify listings

Once you have active listings on our marketplace, you’ll probably need to update and modify those listings from time to time in order to synchronize stock with other platforms you’re working with, pause listings, improve descriptions, update prices and more.
To update the stock of products you must do it through the Global item and to update the prices in the different marketplaces you must do it through each marketplace item. Follow this guide to know how to achieve this actions.

Contents

→Considerations
→Update your item
      ↳Global item´s title
      ↳Marketplace item´s title
      ↳Description
      ↳Pictures
→Change listing status
→Status descriptions
→Update stock
→Update prices
→Delete marketplace items


Considerations

Not every field can be updated and this will vary whether the item had sales or not, and also remember your item must be active in order to be modified. You can modify the values for:

  • Available_quantity
  • Price
  • Video
  • Pictures
  • Description
  • Shipping

When the item has sales, you cannot change any of the following fields:

  • Title
  • Condition
  • Buying mode

Also remember that:

  • Listing type can be modified only once.


Update your item

Let’s see a basic example of updating an item title and price. The only thing you need is the item_id of the listed product and of course, the seller’s access token.


Title

To update the item title you need is the item_id of the listed product and the seller’s access_token.


Update global item´s title

If you want to update the global item´s title, it has to be in english.
This updated title will not be replicated automatically to their marketplaces items listed. Then you should perform an update to each marketplace item title per site. Remember that if you list on a new site, this marketplace item, it will have the global item title.

Example:

curl -X PUT -d
{
  "title": "Your new title",
}
https://api.mercadolibre.com/items/$ITEM_ID?access_token=$ACCESS_TOKEN

Update marketplace item´s title

To update the marketplace items title, write it in the local language per site:

  • for Mercado Libre México and Chile in spanish
  • for Mercado Livre Brazil in portuguese
  • and make a PUT with the site_id, logistic_type and title with the new title in the body.

    Note:
    We don't allow changes in the titles of the items with sales achieved (sold_quantity = 0). Remember this to restrict this in your tool and avoid errors in this type of update.
    curl -X PUT -d
    {
       "site_id": "MLM",
       "logistic_type": "remote",
       "title": "Your new title"
    }
    https://api.mercadolibre.com/marketplace/items/$ITEM_ID?access_token=$ACCESS_TOKEN

    See the response status to know everything went well. Keep in mind that it can take some time until you see the item’s information refreshed.


    Description

    It’s very easy to update a description, and is something you can do whether the item has bids or not. Check our Guide to modify items to make sure you get it right.


    Pictures

    You can always add or replace item pictures. Learn more our working with pictures guide to know the best way to get through it.


    Change listing status

    The available status to global and marketplace items are active or paused and can be managed by the user (seller).


    Status descriptions

    Active: Listing is active and bids and questions can be received. You can change the listing display (upgrade listing type).
    Paused: Listing is paused and bids and questions cant be received. It may be automatically (out of stock) or at the user's discretion.
    Inactive: Listing is closed and you can't make any other action.
    Under review: Listing has moderated due a problem and needs to be fixed.


    Update stock

    To update a marketplace item stock you have to make a PUT and add the quantity value in the “available_quantity” field taking the following into account. Remember that this change can be made to items and item variations.

    For example, if the seller has 10 (ten) units in stock, they must be detailed in the Global item and this amount will be in all sites where the item is listed, as well as when a sale is made, the subtraction will be reflected in the Global Selling site.

    Update stock without variations

    Request:

    curl -X PUT 
    {
       "available_quantity": number
    }
    https://api.mercadolibre.com/items/$ITEM_ID?access_token=$ACCESS_TOKEN

    Example:

    curl -X PUT
    {
       "available_quantity":100
    }
    https://api.mercadolibre.com/items/CBT927817181?access_token=$ACCESS_TOKEN

    Response:

    {
       "id": "CBT939124833",
        "site_id": "CBT",
        "title": "Test Item - For Loadtest Tests",
        "subtitle": null,
        "seller_id": 526124693,
        "category_id": "CBT11796",
        "official_store_id": null,
        "price": 15.1,
        "base_price": 15.1,
        "original_price": null,
        "inventory_id": null,
        "currency_id": "USD",
        "initial_quantity": 1,
        "available_quantity": 100,
        "sold_quantity": 0,
        "sale_terms": [...],
        "buying_mode": "buy_it_now",
        "listing_type_id": "gold_pro",
        "start_time": "2020-06-19T19:35:57.000Z",
        "stop_time": "2040-06-14T04:00:00.000Z",
        "end_time": "2040-06-14T04:00:00.000Z",
        "expiration_time": "2020-09-07T19:37:30.837Z",
        "condition": "new",
        "permalink": "",
        "pictures": [...],
        "video_id": null,
        "descriptions": [...],
        "accepts_mercadopago": true,
        "non_mercado_pago_payment_methods": [],
        "shipping": {...},
        "international_delivery_mode": "none",
        "seller_address": {...},
        "seller_contact": null,
        "location": {},
        "geolocation": {...},
        "coverage_areas": [],
        "attributes": [...],
        "warnings": [],
        "listing_source": "",
        "variations": [],
        "thumbnail": "http://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/I-ES.jpg",
        "secure_thumbnail": "https://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/I-ES.jpg",
        "status": "active",
        "sub_status": [],
        "tags": [...],
        "warranty": "Factory warranty: 90 days",
        "catalog_product_id": null,
        "domain_id": "CBT-BABIES_FOOTWEAR",
        "seller_custom_field": null,
        "parent_item_id": null,
        "differential_pricing": null,
        "deal_ids": [],
        "automatic_relist": false,
        "date_created": "2020-06-19T19:35:57.000Z",
        "last_updated": "2020-06-19T19:37:30.882Z",
        "health": null,
        "catalog_listing": false,
        "item_relations": []
    }

    Update stock with variations

    Request:

    curl -X PUT 
    {
    "variations": [
           {
               "id": number,
               "available_quantity": number
           },
           {
                "id": number,
               "available_quantity": number
           }
       ]
    }
    https://api.mercadolibre.com/items/$ITEM_ID?access_token=$ACCESS_TOKEN

    Example:

    curl -X PUT 
    {
    "variations": [
           {
               "id": 60819719795,
               "available_quantity": 100
           },
           {
                "id": 60819719802,
               "available_quantity": 150
           }
       ]
    }
    https://api.mercadolibre.com/items/CBT944238398?access_token=$ACCESS_TOKEN

    The response will contain the same fields and the variations that you updated in the PUT.


    Considerations

    • When making a PUT to an available_quantity with 0, the status will change to “paused” with out_of_stock sub status.
    • When making a PUT to an available_quantity high 0 and out_of_stock status, the status will change to active without out_of_stock sub status.

    Update prices

    In relation to the price of the product, the seller can put a specific price for each marketplace item and if it's not defined, the price of the Global item will be replicated on marketplace items. Look at the next PUT example to modify a specific marketplace item price.

    Request:

    curl -X PUT  
    {
        "site_id": string,
        "logistic_type": string,
        "price": number
    }
    https://api.mercadolibre.com/marketplace/items/$ITEM_ID?access_token=$ACCESS_TOKEN

    Example:

    curl -X PUT  
    {
        "site_id": “MLM”,
        "logistic_type": “remote”, 
        "price": 30
    }
    https://api.mercadolibre.com/marketplace/items/CBT939124833?access_token=$ACCESS_TOKEN

    Response:

    {
        "item_id": "CBT939124833",
        "parent_id": "CBT939124833",
        "logistic_type": "remote",
        "site_id": "MLM",
        "errors": null
    }

    Delete marketplace items

    In order to delete marketplace items, the item to delete must be in a paused or closed state and then make the following PUT.


    Next: Fulfillment stock.