Documentation Mercado Libre

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

Documentation

Last update 25/03/2024

Listing types and exposures

Important:
Starting from March 18th, the classic listing type will also be available for the Colombian marketplace.

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

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


* The Classic listing type is scheduled to be available soon on MCO. We will confirm the date shortly.



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.