Documentation Mercado Libre
Check out all the necessary information about APIs Mercado Libre.
Documentation
Last update 03/11/2023
Create charts in TOPS and BOTTOMS domains
For TOPS and BOTTOMS domains, such as: pants, shirts, dresses, among others. Should consult of the list available domains for size chart We have included attributes of the data type value_type: list a List, which contains a set of international values predetermined by Mercado Libre to specify certain attributes of a customized size charts, additionally you will find the multivalued tag that will allow you to create the charts with one or more specific values within the list for each row, for example: you can see that the size XLargeincludes the values of the size list from 3XL TO 6XL (3XL,4XL, 5XL.6XL) while the size Smal corresponds to a value of size XS and S.
In the TOPS and BOTTOMS domains only SPECIFIC charts can be used, or customized charts specified by each vendor. When consulting the technical data sheet of the size charts you will see in the result a list data type that determines a List, this attribute will indicate the possible values that it can take, both its value_id and its value_name. It is mandatory for the values of filtrable sizes to exist in the technical spec.
Example of creating a customized size charts from a list:
Request
curl -X POST 'https://api.mercadolibre.com/catalog/charts' -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json'Example
curl 'https://api.mercadolibre.com/catalog/charts' -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' -d '{
{
"names": {
"CBT": "TSHIRT EX1",
"MLM": "TSHIRT EX1",
"MLB": "TSHIRT EX1",
"MLC": "TSHIRT EX1",
"MCO": "TSHIRT EX1"
},
"type": "SPECIFIC",
"seller_id": 1161438226,
"domain_id": "T_SHIRTS",
"site_id": "CBT",
"attributes": [
{
"id": "GENDER",
"values": [
{
"name": "Woman"
}
]
}
],
"main_attribute": {
"attributes": [
{
"site_id": "CBT",
"id": "SIZE"
},
{
"site_id": "MLM",
"id": "SIZE"
},
{
"site_id": "MLB",
"id": "SIZE"
},
{
"site_id": "MLC",
"id": "SIZE"
},
{
"site_id": "MCO",
"id": "SIZE"
}
]
},
"rows": [
{
"sites": [
"CBT",
"MLM",
"MLB",
"MLC",
"MCO"
],
"attributes": [
{
"id": "SIZE",
"values": [
{
"name": "Small"
}
]
},
{
"id": "FILTRABLE_SIZE",
"values": [
{
"name": "XS"
},
{
"name": "S"
}
]
},
{
"id": "CHEST_CIRCUMFERENCE_FROM",
"values": [
{
"name": "60 cm"
}
]
},
{
"id": "CHEST_CIRCUMFERENCE_TO",
"values": [
{
"name": "65 cm"
}
]
},
{
"id": "WAIST_CIRCUMFERENCE_FROM",
"values": [
{
"name": "100 cm"
}
]
},
{
"id": "WAIST_CIRCUMFERENCE_TO",
"values": [
{
"name": "105 cm"
}
]
},
{
"id": "PERSON_HEIGHT_FROM",
"values": [
{
"name": "1.54 cm"
}
]
},
{
"id": "PERSON_HEIGHT_TO",
"values": [
{
"name": "1.55 cm"
}
]
},
{
"id": "HIP_CIRCUMFERENCE_FROM",
"values": [
{
"name": "80 cm"
}
]
},
{
"id": "HIP_CIRCUMFERENCE_TO",
"values": [
{
"name": "85 cm"
}
]
},
{
"id": "NECK_CIRCUMFERENCE_FROM",
"values": [
{
"name": "15 cm"
}
]
},
{
"id": "NECK_CIRCUMFERENCE_TO",
"values": [
{
"name": "18 cm"
}
]
}
]
}
]
}Response:
{
"id": "812789",
"names": {
"CBT": "TSHIRT EX1",
"MLM": "TSHIRT EX1",
"MLB": "TSHIRT EX1",
"MLC": "TSHIRT EX1",
"MCO": "TSHIRT EX1"
},
"domain_id": "T_SHIRTS",
"site_id": "CBT",
"type": "SPECIFIC",
"seller_id": 1161438226,
"main_attribute": {
"attributes": [
{
"site_id": "CBT",
"id": "SIZE"
},
{
"site_id": "MLM",
"id": "SIZE"
},
{
"site_id": "MLB",
"id": "SIZE"
},
{
"site_id": "MLC",
"id": "SIZE"
},
{
"site_id": "MCO",
"id": "SIZE"
}
]
},
"secondary_attribute": {
"attributes": []
},
"attributes": [
{
"id": "GENDER",
"values": [
{
"id": "339665",
"name": "Woman"
}
]
}
],
"rows": [
{
"id": "812789:1",
"sites": [
"CBT",
"MLM",
"MLB",
"MLC",
"MCO"
],
"attributes": [
{
"id": "SIZE",
"values": [
{
"name": "Small"
}
]
},
{
"id": "FILTRABLE_SIZE",
"values": [
{
"id": "12917776",
"name": "XS"
}
]
},
{
"id": "CHEST_CIRCUMFERENCE_FROM",
"values": [
{
"name": "60 cm",
"struct": {
"number": 60.0,
"unit": "cm"
}
}
]
},
{
"id": "CHEST_CIRCUMFERENCE_TO",
"values": [
{
"name": "65 cm",
"struct": {
"number": 65.0,
"unit": "cm"
}
}
]
},
{
"id": "WAIST_CIRCUMFERENCE_FROM",
"values": [
{
"name": "100 cm",
"struct": {
"number": 100.0,
"unit": "cm"
}
}
]
},
{
"id": "WAIST_CIRCUMFERENCE_TO",
"values": [
{
"name": "105 cm",
"struct": {
"number": 105.0,
"unit": "cm"
}
}
]
},
{
"id": "PERSON_HEIGHT_FROM",
"values": [
{
"name": "1.54 cm",
"struct": {
"number": 1.54,
"unit": "cm"
}
}
]
},
{
"id": "PERSON_HEIGHT_TO",
"values": [
{
"name": "1.55 cm",
"struct": {
"number": 1.55,
"unit": "cm"
}
}
]
},
{
"id": "HIP_CIRCUMFERENCE_FROM",
"values": [
{
"name": "80 cm",
"struct": {
"number": 80.0,
"unit": "cm"
}
}
]
},
{
"id": "HIP_CIRCUMFERENCE_TO",
"values": [
{
"name": "85 cm",
"struct": {
"number": 85.0,
"unit": "cm"
}
}
]
},
{
"id": "NECK_CIRCUMFERENCE_FROM",
"values": [
{
"name": "15 cm",
"struct": {
"number": 15.0,
"unit": "cm"
}
}
]
},
{
"id": "NECK_CIRCUMFERENCE_TO",
"values": [
{
"name": "18 cm",
"struct": {
"number": 18.0,
"unit": "cm"
}
}
]
}
]
}
]
}To consider:
- The values received within the list, type attribute, will be validated against the list that Mercado Libre has in the datasheet, in case of sending a value that is not within that list, it will return an error of type value_is_not_in_the_list.
{
"error": "chart_validation_error",
"message": "Chart validation errors found",
"status": 400,
"errors": [{
"code": "value_is_not_in_the_list",
"message": "Value AAAA in attribute FILTRABLE_SIZE is incorrect",
"cell": {
"attribute_id": "FILTRABLE_SIZE",
"row": {
"id": null,
"main_attribute": {
"id": "SIZE",
"value": "Small"
}
}
}
}]
}
- To specify the list type field, you can send the value_id or the value_name, in case of sending both parameters the value_id has more relevance than the value_name.
Create Item with associate size chart
1. Associate size chart to an item
To associate a size chart to listings within the required domains, you will have to execute a POST on the items, sending the new attributes of type SIZE_GRID_ID, the size chart which we want to associate the item or variation and SIZE_GRID_ROW_ID with reference to the row in the size chart.
The size_grid_id and size_grid_row_id fields are new attributes in the payload at item creation.
- size_grid_id: is the id of the size chart that was created.
- size_grid_row: is the id of the grid row.
- The user that creates the item must be the same one that created the chart.
- The chart gender must be corresponding to item gender.
- It is not possible to associate a chart without row_id> associated.
In the creation of the footwear article, the attributes of the size guide number created in the previous steps must be included. It should be inserted in the attribute block, following the example below:
- SIZE_GRID_ID:
- id: the new field "SIZE_GRID_ID"
- value_name: the ID (number) of the guide.
"attributes": [
{
"id" :"SIZE_GRID_ID",
"value_name": "664737"
},We also need to associate the size guide rows with the variations of the article being created. In other words, each variation must be associated with a row from the size table. Therefore, the "SIZE_GRID_ROW_ID" field should be included in the variation attributes:
- SIZE_GRID_ROW_ID:
- id the new field "SIZE_GRID_ROW_ID".
- value_name: the ID (number) of the guide + ":" + the corresponding row number in the size table. For example apply to footwear:
"attributes": [
{
"id" :"SIZE_GRID_ROW_ID",
"value_name": "664737:1"
},Request:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" https://api.mercadolibre.com/items -dExample:
curl 'https://api.mercadolibre.com/items' -H 'Content-Type: application/json' -H 'Authorization: Bearer $ACCESS_TOKEN' -d '{
{
"site_id": "CBT",
"title": "CREATE ITEM WITH - GDT SNEAKER MAN ",
"category_id": "CBT3724",
"official_store_id": null,
"price": 12,
"currency_id": "USD",
"available_quantity": 7,
"sale_terms": [
{
"id": "WARRANTY_TYPE",
"name": "Warranty type",
"value_id": "6150835",
"value_name": "No warranty",
"value_struct": null,
"values": [
{
"id": "6150835",
"name": "No warranty",
"struct": null
}
],
"value_type": "list"
}
],
"buying_mode": "buy_it_now",
"listing_type_id": "gold_pro",
"start_time": "2022-10-17T20:18:52.000Z",
"condition": "new",
"pictures": [
{
"id": "644516-CBT51699767208_092022",
"url": "http://http2.mlstatic.com/D_644516-CBT51699767208_092022-O.jpg",
"secure_url": "https://http2.mlstatic.com/D_644516-CBT51699767208_092022-O.jpg",
"size": "500x247",
"max_size": "1205x597",
"quality": ""
},
{
"id": "862503-CBT51700450573_092022",
"url": "http://http2.mlstatic.com/D_862503-CBT51700450573_092022-O.jpg",
"secure_url": "https://http2.mlstatic.com/D_862503-CBT51700450573_092022-O.jpg",
"size": "500x247",
"max_size": "1214x600",
"quality": ""
}
],
"video_id": null,
"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
},
"seller_address": {
"address_line": "No.1003 shennandadao road, futian District",
"zip_code": "518033",
"city": {
"id": "Q04tR0RTaGVuemhlbg",
"name": "Shenzhen"
},
"state": {
"id": "CN-GD",
"name": "Guangdong"
},
"country": {
"id": "CN",
"name": "China"
}
},
"location": {},
"coverage_areas": [],
"attributes": [
{
"id" :"SIZE_GRID_ID",
"value_name": "664737"
},
{
"id": "AGE_GROUP",
"name": "Age",
"value_id": "6725189",
"value_name": "Adults",
"value_struct": null,
"values": [
{
"id": "6725189",
"name": "Adults",
"struct": null,
"source": 2579503448603610
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others",
"source": 2579503448603610,
"value_type": "list"
},
{
"id": "BRAND",
"name": "Brand",
"value_id": "10331273",
"value_name": "Generic",
"value_struct": null,
"values": [
{
"id": "10331273",
"name": "Generic",
"struct": null,
"source": 4954751883138633
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others",
"source": 4954751883138633,
"value_type": "string"
},
{
"id": "FOOTWEAR_TYPE",
"name": "Footwear type",
"value_id": "517583",
"value_name": "Sneaker",
"value_struct": null,
"values": [
{
"id": "517583",
"name": "Sneaker",
"struct": null,
"source": 4954751883138633
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others",
"source": 4954751883138633,
"value_type": "list"
},
{
"id": "GENDER",
"name": "Gender",
"value_id": "339666",
"value_name": "Man",
"value_struct": null,
"values": [
{
"id": "339666",
"name": "Man",
"struct": null,
"source": 4954751883138633
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others",
"source": 4954751883138633,
"value_type": "list"
},
{
"id": "ITEM_CONDITION",
"name": "Item condition",
"value_id": "2230284",
"value_name": "New",
"value_struct": null,
"values": [
{
"id": "2230284",
"name": "New",
"struct": null,
"source": 4954751883138633
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others",
"source": 4954751883138633,
"value_type": "list"
},
{
"id": "MODEL",
"name": "Model",
"value_id": null,
"value_name": "generic",
"value_struct": null,
"values": [
{
"id": null,
"name": "generic",
"struct": null,
"source": 4954751883138633
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others",
"source": 4954751883138633,
"value_type": "string"
},
{
"id": "STYLE",
"name": "Style",
"value_id": "6694773",
"value_name": "Urban",
"value_struct": null,
"values": [
{
"id": "6694773",
"name": "Urban",
"struct": null,
"source": 4954751883138633
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others",
"source": 4954751883138633,
"value_type": "list"
}
],
"variations": [
{
"id": 175507138874,
"price": 12,
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "2450295",
"value_name": "Black",
"value_struct": null,
"values": [
{
"id": "2450295",
"name": "Black",
"struct": null,
"source": 4954751883138633
}
],
"source": 4954751883138633,
"value_type": "string"
},
{
"id": "SIZE",
"name": "Size",
"value_id": "469803",
"value_name": "5 US-M",
"value_struct": null,
"values": [
{
"id": "",
"name": "5 US-M",
"struct": null,
"source": 3376461333454861
}
],
"source": 3376461333454861,
"value_type": "string"
}
],
"available_quantity": 5,
"sale_terms": [],
"picture_ids": [
"644516-CBT51699767208_092022"
],
"seller_custom_field": null,
"catalog_product_id": null,
"attributes": [
{
"id" :"SIZE_GRID_ROW_ID",
"value_name": "664737:1"
},
{
"id": "MAIN_COLOR",
"name": "Main color",
"value_id": "2450295",
"value_name": "Black",
"value_struct": null,
"values": [
{
"id": "2450295",
"name": "Black",
"struct": null,
"source": 4954751883138633
}
],
"source": 4954751883138633,
"value_type": "list"
},
{
"id": "PACKAGE_HEIGHT",
"name": "Package height",
"value_id": null,
"value_name": "30 cm",
"value_struct": {
"number": 30,
"unit": "cm"
},
"values": [
{
"id": null,
"name": "30 cm",
"struct": {
"number": 30,
"unit": "cm"
},
"source": 4954751883138633
}
],
"source": 4954751883138633,
"value_type": "number_unit"
},
{
"id": "PACKAGE_LENGTH",
"name": "Package length",
"value_id": null,
"value_name": "30 cm",
"value_struct": {
"number": 30,
"unit": "cm"
},
"values": [
{
"id": null,
"name": "30 cm",
"struct": {
"number": 30,
"unit": "cm"
},
"source": 4954751883138633
}
],
"source": 4954751883138633,
"value_type": "number_unit"
},
{
"id": "PACKAGE_WEIGHT",
"name": "Package weight",
"value_id": null,
"value_name": "1 kg",
"value_struct": {
"number": 1,
"unit": "kg"
},
"values": [
{
"id": null,
"name": "1 kg",
"struct": {
"number": 1,
"unit": "kg"
},
"source": 4954751883138633
}
],
"source": 4954751883138633,
"value_type": "number_unit"
},
{
"id": "PACKAGE_WIDTH",
"name": "Package width",
"value_id": null,
"value_name": "30 cm",
"value_struct": {
"number": 30,
"unit": "cm"
},
"values": [
{
"id": null,
"name": "30 cm",
"struct": {
"number": 30,
"unit": "cm"
},
"source": 4954751883138633
}
],
"source": 4954751883138633,
"value_type": "number_unit"
},
{
"id": "GTIN",
"name": "Universal product code",
"value_id": null,
"value_name": "7899680328732",
"value_struct": null,
"values": [
{
"id": null,
"name": "7899680328732",
"struct": null,
"source": 4954751883138633
}
],
"source": 4954751883138633,
"value_type": "string"
}
],
"inventory_id": null,
},
{
"id": 175669183151,
"price": 12,
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "52028",
"value_name": "Blue",
"value_struct": null,
"values": [
{
"id": "52028",
"name": "Blue",
"struct": null,
"source": 3376461333454861
}
],
"source": 3376461333454861,
"value_type": "string"
},
{
"id": "SIZE",
"name": "Size",
"value_id": "469803",
"value_name": "6 US-M",
"value_struct": null,
"values": [
{
"id": "",
"name": "6 US-M",
"struct": null,
"source": 3376461333454861
}
],
"source": 3376461333454861,
"value_type": "string"
}
],
"available_quantity": 2,
"sold_quantity": 0,
"sale_terms": [],
"picture_ids": [
"862503-CBT51700450573_092022"
],
"seller_custom_field": null,
"catalog_product_id": null,
"attributes": [
{
"id" :"SIZE_GRID_ROW_ID",
"value_name": "664737:2"
},
{
"id": "MAIN_COLOR",
"name": "Main color",
"value_id": "2450293",
"value_name": "Blue",
"value_struct": null,
"values": [
{
"id": "2450293",
"name": "Blue",
"struct": null,
"source": 3376461333454861
}
],
"source": 3376461333454861,
"value_type": "list"
},
{
"id": "PACKAGE_HEIGHT",
"name": "Package height",
"value_id": null,
"value_name": "30 cm",
"value_struct": {
"number": 30,
"unit": "cm"
},
"values": [
{
"id": null,
"name": "30 cm",
"struct": {
"number": 30,
"unit": "cm"
},
"source": 3376461333454861
}
],
"source": 3376461333454861,
"value_type": "number_unit"
},
{
"id": "PACKAGE_LENGTH",
"name": "Package length",
"value_id": null,
"value_name": "30 cm",
"value_struct": {
"number": 30,
"unit": "cm"
},
"values": [
{
"id": null,
"name": "30 cm",
"struct": {
"number": 30,
"unit": "cm"
},
"source": 3376461333454861
}
],
"source": 3376461333454861,
"value_type": "number_unit"
},
{
"id": "PACKAGE_WEIGHT",
"name": "Package weight",
"value_id": null,
"value_name": "1 kg",
"value_struct": {
"number": 1,
"unit": "kg"
},
"values": [
{
"id": null,
"name": "1 kg",
"struct": {
"number": 1,
"unit": "kg"
},
"source": 3376461333454861
}
],
"source": 3376461333454861,
"value_type": "number_unit"
},
{
"id": "PACKAGE_WIDTH",
"name": "Package width",
"value_id": null,
"value_name": "30 cm",
"value_struct": {
"number": 30,
"unit": "cm"
},
"values": [
{
"id": null,
"name": "30 cm",
"struct": {
"number": 30,
"unit": "cm"
},
"source": 3376461333454861
}
],
"source": 3376461333454861,
"value_type": "number_unit"
},
{
"id": "GTIN",
"name": "Universal product code",
"value_id": null,
"value_name": "7899680328732",
"value_struct": null,
"values": [
{
"id": null,
"name": "7899680328732",
"struct": null,
"source": 3376461333454861
}
],
"source": 3376461333454861,
"value_type": "string"
}
],
"inventory_id": null,
"item_relations": []
}
],
"status": "active",
"tags": [
"test_item",
"immediate_payment"
],
"warranty": "No warranty",
"catalog_product_id": null,
"domain_id": "CBT-SNEAKERS",
"seller_custom_field": null,
"automatic_relist": false,
"catalog_listing": false,
"channels": [
"marketplace"
]
}'Response:
Success 201
{
"id": "CBT1727681183",
"site_id": "CBT",
"title": "Create Item With - Gdt Sneaker Man ",
"subtitle": null,
"seller_id": 1161438226,
"category_id": "CBT3724",
"user_product_id": null,
"official_store_id": null,
"price": 12,
"base_price": 12,
"original_price": null,
"inventory_id": null,
"currency_id": "USD",
"initial_quantity": 7,
"available_quantity": 7,
"sold_quantity": 0,
"sale_terms": [
{
"id": "WARRANTY_TYPE",
"name": "Warranty type",
"value_id": "6150835",
"value_name": "No warranty",
"value_struct": null,
"values": [
{
"id": "6150835",
"name": "No warranty",
"struct": null
}
],
"value_type": "list"
}
],
"buying_mode": "buy_it_now",
"listing_type_id": "gold_pro",
"start_time": "2023-06-30T19:33:34.795Z",
"stop_time": "2043-06-25T04:00:00.000Z",
"end_time": "2043-06-25T04:00:00.000Z",
"expiration_time": "2023-09-18T19:33:34.902Z",
"condition": "new",
"permalink": "",
"pictures": [
{
"id": "644516-CBT51699767208_092022",
"url": "http://cbt-s1-p.mlstatic.com/644516-CBT51699767208_092022-O.jpg",
"secure_url": "https://cbt-s1-p.mlstatic.com/644516-CBT51699767208_092022-O.jpg",
"size": "500x247",
"max_size": "1200x595",
"quality": ""
},
{
"id": "862503-CBT51700450573_092022",
"url": "http://cbt-s2-p.mlstatic.com/862503-CBT51700450573_092022-O.jpg",
"secure_url": "https://cbt-s2-p.mlstatic.com/862503-CBT51700450573_092022-O.jpg",
"size": "500x247",
"max_size": "1200x594",
"quality": ""
}
],
"video_id": null,
"descriptions": [],
"accepts_mercadopago": true,
"non_mercado_pago_payment_methods": [],
"shipping": {
"mode": "not_specified",
"local_pick_up": false,
"free_shipping": false,
"methods": [],
"dimensions": null,
"tags": [],
"logistic_type": "not_specified",
"store_pick_up": false
},
"international_delivery_mode": "none",
"seller_address": {
"id": 1288377745,
"comment": "",
"address_line": "No.999 shangai road, shensei District",
"zip_code": "518033",
"city": {
"id": "Q04tR0RTaGVuemhlbg",
"name": "Shenzhen"
},
"state": {
"id": "CN-GD",
"name": "Guangdong"
},
"country": {
"id": "CN",
"name": "China"
},
"latitude": "",
"longitude": "",
"search_location": {
"neighborhood": {
"id": "",
"name": ""
},
"city": {
"id": "",
"name": ""
},
"state": {
"id": "",
"name": ""
}
}
},
"seller_contact": null,
"location": {},
"geolocation": {
"latitude": "",
"longitude": ""
},
"coverage_areas": [],
"attributes": [
{
"id": "SIZE_GRID_ID",
"name": "Size grid ID",
"value_id": null,
"value_name": "664737",
"value_struct": null,
"values": [
{
"id": null,
"name": "664737",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others",
"value_type": "grid_id"
},
{
"id": "BRAND",
"name": "Brand",
"value_id": "10331273",
"value_name": "Generic",
"value_struct": null,
"values": [
{
"id": "10331273",
"name": "Generic",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others",
"value_type": "string"
},
{
"id": "FOOTWEAR_TYPE",
"name": "Footwear type",
"value_id": "517583",
"value_name": "Sneaker",
"value_struct": null,
"values": [
{
"id": "517583",
"name": "Sneaker",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others",
"value_type": "list"
},
{
"id": "GENDER",
"name": "Gender",
"value_id": "339666",
"value_name": "Man",
"value_struct": null,
"values": [
{
"id": "339666",
"name": "Man",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others",
"value_type": "list"
},
{
"id": "ITEM_CONDITION",
"name": "Item condition",
"value_id": "2230284",
"value_name": "New",
"value_struct": null,
"values": [
{
"id": "2230284",
"name": "New",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others",
"value_type": "list"
},
{
"id": "MODEL",
"name": "Model",
"value_id": null,
"value_name": "generic",
"value_struct": null,
"values": [
{
"id": null,
"name": "generic",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others",
"value_type": "string"
},
{
"id": "STYLE",
"name": "Style",
"value_id": "6694773",
"value_name": "Urban",
"value_struct": null,
"values": [
{
"id": "6694773",
"name": "Urban",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others",
"value_type": "list"
}
],
"warnings": [
{
"department": "structured-data",
"cause_id": 1212,
"code": "normalize.item.attribute.values",
"message": "Attribute [SIZE] to be modified - values [(469803,6 US-M)] should be [(null,6 US-M)] - Normalized form: [invalid_value_id]",
"references": [
"item.variations[1].attribute_combinations[1].values"
]
},
{
"department": "items",
"cause_id": 303,
"code": "item.attributes.ignored",
"message": "Attribute [AGE_GROUP] ignored because it is not modifiable.",
"references": [
"item.attributes"
]
},
{
"department": "structured-data",
"cause_id": 1212,
"code": "normalize.item.attribute.values",
"message": "Attribute [SIZE] to be modified - values [(469803,5 US-M)] should be [(null,5 US-M)] - Normalized form: [invalid_value_id]",
"references": [
"item.variations[0].attribute_combinations[1].values"
]
},
{
"department": "shipping",
"cause_id": 4053,
"code": "shipping.lost_me1_by_user",
"message": "User has not mode me1",
"references": [
"user.shipping_preferences.modes"
]
},
{
"department": "structured-data",
"cause_id": 1212,
"code": "normalize.item.attribute.values",
"message": "Attribute [COLOR] to be modified - values [(2450295,Black)] should be [(52049,Black)] - Normalized form: [suggested_values]",
"references": [
"item.variations[0].attribute_combinations[0].values"
]
},
{
"department": "structured-data",
"cause_id": 2511,
"code": "create.item.attribute.business_conditional",
"message": "Attribute [FILTRABLE_GENDER] to be added with values [(18549360,null)]",
"references": [
"item.attributes"
]
},
{
"department": "structured-data",
"cause_id": 1212,
"code": "normalize.item.attribute.values",
"message": "Attribute [BRAND] to be modified - values [(10331273,Generic)] should be [(276243,Genérica)] - Normalized form: [migration]",
"references": [
"item.attributes[2].values"
]
},
{
"department": "structured-data",
"cause_id": 1011,
"code": "normalize.item.attribute.name",
"message": "Attribute [AGE_GROUP] to be modified - name [Age] should be [Age group]",
"references": [
"item.attributes[1].name"
]
},
{
"department": "shipping",
"cause_id": 4054,
"code": "shipping.lost_me1_by_catalog",
"message": "Catalog has not mode me1",
"references": [
"catalog.shipping_preferences.modes"
]
}
],
"listing_source": "",
"variations": [
{
"id": 178848074405,
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "2450295",
"value_name": "Black",
"value_struct": null,
"values": [
{
"id": "2450295",
"name": "Black",
"struct": null
}
],
"value_type": "string"
},
{
"id": "SIZE",
"name": "Size",
"value_id": "469803",
"value_name": "5 US-M",
"value_struct": null,
"values": [
{
"id": "469803",
"name": "5 US-M",
"struct": null
}
],
"value_type": "string"
}
],
"price": 12,
"available_quantity": 5,
"user_product_id": "CBTU412498",
"sold_quantity": 0,
"sale_terms": [],
"picture_ids": [
"644516-CBT51699767208_092022"
],
"seller_custom_field": null,
"catalog_product_id": null,
"attributes": [
{
"id": "MAIN_COLOR",
"name": "Main color",
"value_id": "2450295",
"value_name": "Black",
"value_struct": null,
"values": [
{
"id": "2450295",
"name": "Black",
"struct": null
}
],
"value_type": "list"
},
{
"id": "PACKAGE_HEIGHT",
"name": "Package height",
"value_id": null,
"value_name": "30 cm",
"value_struct": {
"number": 30,
"unit": "cm"
},
"values": [
{
"id": null,
"name": "30 cm",
"struct": {
"number": 30,
"unit": "cm"
}
}
],
"value_type": "number_unit"
},
{
"id": "PACKAGE_LENGTH",
"name": "Package length",
"value_id": null,
"value_name": "30 cm",
"value_struct": {
"number": 30,
"unit": "cm"
},
"values": [
{
"id": null,
"name": "30 cm",
"struct": {
"number": 30,
"unit": "cm"
}
}
],
"value_type": "number_unit"
},
{
"id": "PACKAGE_WEIGHT",
"name": "Package weight",
"value_id": null,
"value_name": "1 kg",
"value_struct": {
"number": 1,
"unit": "kg"
},
"values": [
{
"id": null,
"name": "1 kg",
"struct": {
"number": 1,
"unit": "kg"
}
}
],
"value_type": "number_unit"
},
{
"id": "PACKAGE_WIDTH",
"name": "Package width",
"value_id": null,
"value_name": "30 cm",
"value_struct": {
"number": 30,
"unit": "cm"
},
"values": [
{
"id": null,
"name": "30 cm",
"struct": {
"number": 30,
"unit": "cm"
}
}
],
"value_type": "number_unit"
},
{
"id": "SIZE_GRID_ROW_ID",
"name": "Size grid row ID",
"value_id": null,
"value_name": "664737:1",
"value_struct": null,
"values": [
{
"id": null,
"name": "664737:1",
"struct": null
}
],
"value_type": "grid_row_id"
},
{
"id": "GTIN",
"name": "Universal product code",
"value_id": null,
"value_name": "7899680328732",
"value_struct": null,
"values": [
{
"id": null,
"name": "7899680328732",
"struct": null
}
],
"value_type": "string"
}
],
"inventory_id": null,
"item_relations": []
},
{
"id": 178848074407,
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "52028",
"value_name": "Blue",
"value_struct": null,
"values": [
{
"id": "52028",
"name": "Blue",
"struct": null
}
],
"value_type": "string"
},
{
"id": "SIZE",
"name": "Size",
"value_id": "469803",
"value_name": "6 US-M",
"value_struct": null,
"values": [
{
"id": "469803",
"name": "6 US-M",
"struct": null
}
],
"value_type": "string"
}
],
"price": 12,
"available_quantity": 2,
"user_product_id": "CBTU412500",
"sold_quantity": 0,
"sale_terms": [],
"picture_ids": [
"862503-CBT51700450573_092022"
],
"seller_custom_field": null,
"catalog_product_id": null,
"attributes": [
{
"id": "MAIN_COLOR",
"name": "Main color",
"value_id": "2450293",
"value_name": "Blue",
"value_struct": null,
"values": [
{
"id": "2450293",
"name": "Blue",
"struct": null
}
],
"value_type": "list"
},
{
"id": "PACKAGE_HEIGHT",
"name": "Package height",
"value_id": null,
"value_name": "30 cm",
"value_struct": {
"number": 30,
"unit": "cm"
},
"values": [
{
"id": null,
"name": "30 cm",
"struct": {
"number": 30,
"unit": "cm"
}
}
],
"value_type": "number_unit"
},
{
"id": "PACKAGE_LENGTH",
"name": "Package length",
"value_id": null,
"value_name": "30 cm",
"value_struct": {
"number": 30,
"unit": "cm"
},
"values": [
{
"id": null,
"name": "30 cm",
"struct": {
"number": 30,
"unit": "cm"
}
}
],
"value_type": "number_unit"
},
{
"id": "PACKAGE_WEIGHT",
"name": "Package weight",
"value_id": null,
"value_name": "1 kg",
"value_struct": {
"number": 1,
"unit": "kg"
},
"values": [
{
"id": null,
"name": "1 kg",
"struct": {
"number": 1,
"unit": "kg"
}
}
],
"value_type": "number_unit"
},
{
"id": "PACKAGE_WIDTH",
"name": "Package width",
"value_id": null,
"value_name": "30 cm",
"value_struct": {
"number": 30,
"unit": "cm"
},
"values": [
{
"id": null,
"name": "30 cm",
"struct": {
"number": 30,
"unit": "cm"
}
}
],
"value_type": "number_unit"
},
{
"id": "SIZE_GRID_ROW_ID",
"name": "Size grid row ID",
"value_id": null,
"value_name": "664737:2",
"value_struct": null,
"values": [
{
"id": null,
"name": "664737:2",
"struct": null
}
],
"value_type": "grid_row_id"
},
{
"id": "GTIN",
"name": "Universal product code",
"value_id": null,
"value_name": "7899680328732",
"value_struct": null,
"values": [
{
"id": null,
"name": "7899680328732",
"struct": null
}
],
"value_type": "string"
}
],
"inventory_id": null,
"item_relations": []
}
],
"thumbnail_id": "644516-CBT51699767208_092022",
"thumbnail": "http://cbt-s1-p.mlstatic.com/644516-CBT51699767208_092022-I.jpg",
"secure_thumbnail": "https://cbt-s1-p.mlstatic.com/644516-CBT51699767208_092022-I.jpg",
"status": "active",
"sub_status": [],
"tags": [
"immediate_payment",
"test_item"
],
"warranty": "No warranty",
"catalog_product_id": null,
"domain_id": "CBT-SNEAKERS",
"seller_custom_field": null,
"parent_item_id": null,
"differential_pricing": null,
"deal_ids": [],
"automatic_relist": false,
"date_created": "2023-06-30T19:33:34.972Z",
"last_updated": "2023-06-30T19:33:34.972Z",
"health": null,
"catalog_listing": false,
"item_relations": [],
"channels": [
"marketplace"
]
}Result items with size chart
The publication result in Mercado Libre is that:
International Size Convert
In order to facilitate the creation of the size guide, it is now required to include only international sizes in the size chart. Consequently, the inclusion of local sizes (Brazil, Mexico, Colombia, and Chile) will be fully automated by our functionality, thus simplifying the size chart creation process for sellers.
In the image below, there is an example of how it will look. The "International Size" column pertains to the sizes added by the seller. The other columns with the names Brazil, Mexico, Colombia, and Chile have the equivalences added automatically by our functionality.
Automatic equivalence is available for both tops & bottoms size charts and for footwear.
Tops & Bottoms
Footwear
Search for equivalence size
To view international sizes, you can perform a GET request to list the equivalences. This valuable information allows you to know the local sizes of each country (Brazil, Mexico, Colombia and Chile) compared to the international size.
The request requires three query params: domain, gender and siteId.
- See here the available domains for the size chart.
- The available gender are:
- Woman
- Man
- Gender neutral
- Girls
- Boys
- Gender neutral kid
- Babies
- The available site_Id are:
- MLB
- MLM
- MCO
- MLC
Request:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/sizechart/equivalences?siteId=$SITE_ID&domain_id=$DOMAIN&gender=$GENDERExample:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/
sizechart/equivalences?domain_id=T_SHIRTS&gender=Gender neutral kidResponse:
Success 200 OK
{
"domain": "T_SHIRTS",
"gender": "Gender neutral kid",
"sizes": [
{
"international_size": "9 years",
"equivalences": [
{
"site": "MLB",
"size": "1 year"
},
{
"site": "MCO",
"size": "9 years"
},
{
"site": "MLM",
"size": "1 year"
},
{
"site": "MLC",
"size": "9 years"
}
]
},
{
"international_size": "12 years",
"equivalences": [
{
"site": "MLB",
"size": "4 years"
},
{
"site": "MCO",
"size": "12 years"
},
{
"site": "MLM",
"size": "4 years"
},
{
"site": "MLC",
"size": "12 years"
}
]
},
{
"international_size": "2 years",
"equivalences": [
{
"site": "MLB",
"size": "10 years"
},
{
"site": "MLM",
"size": "10 years"
},
{
"site": "MCO",
"size": "2 years"
},
{
"site": "MLC",
"size": "2 years"
}
]
},
{
"international_size": "11 years",
"equivalences": [
{
"site": "MLC",
"size": "11 years"
},
{
"site": "MLB",
"size": "3 years"
},
{
"site": "MCO",
"size": "11 years"
},
{
"site": "MLM",
"size": "3 years"
}
]
},
{
"international_size": "6 years",
"equivalences": [
{
"site": "MLM",
"size": "14 years"
},
{
"site": "MLC",
"size": "6 years"
},
{
"site": "MLB",
"size": "14 years"
},
{
"site": "MCO",
"size": "6 years"
}
]
},
{
"international_size": "15 years",
"equivalences": [
{
"site": "MLC",
"size": "15 years"
},
{
"site": "MLB",
"size": "7 years"
},
{
"site": "MCO",
"size": "15 years"
},
{
"site": "MLM",
"size": "7 years"
}
]
},
{
"international_size": "16 years",
"equivalences": [
{
"site": "MCO",
"size": "16 years"
},
{
"site": "MLC",
"size": "16 years"
},
{
"site": "MLB",
"size": "8 years"
},
{
"site": "MLM",
"size": "8 years"
}
]
},
{
"international_size": "14 years",
"equivalences": [
{
"site": "MLC",
"size": "14 years"
},
{
"site": "MLM",
"size": "6 years"
},
{
"site": "MLB",
"size": "6 years"
},
{
"site": "MCO",
"size": "14 years"
}
]
},
{
"international_size": "10 years",
"equivalences": [
{
"site": "MLB",
"size": "2 years"
},
{
"site": "MCO",
"size": "10 years"
},
{
"site": "MLM",
"size": "2 years"
},
{
"site": "MLC",
"size": "10 years"
}
]
},
{
"international_size": "5 years",
"equivalences": [
{
"site": "MCO",
"size": "5 years"
},
{
"site": "MLB",
"size": "13 years"
},
{
"site": "MLM",
"size": "13 years"
},
{
"site": "MLC",
"size": "5 years"
}
]
},
{
"international_size": "13 years",
"equivalences": [
{
"site": "MLC",
"size": "13 years"
},
{
"site": "MCO",
"size": "13 years"
},
{
"site": "MLB",
"size": "5 years"
},
{
"site": "MLM",
"size": "5 years"
}
]
},
{
"international_size": "1 years",
"equivalences": [
{
"site": "MCO",
"size": "1 years"
},
{
"site": "MLB",
"size": "9 years"
},
{
"site": "MLC",
"size": "1 years"
},
{
"site": "MLM",
"size": "9 years"
}
]
},
{
"international_size": "8 years",
"equivalences": [
{
"site": "MLM",
"size": "16 years"
},
{
"site": "MLC",
"size": "8 years"
},
{
"site": "MLB",
"size": "16 years"
},
{
"site": "MCO",
"size": "8 years"
}
]
},
{
"international_size": "4 years",
"equivalences": [
{
"site": "MLC",
"size": "4 years"
},
{
"site": "MCO",
"size": "4 years"
},
{
"site": "MLB",
"size": "12 years"
},
{
"site": "MLM",
"size": "12 years"
}
]
},
{
"international_size": "3 years",
"equivalences": [
{
"site": "MLC",
"size": "3 years"
},
{
"site": "MLM",
"size": "11 years"
},
{
"site": "MCO",
"size": "3 years"
},
{
"site": "MLB",
"size": "11 years"
}
]
},
{
"international_size": "7 years",
"equivalences": [
{
"site": "MCO",
"size": "7 years"
},
{
"site": "MLM",
"size": "15 years"
},
{
"site": "MLC",
"size": "7 years"
},
{
"site": "MLB",
"size": "15 years"
}
]
}
]