Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Última actualización 14/03/2025
Listing types and exposures
Listings types by site
| Site | Classic "id": "gold_special" |
Premium "id": "gold_pro" |
|---|---|---|
| MLB | ||
| MLM | ||
| MCO | ||
| MLC | ||
| MLA |
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_typesExample:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/sites/MLB/listing_typesExample:
[
{
"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'
http://api.mercadolibre.com/global/items/
-d '{
"sites_to_sell": [
{
"site_id": "MLM",
"logistic_type": "remote",
"listing_type_id": "gold_special"
}
],
"title": "Test Items Stainless Steel Water Jug",
"category_id": "CBT74531",
"price": 65.99,
"available_quantity": 99,
"description": {
"plain_text": "Introducing the Test Items Stainless Steel Water Jug, designed to meet the demands of modern hydration while offering a sleek, contemporary aesthetic. Engineered with high-quality stainless steel, this water jug is not only durable but also resistant to rust and corrosion, ensuring long-lasting use for any occasion.\n The NEW FLOW feature ensures a smooth and effortless pouring experience, preventing spills and providing easy access to refreshing water. Its ergonomic handle is designed for comfortable grip, making it ideal for both indoor and outdoor use, from family gatherings to picnics in the park.\nThe stylish, polished finish of the stainless steel exterior complements any kitchen or dining setting, while the inner lining keeps beverages cool for extended periods. With a generous capacity, the Test Items Water Jug is perfect for serving large groups, making it an essential addition to your home, office, or dining establishment.\n"
},
"pictures": [
{
"id": "701198-CBT79185512197_092024"
},
{
"id": "802215-CBT79185512155_092024"
},
{
"id": "703102-CBT79185512191_092024"
},
{
"id": "868333-CBT79185512175_092024"
},
{
"id": "798904-CBT79185512203_092024"
},
{
"id": "978585-CBT79185512171_092024"
},
{
"id": "952093-CBT79185512195_092024"
},
{
"id": "706052-CBT79185512181_092024"
},
{
"id": "994127-CBT79185512159_092024"
},
{
"id": "684314-CBT79185512193_092024"
},
{
"id": "871149-CBT79185512173_092024"
},
{
"id": "896111-CBT79185512177_092024"
}
],
"attributes": [
{
"id": "BRAND",
"name": "Brand",
"value_id": "35486409",
"value_name": "Other"
},
{
"id": "HEIGHT",
"value_name": "25 cm",
"name": "Height",
"value_id": null
},
{
"value_id": "242085",
"value_name": "Yes",
"id": "INCLUDES_LID",
"name": "Includes lid"
},
{
"id": "IS_KIT",
"value_name": "No",
"name": "Is kit",
"value_id": "242084"
},
{
"value_id": "2230284",
"id": "ITEM_CONDITION",
"name": "Item condition",
"value_name": "New"
},
{
"id": "PACKAGE_HEIGHT",
"name": "Package height",
"value_id": null,
"value_name": "12.29 cm"
},
{
"name": "Package length",
"value_id": null,
"value_name": "28.9 cm",
"id": "PACKAGE_LENGTH"
},
{
"value_name": "381.01 g",
"id": "PACKAGE_WEIGHT",
"name": "Package weight",
"value_id": null
},
{
"id": "PACKAGE_WIDTH",
"name": "Package width",
"value_id": null,
"value_name": "18.48 cm"
},
{
"id": "SELLER_SKU",
"name": "SKU",
"value_id": null,
"value_name": "70079449"
},
{
"id": "GTIN",
"name": "Universal product code",
"value_id": null,
"value_name": "764486313435"
},
{
"id": "JUG_CAPACITY",
"value_id": null,
"value_name": "1 L",
"name": "Jug capacity"
},
{
"name": "Jug material",
"value_id": "30380925",
"id": "JUG_MATERIAL",
"value_name": "Acero inoxidable"
},
{
"name": "Jug type",
"value_id": "22680526",
"value_name": "Water",
"id": "JUG_TYPE"
},
{
"name": "Lid material",
"value_name": "Stainless steel",
"id": "LID_MATERIAL",
"value_id": "2765623"
},
{
"id": "MODEL",
"value_id": null,
"value_name": "cántara",
"name": "Model"
},
{
"name": "With handle",
"value_id": "242084",
"value_name": "No",
"id": "WITH_HANDLE"
},
{
"id": "WITH_POURING_SPOUT",
"name": "With pouring spout",
"value_id": "242084",
"value_name": "No"
}
],
"condition": "new",
"listing_type_id": "gold_pro",
"sale_terms": [
{
"id": "WARRANTY_TYPE",
"name": "Warranty type",
"value_id": "6150835",
"value_name": "No warranty"
}
]
}'
Response:
{
"item_id": "CBT2253088559",
"seller_id": 2227281946,
"site_id": "CBT",
"site_items": [
{
"item_id": "MLM2247277269",
"seller_id": 2227281948,
"site_id": "MLM",
"logistic_type": "remote"
}
]
}
Or make a new listing based on an existing publication:
Example
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
"sites_to_sell": [
{
"site_id": "MLA",
"logistic_type": "remote",
"price":99.23,
"listing_type_id": "gold_special"
}
]
}
https://api.mercadolibre.com/global/items/CBT2253088559
Response
{
"site_id": "CBT",
"site_items": [
{
"item_id": "MLA2022178282",
"seller_id": 2227795872,
"site_id": "MLA",
"logistic_type": "remote"
}
]
}
See more about creating marketplace items.
Upgrade or Down Grade your listing type
Listings on our sites can be upgraded (from “gold_special”, to “gold_pro"") to higher listing types for greater exposure. You can also make a downgrade (from "gold_prol”, to “gold_special"")
Request:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
"site_id": "MLM",
"logistic_type": "remote",
"listing_type_id": "gold_special"
}
https://api.mercadolibre.com/global/items/$ITEM_IDExample:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
"site_id": "MLM",
"logistic_type": "remote",
"listing_type_id": "gold_pro"
}
https://api.mercadolibre.com/global/items/CBT2253088559
Response 200
Next: Product identifiers.