Documentation Mercado Libre

Check out all the necessary information about APIs Mercado Libre.
circulos azuis em degrade

Documentation

Last update 21/09/2023

Listing types and exposures

Currently, sellers can publish items only with Premium listing type and in the Brazil marketplace you will be able to choose between Premium and Classic types. Each listing type has it’s own characteristics, let’s take a look of how to work with them.
You can see more about Selling fee and Additional per unit fee or Check the selling fee by searching for the category of your listings.

Listings types by site

Site Premium
"id": "gold_pro"
Classic
"id": "gold_special"
MLB
MLM
MCO
MLC


With this API you can consult the available listing type per site

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/sites/$SITE_ID/listing_types

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/sites/MLB/listing_types

Example:

[
   {
       "site_id": "MLB",
       "id": "gold_pro",
       "name": "Premium"
   },
   {
       "site_id": "MLB",
       "id": "gold_special",
       "name": "Clássico"
   }
]

Create marketplace item with "gold_special" listing type

Example:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN'  -H 'Content-Type: application/json' https://api.mercadolibre.com/marketplace/items/CBT1234 
{
  "config": [
    {
      "site_id": "MLB",
      "logistic_type": "remote",
      "price":11.23,
      "listing_type_id": "gold_special",
    }
  ]
}

See more about create marketplace items.


Edit listing type

If you have items in MLB with "gold_pro" (Premium), you can update to "gold_special" (Classic).

Request:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "id": "gold_special"
}
https://api.mercadolibre.com/marketplace/items/$ITEM_ID/listing_type
Note:
If the listing has stock 0 (status: paused, substatus: out of stock), it will be paused. You can activate it by adding new quantities.

Get available upgrades

You can make upgrades to higher listing types to give your listings more exposure on our sites. If you need to make an upgrade, you can check which listing types are available for your item. Listings are allowed to have downgrades between gold_pro to gold_special and back anytime.


Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/items/$ITEM_ID/available_upgrades

Response:

[
   {
       "site_id": "MLB",
       "id": "gold_pro",
       "name": "Premium"
   }
]

Next: Product identifiers.