Documentation Mercado Libre
Check out all the necessary information about APIs Mercado Libre.
Documentation
Last update 21/09/2023
Listing types and exposures
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
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.