You can list items under a few different listing types, according to the level of exposition to users you want to get. Each listing type has it’s own characteristics and feeds.
Listings types by site
First of all, to see all available listing types on a site, you should make a GET to listing_types resources with the Site_id:
EXAMPLE:
https://api.mercadolibre.com/sites/MLA/listing_types
RESPONSE:
[
{
"site_id": "MLA",
"id": "gold_premium",
"name": "Oro Premium"
},
{
"site_id": "MLA",
"id": "gold_special",
"name": "Oro Profesional"
},
{
"site_id": "MLA",
"id": "gold",
"name": "Oro"
},
{
"site_id": "MLA",
"id": "silver",
"name": "Plata"
},
{
"site_id": "MLA",
"id": "bronze",
"name": "Bronce"
},
{
"site_id": "MLA",
"id": "free",
"name": "Gratuita"
}
]
Listing type specification
If you want more information about an specific listing_type, include the listing_type on the GET call:
EXAMPLE:
https://api.mercadolibre.com/sites/MLA/listing_types/bronze
RESPONSE:
{
"id": "bronze",
"not_available_in_categories": [
"MLA1743",
"MLA1459"
],
"configuration": {
"name": "Bronce",
"listing_exposure": "low",
"requires_picture": false,
"max_stock_per_item": 999,
"deduction_profile_id": null,
"duration_days": {
"buy_it_now": 60,
"auction": 7,
"classified": null
},
"immediate_payment": {
"buy_it_now": false,
"auction": false,
"classified": false
},
"mercado_pago": "mandatory",
"listing_fee_criteria": {
"min_fee_amount": 0,
"max_fee_amount": 0,
"percentage_of_fee_amount": 0,
"currency": "ARS"
},
"sale_fee_criteria": {
"min_fee_amount": 11,
"max_fee_amount": 1210,
"percentage_of_fee_amount": 11,
"currency": "ARS"
}
},
"exceptions_by_category": [
{
"category_id": "MLA1540",
"category_name": "Servicios",
"configuration": {
"name": "Básico 90",
"listing_exposure": "mid",
"requires_picture": false,
"max_stock_per_item": 999,
"deduction_profile_id": null,
"duration_days": {
"buy_it_now": null,
"auction": null,
"classified": 90
},
"immediate_payment": {
"buy_it_now": false,
"auction": false,
"classified": false
},
"mercado_pago": "not_available",
"listing_fee_criteria": {
"min_fee_amount": 229,
"max_fee_amount": 229,
"percentage_of_fee_amount": 0,
"currency": "ARS"
},
"sale_fee_criteria": {
"min_fee_amount": 0,
"max_fee_amount": 0,
"percentage_of_fee_amount": 0,
"currency": null
}
},
"exceptions_by_category": [
]
}
]
}
Available listing types
You can query available listing types by user and for a given category_id.
EXAMPLE:
https://api.mercadolibre.com/users/{Cust_id}/available_listing_types?category_id={Category_id}&access_token=$ACCESS_TOKEN
RESPONSE:
{
"category_id": "MLA3530",
"available": [
{
"site_id": "MLA",
"id": "gold_premium",
"name": "Oro Premium",
"remaining_listings": null
},
{
"site_id": "MLA",
"id": "gold",
"name": "Oro",
"remaining_listings": null
},
{
"site_id": "MLA",
"id": "silver",
"name": "Plata",
"remaining_listings": null
},
{
"site_id": "MLA",
"id": "bronze",
"name": "Bronce",
"remaining_listings": null
},
{
"site_id": "MLA",
"id": "free",
"name": "Gratuita",
"remaining_listings": null
}
]
}
If you can’t list under a certain listing type and you want to know why you don’t have it available, you can make this GET call to know the cause:
EXAMPLE:
https://api.mercadolibre.com/users/{Cust_id}/available_listing_type/free?category_id={Category_id}&access_token=$ACCESS_TOKEN
RESPONSE:
{
"available": false,
"cause": "You have more than 5 transactions in the last year.",
"code": "list.transactions.exceeded"
}
Listing exposures
This API returns information about the exposure levels associated to all listing types in MercadoLibre.
You can query all listing exposures available by site, making a simple GET call.
EXAMPLE:
https://api.mercadolibre.com/sites/MLA/listing_exposures
RESPONSE:
{[
{
"id": "lowest",
"name": "Última",
"home_page": false,
"category_home_page": false,
"advertising_on_listing_page": true,
"priority_in_search": 4
},
{
"id": "low",
"name": "Inferior",
"home_page": false,
"category_home_page": false,
"advertising_on_listing_page": false,
"priority_in_search": 3
},
{
"id": "mid",
"name": "Media",
"home_page": false,
"category_home_page": true,
"advertising_on_listing_page": false,
"priority_in_search": 2
},
{
"id": "high",
"name": "Alta",
"home_page": false,
"category_home_page": true,
"advertising_on_listing_page": false,
"priority_in_search": 1
},
{
"id": "highest",
"name": "Superior",
"home_page": true,
"category_home_page": true,
"advertising_on_listing_page": false,
"priority_in_search": 0
}
]
And query each one by it’s Id:
EXAMPLE:
https://api.mercadolibre.com/sites/MLA/listing_exposures/high
RESPONSE:
{
"id": "high",
"name": "Alta",
"home_page": false,
"category_home_page": true,
"advertising_on_listing_page": false,
"priority_in_search": 1
}
Available upgrades
You can make an upgrade to a higher listing type, but never to a lower listing type.
If you need to make an upgrade, you can check which listing types are available for your item.
EXAMPLE:
https://api.mercadolibre.com/items/{Item_id}/available_upgrades?access_token=$ACCESS_TOKEN
RESPONSE:
[
{
"site_id": "MLA",
"id": "gold_premium",
"name": "Oro Premium"
},
{
"site_id": "MLA",
"id": "gold",
"name": "Oro"
},
{
"site_id": "MLA",
"id": "silver",
"name": "Plata"
}
]
If you want to know how to list an item under a certain listing_type or make an item upgrade, check the following tutorials:
List items tutorial
Modify item tutorial
Check this link for most common errors. For further assistance, please check our forums or connect to our irc channel (#meli@irc.freenode.net). In case you find an issue in our API, please report it on GitHub.