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
Product identifiers
GTIN and identifiers types
GTIN (Global Trade Item Number) is the global trade item number used to unequivocally identify any product or item about which there is a need to both retrieve specific information and put a price to. The GTIN will save all the PIs in this field, concatenating values. This is a standard that includes EAN, UPC, JAN, GTIN14, ISBN, ISBN10 and ISBN13 codes.
Currently, the attribute has the tag new_required and indicates that it is mandatory if the publication has a new condition.
Send product identifier information
You can send this information just like you post attributes, regardless of the category.
Example of item without variations:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/global/items/
-d '{
"sites_to_sell": [
{
"site_id": "MLM",
"logistic_type": "remote"
},
{
"site_id": "MLA",
"logistic_type": "remote"
}
],
"title": "Test Items Stainless Steel Water Jug with variations",
"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 example of item without variations:
{
"item_id": "CBT2300912600",
"seller_id": 2227281946,
"site_id": "CBT",
"site_items": [
{
"item_id": "MLM2246336099",
"seller_id": 2227281948,
"site_id": "MLM",
"logistic_type": "remote"
},
{
"item_id": "MLA2021589026",
"seller_id": 2227795872,
"site_id": "MLA",
"logistic_type": "remote"
}
]
}Example of item with variations:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN'
http://api.mercadolibre.com/global/items/
-d
'{
"sites_to_sell": [
{
"site_id": "MLM",
"logistic_type": "remote"
},
{
"site_id": "MLA",
"logistic_type": "remote"
}
],
"title": "Test Items Stainless Steel Water Jug with variations",
"category_id": "CBT74531",
"price": 25.95,
"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"
},
{
"id": "826514-CBT79185512157_092024"
},
{
"id": "834923-CBT79185512185_092024"
},
{
"id": "822761-CBT79185512163_092024"
},
{
"id": "701460-CBT79185512205_092024"
},
{
"id": "877786-CBT79185512213_092024"
},
{
"id": "677333-CBT79185512169_092024"
},
{
"id": "858260-CBT79185512165_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": "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"
}
],
"variations": [
{
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "283165",
"value_name": "Gray"
}
],
"available_quantity": 36,
"price": 25.95,
"picture_ids": [
"701198-CBT79185512197_092024",
"802215-CBT79185512155_092024",
"703102-CBT79185512191_092024",
"868333-CBT79185512175_092024",
"798904-CBT79185512203_092024",
"978585-CBT79185512171_092024",
"952093-CBT79185512195_092024"
],
"attributes": [
{
"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"
}
]
},
{
"attribute_combinations": [
{
"value_name": "Pink",
"id": "COLOR",
"name": "Color",
"value_id": "51994"
}
],
"available_quantity": 13,
"picture_ids": [
"706052-CBT79185512181_092024",
"994127-CBT79185512159_092024",
"684314-CBT79185512193_092024",
"871149-CBT79185512173_092024",
"896111-CBT79185512177_092024",
"826514-CBT79185512157_092024"
],
"attributes": [
{
"id": "PACKAGE_HEIGHT",
"name": "Package height",
"value_id": null,
"value_name": "11.01 cm"
},
{
"id": "PACKAGE_LENGTH",
"name": "Package length",
"value_id": null,
"value_name": "29.01 cm"
},
{
"id": "PACKAGE_WEIGHT",
"name": "Package weight",
"value_id": null,
"value_name": "377.01 g"
},
{
"id": "PACKAGE_WIDTH",
"name": "Package width",
"value_id": null,
"value_name": "17.01 cm"
},
{
"id": "SELLER_SKU",
"name": "SKU",
"value_id": null,
"value_name": "70079450"
},
{
"id": "GTIN",
"name": "Universal product code",
"value_id": null,
"value_name": "764486313466"
}
],
"price": 25.95
}
],
"condition": "new",
"listing_type_id": "gold_pro",
"sale_terms": [
{
"id": "WARRANTY_TYPE",
"name": "Warranty type",
"value_id": "6150835",
"value_name": "No warranty"
}
]
}'
Response example of item with variations:
{
"item_id": "CBT2300963366",
"seller_id": 2227281946,
"site_id": "CBT",
"site_items": [
{
"item_id": "MLM3576532224",
"seller_id": 2227281948,
"site_id": "MLM",
"logistic_type": "remote"
},
{
"item_id": "MLA2021576308",
"seller_id": 2227795872,
"site_id": "MLA",
"logistic_type": "remote"
}
]
}
Add information to an existing item
Example of item variation:
Adding the GTIN attribute with the corresponding product code.
No variations
'https://api.mercadolibre.com/global/items/CBT2300912600?access_token=$ACCESS_TOKEN'
-d '{
"attributes": [
{
"id": "GTIN",
"value_name": "7898937064478"
}
]
}'Response 200 OK
With variations
In the same way that any attribute in a variation is added or modified, to add or modify them you must indicate the list of variations that you want to remain in the item (indicating its variation ID), and add the list of attributes that you want to remain in each of the variations.
'https://api.mercadolibre.com/items/CBT2300963366?access_token=$ACCESS_TOKEN'
-d '{
"variations": [
{
"id": 183007318470,
"attributes": [
{
"id": "GTIN",
"value_name": "4004133109216"
}
]
},
{
"id": 183007318472,
"attributes": [
{
"id": "GTIN",
"value_name": "2800001053351"
}
]
}
]
}'
Response 200 OK
Remember, if the item have the GTIN attribute to item level, cannot specify again to variant level. In this case, you have to quit to item level and then, specify to variation level.
Query information about product identifiers
To get this information, you should make a GET to the API:
Request:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID?include_attributes=allExample:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/CBT945341307?include_attributes=allResponse:
{
"id":"CBT945341307",
"site_id":"CBT",
"title":"Test Item With Gtin Code And Variations",
"subtitle":null,
"seller_id":567809758,
"category_id":"CBT1645",
"official_store_id":null,
"price":30.11,
"base_price":30.11,
"original_price":null,
"currency_id":"USD",
"initial_quantity":10,
"available_quantity":2,
"sold_quantity":0,
"sale_terms":[
{
"id":"WARRANTY_TYPE",
"name":"Type of warranty",
"value_id":"2230279",
"value_name":"Factory warranty",
"value_struct":null,
"values":[
{
"id":"2230279",
"name":"Factory warranty",
"struct":null
}
]
},
{
"id":"WARRANTY_TIME",
"name":"Warranty time",
"value_id":null,
"value_name":"90 days",
"value_struct":{
"number":90,
"unit":"days"
},
"values":[
{
"id":null,
"name":"90 days",
"struct":{
"number":90,
"unit":"days"
}
}
]
}
],
"buying_mode":"buy_it_now",
"listing_type_id":"gold_pro",
"start_time":"2020-08-05T16:25:04.000Z",
"stop_time":"2040-07-31T04:00:00.000Z",
"condition":"new",
"permalink":"",
"thumbnail":"http://cbt-s2-p.mlstatic.com/758781-CBT43037911711_082020-I.jpg",
"secure_thumbnail":"https://cbt-s2-p.mlstatic.com/758781-CBT43037911711_082020-I.jpg",
"pictures":[
{
"id":"861758-CBT43037911712_082020",
"url":"http://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/O-ES.jpg",
"secure_url":"https://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/O-ES.jpg",
"size":"500x500",
"max_size":"500x500",
"quality":""
},
{
"id":"758781-CBT43037911711_082020",
"url":"http://cbt-s2-p.mlstatic.com/758781-CBT43037911711_082020-O.jpg",
"secure_url":"https://cbt-s2-p.mlstatic.com/758781-CBT43037911711_082020-O.jpg",
"size":"490x500",
"max_size":"1597x1629",
"quality":""
}
],
"video_id":null,
"descriptions":[
{
"id":"CBT945341307-2838163975"
}
],
"accepts_mercadopago":true,
"non_mercado_pago_payment_methods":[
],
"shipping":{
"mode":"not_specified",
"methods":[
],
"tags":[
],
"dimensions":null,
"local_pick_up":false,
"free_shipping":false,
"logistic_type":"not_specified",
"store_pick_up":false
},
"international_delivery_mode":"none",
"seller_address":{
"city":{
"id":"Q04tQkpCZWlqaW5n",
"name":"Beijing"
},
"state":{
"id":"CN-BJ",
"name":"Beijing"
},
"country":{
"id":"CN",
"name":"China"
},
"id":1103366569
},
"seller_contact":null,
"location":{
},
"coverage_areas":[
],
"attributes":[
{
"id":"BRAND",
"name":"Brand",
"value_id":"18527",
"value_name":"Durabrand",
"value_struct":null,
"values":[
{
"id":"18527",
"name":"Durabrand",
"struct":null
}
],
"attribute_group_id":"OTHERS",
"attribute_group_name":"Others"
},
{
"id":"FAN_TYPE",
"name":"Fan type",
"value_id":"6350778",
"value_name":"Window fan",
"value_struct":null,
"values":[
{
"id":"6350778",
"name":"Window fan",
"struct":null
}
],
"attribute_group_id":"OTHERS",
"attribute_group_name":"Others"
},
{
"id":"MODEL",
"name":"Model",
"value_id":null,
"value_name":"HSD",
"value_struct":null,
"values":[
{
"id":null,
"name":"HSD",
"struct":null
}
],
"attribute_group_id":"OTHERS",
"attribute_group_name":"Others"
},
{
"id":"PACKAGE_HEIGHT",
"name":"Package height",
"value_id":null,
"value_name":"100 cm",
"value_struct":{
"number":100,
"unit":"cm"
},
"values":[
{
"id":null,
"name":"100 cm",
"struct":{
"number":100,
"unit":"cm"
}
}
],
"attribute_group_id":"OTHERS",
"attribute_group_name":"Others"
},
{
"id":"PACKAGE_LENGTH",
"name":"Package length",
"value_id":null,
"value_name":"10 cm",
"value_struct":{
"number":10,
"unit":"cm"
},
"values":[
{
"id":null,
"name":"10 cm",
"struct":{
"number":10,
"unit":"cm"
}
}
],
"attribute_group_id":"OTHERS",
"attribute_group_name":"Others"
},
{
"id":"PACKAGE_WEIGHT",
"name":"Package weight",
"value_id":null,
"value_name":"1.7 lb",
"value_struct":{
"number":1.7,
"unit":"lb"
},
"values":[
{
"id":null,
"name":"1.7 lb",
"struct":{
"number":1.7,
"unit":"lb"
}
}
],
"attribute_group_id":"OTHERS",
"attribute_group_name":"Others"
},
{
"id":"PACKAGE_WIDTH",
"name":"Package width",
"value_id":null,
"value_name":"100 cm",
"value_struct":{
"number":100,
"unit":"cm"
},
"values":[
{
"id":null,
"name":"100 cm",
"struct":{
"number":100,
"unit":"cm"
}
}
],
"attribute_group_id":"OTHERS",
"attribute_group_name":"Others"
}
],
"warnings":[
],
"listing_source":"",
"variations":[
{
"id":61382392580,
"price":30.11,
"attribute_combinations":[
{
"id":"STRUCTURE_COLOR",
"name":"Structure color",
"value_id":"52005",
"value_name":"Brown",
"value_struct":null,
"values":[
{
"id":"52005",
"name":"Brown",
"struct":null
}
]
}
],
"available_quantity":1,
"sold_quantity":0,
"sale_terms":[
],
"picture_ids":[
"758781-CBT43037911711_082020"
],
"catalog_product_id":null,
"attributes":[
{
"id":"GTIN",
"name":"Universal product code",
"value_id":null,
"value_name":"4006381333931",
"value_struct":null,
"values":[
{
"id":null,
"name":"4006381333931",
"struct":null
}
]
}
]
},
{
"id":61382392584,
"price":30.11,
"attribute_combinations":[
{
"id":"STRUCTURE_COLOR",
"name":"Structure color",
"value_id":"52049",
"value_name":"Black",
"value_struct":null,
"values":[
{
"id":"52049",
"name":"Black",
"struct":null
}
]
}
],
"available_quantity":1,
"sold_quantity":0,
"sale_terms":[
],
"picture_ids":[
"758781-CBT43037911711_082020"
],
"catalog_product_id":null,
"attributes":[
{
"id":"GTIN",
"name":"Universal product code",
"value_id":null,
"value_name":"7015057271221",
"value_struct":null,
"values":[
{
"id":null,
"name":"7015057271221",
"struct":null
}
]
}
]
}
],
"status":"active",
"sub_status":[
],
"tags":[
"immediate_payment"
],
"warranty":"Factory warranty: 90 days",
"catalog_product_id":null,
"domain_id":"CBT-FANS",
"parent_item_id":null,
"differential_pricing":null,
"deal_ids":[
],
"automatic_relist":false,
"date_created":"2020-08-05T16:25:04.000Z",
"last_updated":"2020-08-05T20:06:17.000Z",
"health":null,
"catalog_listing":false
}Considerations
- They are not internal SKUs.
- Now, you should take this into account when loading Product Identifiers. The GTIN will save all the PIs in this field, concatenating values. Just like the ISBN, with the identifiers that it includes.
- Check if the attribute has the tag new_required and the condition of the item is new, since the attribute is mandatory to publish.
- The number of characters varies by code type: they can have 8, 10, 12, 13 or 14 characters. You can even rewrite the same code with left zero padding and it will still be valid.
- GTINs sent are validated and, if not valid, the POST will not be allowed.
- It is advisable to include the Brand and, at least, one additional identifier. These are the conditions required to participate in third-party product listings, such as Google Shopping.
Message code reference
| Error_code | Error type | Error message | Description | Possible solution |
|---|---|---|---|---|
| 7710 | ERROR | Product Identifier [GTIN] has invalid values: [00000000] | The Product Identifier inserted isn´t valid. | Introduce a valid Product Identifier. |
| 7711 | WARNING | Product Identifier [GTIN] has invalid format values: [abc12345] | The Product Identifier inserted isn´t valid. | Introduce a valid Product Identifier. |
Resource identifier description
BRAND: Brand.
MPN: Manufacturer Part Number.
GTIN: Global Trade Item Number.
Part Number
The codes used to unequivocally locate an automotive spare part by defining the spare part compatibilities, among others, are referred to as Part Numbers. Based on a specific part number we can learn the car for which it is used.
Next: Variations.