Documentation Mercado Libre

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

Documentation

Last update 18/04/2024

Listing types and exposures

Currently, sellers can publish items only with Premium listing type, and in Brazil and Colombia marketplaces you will be able to choose between Premium and Classic types. Each listing type has its own characteristics, let’s take a look at 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

Important:
The Classic listing type is now available on MCO. Shortly we will be adding this listing type to MLM and MLC.
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 creating marketplace items.


Edit listing type

If you have items in MLB and MCO 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 from 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.