Documentation Mercado Libre
Check out all the necessary information about APIs Mercado Libre.Documentation
Last update 22/08/2024
Create Global item
The items are created in Global Selling (CBT site) and then can be listed in the marketplaces of Mercado Libre that the seller has enabled. Make the next request POST with an access_token. Also, you can learn more Items specifications. The listing quota per site is 10.000 per day.
Request:
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X POST http://api.mercadolibre.com/items
Example:
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X POST http://api.mercadolibre.com/items
{
"listing_type_id":"gold_pro",
"title":"Test Item - for LoadTest tests",
"available_quantity":100,
"category_id":"CBT11796",
"buying_mode":"buy_it_now",
"currency_id":"USD",
"condition":"new",
"site_id":"CBT",
"price":15.1,
"accepts_mercadopago":true,
"non_mercado_pago_payment_methods":[
],
"warranty":"1 year",
"sale_terms":[
{
"id":"WARRANTY_TIME",
"value_name":"90 days"
},
{
"id":"WARRANTY_TYPE",
"value_id":"2230279"
}
],
"attributes":[
{
"id":"PACKAGE_HEIGHT",
"value_name":"10 cm"
},
{
"id":"FOOTWEAR_TYPE",
"value_name":"Zapatilla"
},
{
"id":"PACKAGE_WIDTH",
"value_name":"10 cm"
},
{
"id":"PACKAGE_LENGTH",
"value_name":"10 cm"
},
{
"id":"PACKAGE_WEIGHT",
"value_name":"0.7 lb"
},
{
"id":"BRAND",
"name":"Brand",
"value_id":null,
"value_name":"DOMINIQ",
{
"id":"GENDER",
"name":"Gender",
"value_id":"371795",
"value_name":"Babies",
},
{
"id":"ITEM_CONDITION",
"name":"Item condition",
"value_id":"2230284",
"value_name":"New",
},
{
"id":"MODEL",
"name":"Model",
"value_id":null,
"value_name":"A-59081-6",
},
{
"id":"COLOR",
"name":"Color",
"tags":{
"allow_variations":true,
"defines_picture":true,
"required":true
},
"hierarchy":"CHILD_PK",
"relevance":1,
"value_type":"string",
"value_max_length":255,
"values":[
{
"id":"52010"
}
]
},
{
"id":"SIZE",
"name":"Size",
"value_id":null,
"value_name":"7 M US Women / 5.5 M US Men",
"tags":{
"allow_variations":true,
"required":true
},
"hierarchy":"CHILD_PK",
"relevance":1,
"value_type":"string",
"value_max_length":255,
},
{
"id":"GTIN",
"name":"Universal product code",
"value_name":"9102110000",
"tags":{
"multivalued":true,
"required":true,
"variation_attribute":true,
"used_hidden":true,
"validate":true
},
"hierarchy":"PRODUCT_IDENTIFIER",
"relevance":1,
"type":"product_identifier",
"value_type":"string",
"value_max_length":255,
"tooltip":"How do I recognize it? It is an 8 to 14 digit number next to the barcode, on the product box or on its label.\n\n![Universal product code](https://http2.mlstatic.com/static/org-img/sd-landings/assets/pi-tooltip.png)",
}
],
"pictures":[
{
"source":"http://www.mercadolibre.com/jm/img?s=STC&v=O&f=proccesing_image_es.jpg"
}
]
}
Modify Global item details
With this resource you may modify Global Selling items on the site where the user requires it.
Parameters
id: It is the Global Selling item identifier, which is created through a call to the local API.
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/items/CBT1234
-H 'Cache-Control: no-cache' \
-H 'Content-Type: application/json' \
-d '{
"site_id": "MLM",
"logistic_type": "remote",
"price": 1,
}
Response:
{
"action": "POST",
"item_id": "MLM111111",
"parent_id": "CBT1234",
"logistic_type": "remote",
"site_id": "MLM",
"errors": null
}
Errors
Error | Error message | Description | Possible solution |
---|---|---|---|
item.start_time.invalid | Start time $startTime is only updateable in NOT_YET_ACTIVE ítems. | Field start time cannot be updated. | The parameter start_time can only be updated if the item status is NOT_YET_ACTIVE |
item.category_id.invalid | Category $categoryId does not exist. | Category not found. | To see the available categories check the page/sites/$siteId (Check $sideId). |
item.category_id.invalid | Is not allowed to post in category $categoryId. Make sure you’re posting in a leaf category. | $category.listing_allowed false. | Before post an item, make sure it is allowed to post in the chosen category, see the parameter listing_allowed on /categories/$categoryId. |
item.buying_mode.invalid | Category $categoryId only supports listing modes: $category.buyingModes. | $item.buying_modes is invalid. | To see the available listing modes in category check the page /categories/$categoryId in parameter settings:{buying_modes:[…]}. |
item.attributes. missing_required |
The attributes $requiredAttributeIds are required for category $item.categoryId. Check the attribute is present in the attributes list or in all variation attributes combination. | Category is required atribute. | To see the attributes mandatory on this category check the page /categories/$categoryId/attributes in parameter {tags:{required:{true}}}. |
item.listing_type_id.invalid | Invalid listing_type_id. | $item.listing_type_id is invalid. | To see the available listing types in category check the page /categories/$categoryId/listing_types. |
item.listing_type_id. requiresPictures |
Pictures are mandatory for listing type $item.listingTypeId. | Pictures is required. | To see if the pictures is mandatory in category check the page /categories/$categoryId/ listing_types/silver in parameter requires_picture:{}. |
item.site_id.invalid | Site $item.siteId doesn’t exist. | $item.site_id is invalid. | To the available sites, see the page /sites. |
item.description.max | The description field is too long. More than $maxSize characters is not allowed. | Number of characters exceeded. | The number of characters in description must be less then 50000 characters. |
item.pictures.max | Items in category $item.categoryId cannot exceeds $maxPicturesPerItem pictures. | Number of images exceeded. | To see the quantity of pictures per item in category check the page /categories/$categoryId in parametermax_pictures_per_item:{}. |
item.video_id.dropped | Item video id was dropped. | Youtube videos are not longer supported | Not applicable. |
item.attributes. invalid_length |
Invalid value length for attribute $it.attributeId. | Maximum length is ${attribute.value_max_length}. | To see the attributes max_length on this attribute check the page /categories/$categoryId/attributes in parameter value_max_length for attributes with .value_type string or number. |
seller.unable_to_list | The seller cannot post. | The seller cannot post for certain cause. Identify the “cause” field in the response. | - Find out the meaning of “cause” under /users#options, set the status to list, and you will see the meaning. - Try to make the first manual posting from My Account in Mercado Libre to see the warnings in the flow. |
Next: Marketplace items.