Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Última actualización 22/08/2024
Manage Size Chart
The size chart allows buyers to have a better experience when choosing their product, thus avoiding size changes and/or claims; so consider using this functionality on your fashion listings.
There are two possible types of size chart: brand or specific type (created by the seller).
Experience goals
- Ensure that fashion publications are always created with a size chart.
- Ensure that products are published with the right size chart.
- Seek to make this task as easy as possible so that we do not have dropouts by users when choosing or creating a size chart.
Create size charts in footwear
Remember the technical sheet received when you upload the attribute required for the template, since this technical sheet will have the attributes that you must send in the size chart creation POST. If you send an attribute that is not on the technical sheet, it will return an error.
Some considerations about attributes:
- names: The name that identifies the Size Chart must be unique.
The name should be replicated for the site_ids where the Size Guide will be created, there is no need to translate it. The name should be easy to reference, for example: "Girls' Shoe Size Guide", "Men's Oxford Size Guide".
{
"names": {
"CBT": "SIZE CHART FOR CBT-MAN US-M ",
"MLM": "SIZE CHART FOR CBT-MAN US-M ",
"MLB": "SIZE CHART FOR CBT-MAN US-M ",
"MCO": "SIZE CHART FOR CBT-MAN US-M ",
"MLC": "SIZE CHART FOR CBT-MAN US-M "
},- domain_id: define this with available domains for size chart documentation.
- site_id: always is CBT.
- type: can be SPECIFIC or BRAND.
- main_attributes: it is filled according to the rule that the size chart has and will represent the main size that will be displayed in the publication (column that will be the main size).
You can recognize the available main attributes with tag main_attribute_candidate when you're consulting a size charts data sheet.
These are the rules for main attribute:
You have to send one for any name of the size chart (an array structure with site_id and id of the main_atttributes). The main_attribute must be the same for all site_ids where the Size Guide will be used.
- secondary_attributes: it's optional and represents other standard, local or manufacturer sizes. Although the secondary attribute is optional, if used, it must adhere to the following structure.
- Attributes: please send all attributes recognized consulting domain data sheet with the required tag, for example GENDER, COLOR, FOOT_LENGTH. In addition, you can send all optional attributes identified with grid_filter tag, for example BRAND.
- Gender: is one of mandatory attributes and remember that chart gender must match to item gender. The available ID are:
- Woman ID 339665
- Man ID 339666
- Girls ID 339668
- Boys ID 339667
- Gender neutral ID 110461
- Gender neutral KID ID 1915949
- FOOT_LENGTH and FOOT_LENGTH_TO: are range attributes used to create measurement ranges within the specification of a size chart row.
- Rows: contains sizes related to the size chart.
- Size: determine the picker information (descriptive detail of the size). First column can be set by the seller to change what we want to show as the size description. SIZE value must match with the SIZE CHART ROW in the main_attribute. The first column of the size chart will always be identified under the id of the SIZE attribute. Validate your json before create size chart
Example of creating size chart in footwear
Request:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" https://api.mercadolibre.com/catalog/charts
Example:
curl --location 'https://api.mercadolibre.com/catalog/charts' \
--header 'Authorization: Bearer $ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"names": {
"CBT": "SIZE CHART FOR MAN CBT US-M",
"MLM": "SIZE CHART FOR MAN CBT US-M",
"MLB": "SIZE CHART FOR MAN CBT US-M",
"MCO": "SIZE CHART FOR MAN CBT US-M",
"MLC": "SIZE CHART FOR MAN CBT US-M"
},
"domain_id": "SNEAKERS",
"site_id": "CBT",
"type": "SPECIFIC",
"main_attribute": {
"attributes": [
{
"site_id": "CBT",
"id": "M_US_SIZE"
},
{
"site_id": "MLB",
"id": "M_US_SIZE"
},
{
"site_id": "MLM",
"id": "M_US_SIZE"
},
{
"site_id": "MCO",
"id": "M_US_SIZE"
},
{
"site_id": "MLC",
"id": "M_US_SIZE"
}
]
},
"secondary_attribute": {
"attributes": [
{
"site_id": "MLM",
"id": "MX_SIZE"
},
{
"site_id": "MLB",
"id": "BR_SIZE"
},
{
"site_id": "MCO",
"id": "CO_SIZE"
},
{
"site_id": "MLC",
"id": "CL_SIZE"
},
{
"site_id": "EU",
"id": "EU_SIZE"
},
{
"site_id": "UK",
"id": "UK_SIZE"
}
]
},
"attributes": [
{
"id": "GENDER",
"values": [
{
"id": "339666",
"name": "Man"
}
]
}
],
"rows": [
{
"sites": [
"CBT",
"MLC",
"MLB",
"MLM",
"MCO"
],
"attributes": [
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "22 cm",
"struct": {
"number": 22.0,
"unit": "cm"
}
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "24 cm",
"struct": {
"number": 24.0,
"unit": "cm"
}
}
]
},
{
"id": "M_US_SIZE",
"values": [
{
"name": "5 US",
"struct": {
"number": 5,
"unit": "US"
}
}
]
},
{
"id": "MX_SIZE",
"values": [
{
"name": "20 MX",
"struct": {
"number": 20.0,
"unit": "MX"
}
}
]
},
{
"id": "BR_SIZE",
"values": [
{
"name": "35 BR",
"struct": {
"number": 35,
"unit": "BR"
}
}
]
},
{
"id": "CO_SIZE",
"values": [
{
"name": "34 CO",
"struct": {
"number": 34,
"unit": "CO"
}
}
]
},
{
"id": "CL_SIZE",
"values": [
{
"name": "34 CL",
"struct": {
"number": 34,
"unit": "CL"
}
}
]
},
{
"id": "EU_SIZE",
"values": [
{
"name": "36 EU",
"struct": {
"number": 36,
"unit": "EU"
}
}
]
},
{
"id": "UK_SIZE",
"values": [
{
"name": "4 UK",
"struct": {
"number": 4,
"unit": "UK"
}
}
]
}
]
},
{
"sites": [
"CBT",
"MLC",
"MLB",
"MLM",
"MCO"
],
"attributes": [
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "24 cm",
"struct": {
"number": 24.0,
"unit": "cm"
}
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "26 cm",
"struct": {
"number": 26.0,
"unit": "cm"
}
}
]
},
{
"id": "M_US_SIZE",
"values": [
{
"name": "6 US",
"struct": {
"number": 6,
"unit": "US"
}
}
]
},
{
"id": "MX_SIZE",
"values": [
{
"name": "20 MX",
"struct": {
"number": 20,
"unit": "MX"
}
}
]
},
{
"id": "BR_SIZE",
"values": [
{
"name": "36 BR",
"struct": {
"number": 36,
"unit": "BR"
}
}
]
},
{
"id": "CO_SIZE",
"values": [
{
"name": "34 CO",
"struct": {
"number": 34,
"unit": "CO"
}
}
]
},
{
"id": "CL_SIZE",
"values": [
{
"name": "34 CL",
"struct": {
"number": 34,
"unit": "CL"
}
}
]
},
{
"id": "EU_SIZE",
"values": [
{
"name": "37 EU",
"struct": {
"number": 37,
"unit": "EU"
}
}
]
},
{
"id": "UK_SIZE",
"values": [
{
"name": "5 UK",
"struct": {
"number": 5,
"unit": "UK"
}
}
]
}
]
},
{
"sites": [
"CBT",
"MLC",
"MLB",
"MLM",
"MCO"
],
"attributes": [
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "27 cm",
"struct": {
"number": 27.0,
"unit": "cm"
}
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "29 cm",
"struct": {
"number": 29.0,
"unit": "cm"
}
}
]
},
{
"id": "M_US_SIZE",
"values": [
{
"name": "6.5 US",
"struct": {
"number": 6.5,
"unit": "US"
}
}
]
},
{
"id": "MX_SIZE",
"values": [
{
"name": "25 MX",
"struct": {
"number": 25,
"unit": "MX"
}
}
]
},
{
"id": "BR_SIZE",
"values": [
{
"name": "38 BR",
"struct": {
"number": 38,
"unit": "BR"
}
}
]
},
{
"id": "CO_SIZE",
"values": [
{
"name": "36 CO",
"struct": {
"number": 36,
"unit": "CO"
}
}
]
},
{
"id": "CL_SIZE",
"values": [
{
"name": "35 CL",
"struct": {
"number": 35,
"unit": "CL"
}
}
]
},
{
"id": "EU_SIZE",
"values": [
{
"name": "39 EU",
"struct": {
"number": 39,
"unit": "EU"
}
}
]
},
{
"id": "UK_SIZE",
"values": [
{
"name": "7 UK",
"struct": {
"number": 7,
"unit": "UK"
}
}
]
}
]
}
]
}'
Response:
{
"id": "1746997",
"names": {
"CBT": "SIZE CHART FOR MAN CBT US-M",
"MLM": "SIZE CHART FOR MAN CBT US-M",
"MLB": "SIZE CHART FOR MAN CBT US-M",
"MCO": "SIZE CHART FOR MAN CBT US-M",
"MLC": "SIZE CHART FOR MAN CBT US-M"
},
"domain_id": "SNEAKERS",
"site_id": "CBT",
"type": "SPECIFIC",
"seller_id": 1422296917,
"measure_type": "BODY_MEASURE",
"main_attribute": {
"attributes": [
{
"site_id": "CBT",
"id": "M_US_SIZE"
},
{
"site_id": "MLB",
"id": "M_US_SIZE"
},
{
"site_id": "MLM",
"id": "M_US_SIZE"
},
{
"site_id": "MCO",
"id": "M_US_SIZE"
},
{
"site_id": "MLC",
"id": "M_US_SIZE"
}
]
},
"secondary_attribute": {
"attributes": [
{
"site_id": "CBT",
"id": "EU_SIZE"
},
{
"site_id": "MLC",
"id": "CL_SIZE"
},
{
"site_id": "MLB",
"id": "BR_SIZE"
},
{
"site_id": "MLM",
"id": "MX_SIZE"
},
{
"site_id": "MCO",
"id": "CO_SIZE"
}
]
},
"attributes": [
{
"id": "GENDER",
"values": [
{
"id": "339666",
"name": "Man"
}
]
}
],
"rows": [
{
"id": "1746997:1",
"sites": [
"CBT",
"MLC",
"MLB",
"MLM",
"MCO"
],
"attributes": [
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "22 cm",
"struct": {
"number": 22.0,
"unit": "cm"
}
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "24 cm",
"struct": {
"number": 24.0,
"unit": "cm"
}
}
]
},
{
"id": "BR_SIZE",
"values": [
{
"name": "35 BR",
"struct": {
"number": 35.0,
"unit": "BR"
}
}
]
},
{
"id": "MX_SIZE",
"values": [
{
"name": "20 MX",
"struct": {
"number": 20.0,
"unit": "MX"
}
}
]
},
{
"id": "CL_SIZE",
"values": [
{
"name": "34 CL",
"struct": {
"number": 34.0,
"unit": "CL"
}
}
]
},
{
"id": "CO_SIZE",
"values": [
{
"name": "34 CO",
"struct": {
"number": 34.0,
"unit": "CO"
}
}
]
},
{
"id": "M_US_SIZE",
"values": [
{
"name": "5 US",
"struct": {
"number": 5.0,
"unit": "US"
}
}
]
},
{
"id": "EU_SIZE",
"values": [
{
"name": "36 EU",
"struct": {
"number": 36.0,
"unit": "EU"
}
}
]
},
{
"id": "UK_SIZE",
"values": [
{
"name": "4 UK",
"struct": {
"number": 4.0,
"unit": "UK"
}
}
]
}
]
},
{
"id": "1746997:2",
"sites": [
"CBT",
"MLC",
"MLB",
"MLM",
"MCO"
],
"attributes": [
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "24 cm",
"struct": {
"number": 24.0,
"unit": "cm"
}
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "26 cm",
"struct": {
"number": 26.0,
"unit": "cm"
}
}
]
},
{
"id": "BR_SIZE",
"values": [
{
"name": "36 BR",
"struct": {
"number": 36.0,
"unit": "BR"
}
}
]
},
{
"id": "MX_SIZE",
"values": [
{
"name": "20 MX",
"struct": {
"number": 20.0,
"unit": "MX"
}
}
]
},
{
"id": "CL_SIZE",
"values": [
{
"name": "34 CL",
"struct": {
"number": 34.0,
"unit": "CL"
}
}
]
},
{
"id": "CO_SIZE",
"values": [
{
"name": "34 CO",
"struct": {
"number": 34.0,
"unit": "CO"
}
}
]
},
{
"id": "M_US_SIZE",
"values": [
{
"name": "6 US",
"struct": {
"number": 6.0,
"unit": "US"
}
}
]
},
{
"id": "EU_SIZE",
"values": [
{
"name": "37 EU",
"struct": {
"number": 37.0,
"unit": "EU"
}
}
]
},
{
"id": "UK_SIZE",
"values": [
{
"name": "5 UK",
"struct": {
"number": 5.0,
"unit": "UK"
}
}
]
}
]
},
{
"id": "1746997:3",
"sites": [
"CBT",
"MLC",
"MLB",
"MLM",
"MCO"
],
"attributes": [
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "27 cm",
"struct": {
"number": 27.0,
"unit": "cm"
}
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "29 cm",
"struct": {
"number": 29.0,
"unit": "cm"
}
}
]
},
{
"id": "BR_SIZE",
"values": [
{
"name": "38 BR",
"struct": {
"number": 38.0,
"unit": "BR"
}
}
]
},
{
"id": "MX_SIZE",
"values": [
{
"name": "25 MX",
"struct": {
"number": 25.0,
"unit": "MX"
}
}
]
},
{
"id": "CL_SIZE",
"values": [
{
"name": "35 CL",
"struct": {
"number": 35.0,
"unit": "CL"
}
}
]
},
{
"id": "CO_SIZE",
"values": [
{
"name": "36 CO",
"struct": {
"number": 36.0,
"unit": "CO"
}
}
]
},
{
"id": "M_US_SIZE",
"values": [
{
"name": "6.5 US",
"struct": {
"number": 6.5,
"unit": "US"
}
}
]
},
{
"id": "EU_SIZE",
"values": [
{
"name": "39 EU",
"struct": {
"number": 39.0,
"unit": "EU"
}
}
]
},
{
"id": "UK_SIZE",
"values": [
{
"name": "7 UK",
"struct": {
"number": 7.0,
"unit": "UK"
}
}
]
}
]
}
]
}
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 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 tops: you can see that the size XLarge includes the values of the size list from 3XL TO 6XL (3XL,4XL, 5XL.6XL) while the size Small corresponds to a value of size XS and S. Also for bottoms use american size, example: 0 US, 16 US, 24 US
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 with body measures 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 of creating a size charts with body measures from a List:
{
"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"
}
}
]
}
]
}
]
}Create charts with clothes sizes
Only for TOPS and BOTTOMS domains, after consulting the size chart data sheet and recognizing which attributes have the CLOTHING_MEASURE tag, you will be able to create size charts only by specifying clothes sizes.
To consider:
- The "measure_type" field must be specified and its possible values: BODY_MEASURE, CLOTHING_MEASURE or MIXED_MEASURE. This field refers to the type of measure that the seller will specify in the size chart. Once the size chart has been created, this field cannot be modified.
- It is possible to have both garment and body measurements in the same size guide with the "measure_type" MIXED_MEASURE.
- If the "measure_type" field is not sent by default, the size chart will be of body measurements or BODY_MEASURE and all Validations will be based on this type of measurement.
Example of the creation of a customized size chart, with clothes sizes:
curl --location --request POST 'https://api.mercadolibre.com/catalog/charts' \
--header 'Authorization: Bearer {{TOKEN}}' \
--header 'Content-Type: application/json' \
--header 'x-caller-id: 1422296917' \
--data-raw '{
"names": {
"MLB": "Pants test Garment ",
"MCO": "Pants test Garment ",
"CBT": "Pants test Garment ",
"MLM": "Pants test Garment ",
"MLC": "Pants test Garment "
},
"domain_id": "PANTS_TEST",
"site_id": "CBT",
"type": "SPECIFIC",
"seller_id": 1422296917,
"measure_type": "CLOTHING_MEASURE",
"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": "242728:1",
"sites": [
"MLM",
"MLB",
"MLC",
"MCO",
"CBT"
],
"attributes": [
{
"id": "SIZE",
"values": [
{
"name": "Small"
}
]
},
{
"id": "PANTS_TEST_FILTRABLE_SIZES",
"values": [
{
"id": "4147746",
"name": "26"
}
]
},
{
"id": "GARMENT_LENGTH_FROM",
"values": [
{
"name": "15 cm",
"struct": {
"number": 15.0,
"unit": "cm"
}
}
]
},
{
"id": "GARMENT_WAIST_WIDTH_FROM",
"values": [
{
"name": "16 cm",
"struct": {
"number": 16.0,
"unit": "cm"
}
}
]
},
{
"id": "GARMENT_HIP_WIDTH_FROM",
"values": [
{
"name": "17 cm",
"struct": {
"number": 17.0,
"unit": "cm"
}
}
]
},
{
"id": "GARMENT_THIGH_WIDTH_FROM",
"values": [
{
"name": "18 cm",
"struct": {
"number": 18.0,
"unit": "cm"
}
}
]
},
{
"id": "GARMENT_INSEAM_LENGTH_FROM",
"values": [
{
"name": "19 cm",
"struct": {
"number": 19.0,
"unit": "cm"
}
}
]
},
{
"id": "GARMENT_FRONT_RISE_FROM",
"values": [
{
"name": "20 cm",
"struct": {
"number": 20.0,
"unit": "cm"
}
}
]
}
]
}
]
}'Example of the creation of a customized size chart, with MIXED_MEASURE:
curl --location --request POST 'https://api.mercadolibre.com/catalog/charts' \
--header 'Authorization: Bearer {{TOKEN}}' \
--header 'Content-Type: application/json' \
--header 'x-caller-id: 1422296917' \
--data-raw '{
"names": {
"MLB": "T_SHIRTS MIXED_MEASURE",
"MCO": "T_SHIRTS MIXED_MEASURE",
"CBT": "T_SHIRTS MIXED_MEASURE",
"MLM": "T_SHIRTS MIXED_MEASURE",
"MLC": "T_SHIRTS MIXED_MEASURE"
},
"domain_id": "T_SHIRTS",
"site_id": "CBT",
"type": "SPECIFIC",
"seller_id": 1422296917,
"measure_type": "MIXED_MEASURE",
"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": "339666",
"name": "Man"
}
]
}
],
"rows": [
{
"id": "1315111:1",
"sites": [
"MLM",
"MLB",
"MLC",
"MCO",
"CBT"
],
"attributes": [
{
"id": "SIZE",
"values": [
{
"name": "2XS"
}
]
},
{
"id": "FILTRABLE_SIZE",
"values": [
{
"id": "12917836",
"name": "2XS"
}
]
},
{
"id": "CHEST_CIRCUMFERENCE_FROM",
"values": [
{
"name": "60 cm",
"struct": {
"number": 60.0,
"unit": "cm"
}
}
]
},
{
"id": "WAIST_CIRCUMFERENCE_FROM",
"values": [
{
"name": "60 cm",
"struct": {
"number": 60.0,
"unit": "cm"
}
}
]
},
{
"id": "PERSON_HEIGHT_FROM",
"values": [
{
"name": "60 cm",
"struct": {
"number": 60.0,
"unit": "cm"
}
}
]
},
{
"id": "HIP_CIRCUMFERENCE_FROM",
"values": [
{
"name": "60 cm",
"struct": {
"number": 60.0,
"unit": "cm"
}
}
]
},
{
"id": "NECK_CIRCUMFERENCE_FROM",
"values": [
{
"name": "60 cm",
"struct": {
"number": 60.0,
"unit": "cm"
}
}
]
},
{
"id": "GARMENT_CHEST_WIDTH_FROM",
"values": [
{
"name": "11 cm",
"struct": {
"number": 11.0,
"unit": "cm"
}
}
]
},
{
"id": "GARMENT_LENGTH_FROM",
"values": [
{
"name": "11 cm",
"struct": {
"number": 11.0,
"unit": "cm"
}
}
]
},
{
"id": "GARMENT_SHOULDER_WIDTH_FROM",
"values": [
{
"name": "11 cm",
"struct": {
"number": 11.0,
"unit": "cm"
}
}
]
},
{
"id": "GARMENT_SLEEVE_LENGTH_FROM",
"values": [
{
"name": "11 cm",
"struct": {
"number": 11.0,
"unit": "cm"
}
}
]
}
]
}
]
}'Consult size chart
Request:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog/charts/$CHART_IDExample:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog/charts/1332046Response:Success 200 OK
{
"id": "1332046",
"names": {
"MLC": "SIZE CHART FOR MAN CBT US-M",
"MLM": "SIZE CHART FOR MAN CBT US-M",
"MLB": "SIZE CHART FOR MAN CBT US-M",
"CBT": "SIZE CHART FOR MAN CBT US-M",
"MCO": "SIZE CHART FOR MAN CBT US-M"
},
"domain_id": "SNEAKERS",
"site_id": "CBT",
"type": "SPECIFIC",
"seller_id": 1422296917,
"measure_type": "BODY_MEASURE",
"main_attribute": {
"attributes": [
{
"site_id": "CBT",
"id": "M_US_SIZE"
},
{
"site_id": "MLM",
"id": "M_US_SIZE"
},
{
"site_id": "MLB",
"id": "M_US_SIZE"
},
{
"site_id": "MLC",
"id": "M_US_SIZE"
},
{
"site_id": "MCO",
"id": "M_US_SIZE"
}
]
},
"secondary_attribute": {
"attributes": [
{
"site_id": "MCO",
"id": "CO_SIZE"
},
{
"site_id": "MLB",
"id": "BR_SIZE"
},
{
"site_id": "MLC",
"id": "CL_SIZE"
},
{
"site_id": "MLM",
"id": "MX_SIZE"
}
]
},
"attributes": [
{
"id": "GENDER",
"values": [
{
"id": "339666",
"name": "Man"
}
]
}
],
"rows": [
{
"id": "1332046:1",
"sites": [
"MCO",
"MLB",
"CBT",
"MLC",
"MLM"
],
"attributes": [
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "11 cm",
"struct": {
"number": 11.0,
"unit": "cm"
}
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "12 cm",
"struct": {
"number": 12.0,
"unit": "cm"
}
}
]
},
{
"id": "BR_SIZE",
"values": [
{
"name": "36 BR",
"struct": {
"number": 36.0,
"unit": "BR"
}
}
]
},
{
"id": "MX_SIZE",
"values": [
{
"name": "23 MX",
"struct": {
"number": 23.0,
"unit": "MX"
}
}
]
},
{
"id": "CL_SIZE",
"values": [
{
"name": "36 CL",
"struct": {
"number": 36.0,
"unit": "CL"
}
}
]
},
{
"id": "CO_SIZE",
"values": [
{
"name": "36 CO",
"struct": {
"number": 36.0,
"unit": "CO"
}
}
]
},
{
"id": "M_US_SIZE",
"values": [
{
"name": "5 US",
"struct": {
"number": 5.0,
"unit": "US"
}
}
]
}
]
},
{
"id": "1332046:2",
"sites": [
"MCO",
"MLB",
"CBT",
"MLC",
"MLM"
],
"attributes": [
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "12 cm",
"struct": {
"number": 12.0,
"unit": "cm"
}
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "13 cm",
"struct": {
"number": 13.0,
"unit": "cm"
}
}
]
},
{
"id": "BR_SIZE",
"values": [
{
"name": "37 BR",
"struct": {
"number": 37.0,
"unit": "BR"
}
}
]
},
{
"id": "MX_SIZE",
"values": [
{
"name": "24 MX",
"struct": {
"number": 24.0,
"unit": "MX"
}
}
]
},
{
"id": "CL_SIZE",
"values": [
{
"name": "37 CL",
"struct": {
"number": 37.0,
"unit": "CL"
}
}
]
},
{
"id": "CO_SIZE",
"values": [
{
"name": "37 CO",
"struct": {
"number": 37.0,
"unit": "CO"
}
}
]
},
{
"id": "M_US_SIZE",
"values": [
{
"name": "6 US",
"struct": {
"number": 6.0,
"unit": "US"
}
}
]
}
]
},
{
"id": "1332046:3",
"sites": [
"MCO",
"MLB",
"CBT",
"MLC",
"MLM"
],
"attributes": [
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "13 cm",
"struct": {
"number": 13.0,
"unit": "cm"
}
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "14 cm",
"struct": {
"number": 14.0,
"unit": "cm"
}
}
]
},
{
"id": "BR_SIZE",
"values": [
{
"name": "38 BR",
"struct": {
"number": 38.0,
"unit": "BR"
}
}
]
},
{
"id": "MX_SIZE",
"values": [
{
"name": "25 MX",
"struct": {
"number": 25.0,
"unit": "MX"
}
}
]
},
{
"id": "CL_SIZE",
"values": [
{
"name": "38 CL",
"struct": {
"number": 38.0,
"unit": "CL"
}
}
]
},
{
"id": "CO_SIZE",
"values": [
{
"name": "38 CO",
"struct": {
"number": 38.0,
"unit": "CO"
}
}
]
},
{
"id": "M_US_SIZE",
"values": [
{
"name": "7 US",
"struct": {
"number": 7.0,
"unit": "US"
}
}
]
}
]
},
{
"id": "1332046:4",
"sites": [
"MCO",
"MLB",
"CBT",
"MLC",
"MLM"
],
"attributes": [
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "14 cm",
"struct": {
"number": 14.0,
"unit": "cm"
}
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "15 cm",
"struct": {
"number": 15.0,
"unit": "cm"
}
}
]
},
{
"id": "BR_SIZE",
"values": [
{
"name": "39.5 BR",
"struct": {
"number": 39.5,
"unit": "BR"
}
}
]
},
{
"id": "MX_SIZE",
"values": [
{
"name": "26 MX",
"struct": {
"number": 26.0,
"unit": "MX"
}
}
]
},
{
"id": "CL_SIZE",
"values": [
{
"name": "39 CL",
"struct": {
"number": 39.0,
"unit": "CL"
}
}
]
},
{
"id": "CO_SIZE",
"values": [
{
"name": "39 CO",
"struct": {
"number": 39.0,
"unit": "CO"
}
}
]
},
{
"id": "M_US_SIZE",
"values": [
{
"name": "8 US",
"struct": {
"number": 8.0,
"unit": "US"
}
}
]
}
]
},
{
"id": "1332046:5",
"sites": [
"MCO",
"MLB",
"CBT",
"MLC",
"MLM"
],
"attributes": [
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "15 cm",
"struct": {
"number": 15.0,
"unit": "cm"
}
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "16 cm",
"struct": {
"number": 16.0,
"unit": "cm"
}
}
]
},
{
"id": "BR_SIZE",
"values": [
{
"name": "40.5 BR",
"struct": {
"number": 40.5,
"unit": "BR"
}
}
]
},
{
"id": "MX_SIZE",
"values": [
{
"name": "27 MX",
"struct": {
"number": 27.0,
"unit": "MX"
}
}
]
},
{
"id": "CL_SIZE",
"values": [
{
"name": "40 CL",
"struct": {
"number": 40.0,
"unit": "CL"
}
}
]
},
{
"id": "CO_SIZE",
"values": [
{
"name": "40 CO",
"struct": {
"number": 40.0,
"unit": "CO"
}
}
]
},
{
"id": "M_US_SIZE",
"values": [
{
"name": "9 US",
"struct": {
"number": 9.0,
"unit": "US"
}
}
]
}
]
},
{
"id": "1332046:6",
"sites": [
"MCO",
"MLB",
"CBT",
"MLC",
"MLM"
],
"attributes": [
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "16 cm",
"struct": {
"number": 16.0,
"unit": "cm"
}
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "17 cm",
"struct": {
"number": 17.0,
"unit": "cm"
}
}
]
},
{
"id": "BR_SIZE",
"values": [
{
"name": "42 BR",
"struct": {
"number": 42.0,
"unit": "BR"
}
}
]
},
{
"id": "MX_SIZE",
"values": [
{
"name": "28 MX",
"struct": {
"number": 28.0,
"unit": "MX"
}
}
]
},
{
"id": "CL_SIZE",
"values": [
{
"name": "41 CL",
"struct": {
"number": 41.0,
"unit": "CL"
}
}
]
},
{
"id": "CO_SIZE",
"values": [
{
"name": "42 CO",
"struct": {
"number": 42.0,
"unit": "CO"
}
}
]
},
{
"id": "M_US_SIZE",
"values": [
{
"name": "10 US",
"struct": {
"number": 10.0,
"unit": "US"
}
}
]
}
]
}
]
}
Add row in the size chart
This endpoint allows you to add rows to an existing chart.
Request:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" https://api.mercadolibre.com/catalog/charts/$CHART_ID/rowsExample:
curl 'https://api.mercadolibre.com/catalog/charts/1746997/rows' -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' -d '{
"sites": [
"CBT",
"MLC",
"MLB",
"MLM",
"MCO"
],
"attributes": [
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "27 cm",
"struct": {
"number": 27.0,
"unit": "cm"
}
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "29 cm",
"struct": {
"number": 29.0,
"unit": "cm"
}
}
]
},
{
"id": "BR_SIZE",
"values": [
{
"name": "38 BR",
"struct": {
"number": 38.0,
"unit": "BR"
}
}
]
},
{
"id": "MX_SIZE",
"values": [
{
"name": "25 MX",
"struct": {
"number": 25.0,
"unit": "MX"
}
}
]
},
{
"id": "CL_SIZE",
"values": [
{
"name": "35 CL",
"struct": {
"number": 35.0,
"unit": "CL"
}
}
]
},
{
"id": "CO_SIZE",
"values": [
{
"name": "36 CO",
"struct": {
"number": 36.0,
"unit": "CO"
}
}
]
},
{
"id": "M_US_SIZE",
"values": [
{
"name": "7.5 US",
"struct": {
"number": 7.5,
"unit": "US"
}
}
]
},
{
"id": "EU_SIZE",
"values": [
{
"name": "39 EU",
"struct": {
"number": 39.0,
"unit": "EU"
}
}
]
},
{
"id": "UK_SIZE",
"values": [
{
"name": "7 UK",
"struct": {
"number": 7.0,
"unit": "UK"
}
}
]
}
]
}'
Response: Success 201 Created
{
"id": "1746997",
"names": {
"CBT": "SIZE CHART FOR MAN CBT US-M",
"MLM": "SIZE CHART FOR MAN CBT US-M",
"MLB": "SIZE CHART FOR MAN CBT US-M",
"MCO": "SIZE CHART FOR MAN CBT US-M",
"MLC": "SIZE CHART FOR MAN CBT US-M"
},
"domain_id": "SNEAKERS",
"site_id": "CBT",
"type": "SPECIFIC",
"seller_id": 1422296917,
"measure_type": "BODY_MEASURE",
"main_attribute": {
"attributes": [
{
"site_id": "CBT",
"id": "M_US_SIZE"
},
{
"site_id": "MLB",
"id": "M_US_SIZE"
},
{
"site_id": "MLM",
"id": "M_US_SIZE"
},
{
"site_id": "MCO",
"id": "M_US_SIZE"
},
{
"site_id": "MLC",
"id": "M_US_SIZE"
}
]
},
"secondary_attribute": {
"attributes": [
{
"site_id": "CBT",
"id": "EU_SIZE"
},
{
"site_id": "MLC",
"id": "CL_SIZE"
},
{
"site_id": "MLB",
"id": "BR_SIZE"
},
{
"site_id": "MLM",
"id": "MX_SIZE"
},
{
"site_id": "MCO",
"id": "CO_SIZE"
}
]
},
"attributes": [
{
"id": "GENDER",
"values": [
{
"id": "339666",
"name": "Man"
}
]
}
],
"rows": [
{
"id": "1746997:1",
"sites": [
"CBT",
"MLC",
"MLB",
"MLM",
"MCO"
],
"attributes": [
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "22 cm",
"struct": {
"number": 22.0,
"unit": "cm"
}
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "24 cm",
"struct": {
"number": 24.0,
"unit": "cm"
}
}
]
},
{
"id": "BR_SIZE",
"values": [
{
"name": "35 BR",
"struct": {
"number": 35.0,
"unit": "BR"
}
}
]
},
{
"id": "MX_SIZE",
"values": [
{
"name": "20 MX",
"struct": {
"number": 20.0,
"unit": "MX"
}
}
]
},
{
"id": "CL_SIZE",
"values": [
{
"name": "34 CL",
"struct": {
"number": 34.0,
"unit": "CL"
}
}
]
},
{
"id": "CO_SIZE",
"values": [
{
"name": "34 CO",
"struct": {
"number": 34.0,
"unit": "CO"
}
}
]
},
{
"id": "M_US_SIZE",
"values": [
{
"name": "5 US",
"struct": {
"number": 5.0,
"unit": "US"
}
}
]
},
{
"id": "EU_SIZE",
"values": [
{
"name": "36 EU",
"struct": {
"number": 36.0,
"unit": "EU"
}
}
]
},
{
"id": "UK_SIZE",
"values": [
{
"name": "4 UK",
"struct": {
"number": 4.0,
"unit": "UK"
}
}
]
}
]
},
{
"id": "1746997:2",
"sites": [
"CBT",
"MLC",
"MLB",
"MLM",
"MCO"
],
"attributes": [
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "24 cm",
"struct": {
"number": 24.0,
"unit": "cm"
}
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "26 cm",
"struct": {
"number": 26.0,
"unit": "cm"
}
}
]
},
{
"id": "BR_SIZE",
"values": [
{
"name": "36 BR",
"struct": {
"number": 36.0,
"unit": "BR"
}
}
]
},
{
"id": "MX_SIZE",
"values": [
{
"name": "20 MX",
"struct": {
"number": 20.0,
"unit": "MX"
}
}
]
},
{
"id": "CL_SIZE",
"values": [
{
"name": "34 CL",
"struct": {
"number": 34.0,
"unit": "CL"
}
}
]
},
{
"id": "CO_SIZE",
"values": [
{
"name": "34 CO",
"struct": {
"number": 34.0,
"unit": "CO"
}
}
]
},
{
"id": "M_US_SIZE",
"values": [
{
"name": "6 US",
"struct": {
"number": 6.0,
"unit": "US"
}
}
]
},
{
"id": "EU_SIZE",
"values": [
{
"name": "37 EU",
"struct": {
"number": 37.0,
"unit": "EU"
}
}
]
},
{
"id": "UK_SIZE",
"values": [
{
"name": "5 UK",
"struct": {
"number": 5.0,
"unit": "UK"
}
}
]
}
]
},
{
"id": "1746997:3",
"sites": [
"CBT",
"MLC",
"MLB",
"MLM",
"MCO"
],
"attributes": [
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "27 cm",
"struct": {
"number": 27.0,
"unit": "cm"
}
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "29 cm",
"struct": {
"number": 29.0,
"unit": "cm"
}
}
]
},
{
"id": "BR_SIZE",
"values": [
{
"name": "38 BR",
"struct": {
"number": 38.0,
"unit": "BR"
}
}
]
},
{
"id": "MX_SIZE",
"values": [
{
"name": "25 MX",
"struct": {
"number": 25.0,
"unit": "MX"
}
}
]
},
{
"id": "CL_SIZE",
"values": [
{
"name": "35 CL",
"struct": {
"number": 35.0,
"unit": "CL"
}
}
]
},
{
"id": "CO_SIZE",
"values": [
{
"name": "36 CO",
"struct": {
"number": 36.0,
"unit": "CO"
}
}
]
},
{
"id": "M_US_SIZE",
"values": [
{
"name": "6.5 US",
"struct": {
"number": 6.5,
"unit": "US"
}
}
]
},
{
"id": "EU_SIZE",
"values": [
{
"name": "39 EU",
"struct": {
"number": 39.0,
"unit": "EU"
}
}
]
},
{
"id": "UK_SIZE",
"values": [
{
"name": "7 UK",
"struct": {
"number": 7.0,
"unit": "UK"
}
}
]
}
]
},
{
"id": "1746997:4",
"sites": [
"CBT",
"MLC",
"MLB",
"MLM",
"MCO"
],
"attributes": [
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "27 cm",
"struct": {
"number": 27.0,
"unit": "cm"
}
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "29 cm",
"struct": {
"number": 29.0,
"unit": "cm"
}
}
]
},
{
"id": "BR_SIZE",
"values": [
{
"name": "38 BR",
"struct": {
"number": 38.0,
"unit": "BR"
}
}
]
},
{
"id": "MX_SIZE",
"values": [
{
"name": "25 MX",
"struct": {
"number": 25.0,
"unit": "MX"
}
}
]
},
{
"id": "CL_SIZE",
"values": [
{
"name": "35 CL",
"struct": {
"number": 35.0,
"unit": "CL"
}
}
]
},
{
"id": "CO_SIZE",
"values": [
{
"name": "36 CO",
"struct": {
"number": 36.0,
"unit": "CO"
}
}
]
},
{
"id": "M_US_SIZE",
"values": [
{
"name": "7.5 US",
"struct": {
"number": 7.5,
"unit": "US"
}
}
]
},
{
"id": "EU_SIZE",
"values": [
{
"name": "39 EU",
"struct": {
"number": 39.0,
"unit": "EU"
}
}
]
},
{
"id": "UK_SIZE",
"values": [
{
"name": "7 UK",
"struct": {
"number": 7.0,
"unit": "UK"
}
}
]
}
]
}
]
}
Size chart
Update Rows - Size chart
This endpoint allows you to add information to an existing row in the size chart. It's impossible to modify the information of the rows. You can not edit the main item (main_attribute) of each queue (row) and neither can you delete queues.
It is possible to add information to a line that was not filled in.
Request:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" https://api.mercadolibre.com/catalog/charts/$CHART_IDExample:
curl -X PUT 'https://api.mercadolibre.com/catalog/charts/1746997 -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' -d '{
"rows": [
{
"id": "1746997:4",
"sites": [
"CBT",
"MLM",
"MLB",
"MLC",
"MCO"
],
"attributes": [
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "30 cm",
"struct": {
"number": 30,
"unit": "cm"
}
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "32 cm",
"struct": {
"number": 32,
"unit": "cm"
}
}
]
},
{
"id": "BR_SIZE",
"name": "BR",
"values": [
{
"name": "42 BR",
"struct": {
"number": 42,
"unit": "BR"
}
}
]
},
{
"id": "MANUFACTURER_SIZE",
"name": "Manufacturer size",
"label": "Manufacturer size",
"values": [
{
"name": "MM"
}
]
},
{
"id": "MX_SIZE",
"name": "MX",
"values": [
{
"name": "30 MX",
"struct": {
"number": 34,
"unit": "MX"
}
}
]
},
{
"id": "EU_SIZE",
"name": "EU",
"values": [
{
"name": "44 EU",
"struct": {
"number": 44,
"unit": "EU"
}
}
]
},
{
"id": "UK_SIZE",
"name": "UK",
"values": [
{
"name": "7 UK",
"struct": {
"number": 7 ,
"unit": "UK"
}
}
]
}
]
}
]
}'Response: Success 200 OK
{
"id": "1746997",
"names": {
"CBT": "SIZE CHART FOR MAN CBT US-M",
"MLM": "SIZE CHART FOR MAN CBT US-M",
"MLB": "SIZE CHART FOR MAN CBT US-M",
"MCO": "SIZE CHART FOR MAN CBT US-M",
"MLC": "SIZE CHART FOR MAN CBT US-M"
},
"domain_id": "SNEAKERS",
"site_id": "CBT",
"type": "SPECIFIC",
"seller_id": 1422296917,
"measure_type": "BODY_MEASURE",
"main_attribute": {
"attributes": [
{
"site_id": "CBT",
"id": "M_US_SIZE"
},
{
"site_id": "MLB",
"id": "M_US_SIZE"
},
{
"site_id": "MLM",
"id": "M_US_SIZE"
},
{
"site_id": "MCO",
"id": "M_US_SIZE"
},
{
"site_id": "MLC",
"id": "M_US_SIZE"
}
]
},
"secondary_attribute": {
"attributes": [
{
"site_id": "CBT",
"id": "EU_SIZE"
},
{
"site_id": "MLC",
"id": "CL_SIZE"
},
{
"site_id": "MLB",
"id": "BR_SIZE"
},
{
"site_id": "MLM",
"id": "MX_SIZE"
},
{
"site_id": "MCO",
"id": "CO_SIZE"
}
]
},
"attributes": [
{
"id": "GENDER",
"values": [
{
"id": "339666",
"name": "Man"
}
]
}
],
"rows": [
{
"id": "1746997:1",
"sites": [
"CBT",
"MLC",
"MLB",
"MLM",
"MCO"
],
"attributes": [
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "22 cm",
"struct": {
"number": 22.0,
"unit": "cm"
}
},
{
"name": "22 cm",
"struct": {
"number": 22.0,
"unit": "cm"
}
},
{
"name": "22 cm",
"struct": {
"number": 22.0,
"unit": "cm"
}
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "24 cm",
"struct": {
"number": 24.0,
"unit": "cm"
}
},
{
"name": "24 cm",
"struct": {
"number": 24.0,
"unit": "cm"
}
},
{
"name": "24 cm",
"struct": {
"number": 24.0,
"unit": "cm"
}
}
]
},
{
"id": "BR_SIZE",
"values": [
{
"name": "35 BR",
"struct": {
"number": 35.0,
"unit": "BR"
}
}
]
},
{
"id": "MX_SIZE",
"values": [
{
"name": "20 MX",
"struct": {
"number": 20.0,
"unit": "MX"
}
}
]
},
{
"id": "CL_SIZE",
"values": [
{
"name": "34 CL",
"struct": {
"number": 34.0,
"unit": "CL"
}
}
]
},
{
"id": "CO_SIZE",
"values": [
{
"name": "34 CO",
"struct": {
"number": 34.0,
"unit": "CO"
}
}
]
},
{
"id": "M_US_SIZE",
"values": [
{
"name": "5 US",
"struct": {
"number": 5.0,
"unit": "US"
}
}
]
},
{
"id": "EU_SIZE",
"values": [
{
"name": "36 EU",
"struct": {
"number": 36.0,
"unit": "EU"
}
}
]
},
{
"id": "UK_SIZE",
"values": [
{
"name": "4 UK",
"struct": {
"number": 4.0,
"unit": "UK"
}
}
]
}
]
},
{
"id": "1746997:2",
"sites": [
"CBT",
"MLC",
"MLB",
"MLM",
"MCO"
],
"attributes": [
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "24 cm",
"struct": {
"number": 24.0,
"unit": "cm"
}
},
{
"name": "24 cm",
"struct": {
"number": 24.0,
"unit": "cm"
}
},
{
"name": "24 cm",
"struct": {
"number": 24.0,
"unit": "cm"
}
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "26 cm",
"struct": {
"number": 26.0,
"unit": "cm"
}
},
{
"name": "26 cm",
"struct": {
"number": 26.0,
"unit": "cm"
}
},
{
"name": "26 cm",
"struct": {
"number": 26.0,
"unit": "cm"
}
}
]
},
{
"id": "BR_SIZE",
"values": [
{
"name": "36 BR",
"struct": {
"number": 36.0,
"unit": "BR"
}
}
]
},
{
"id": "MX_SIZE",
"values": [
{
"name": "20 MX",
"struct": {
"number": 20.0,
"unit": "MX"
}
}
]
},
{
"id": "CL_SIZE",
"values": [
{
"name": "34 CL",
"struct": {
"number": 34.0,
"unit": "CL"
}
}
]
},
{
"id": "CO_SIZE",
"values": [
{
"name": "34 CO",
"struct": {
"number": 34.0,
"unit": "CO"
}
}
]
},
{
"id": "M_US_SIZE",
"values": [
{
"name": "6 US",
"struct": {
"number": 6.0,
"unit": "US"
}
}
]
},
{
"id": "EU_SIZE",
"values": [
{
"name": "37 EU",
"struct": {
"number": 37.0,
"unit": "EU"
}
}
]
},
{
"id": "UK_SIZE",
"values": [
{
"name": "5 UK",
"struct": {
"number": 5.0,
"unit": "UK"
}
}
]
}
]
},
{
"id": "1746997:3",
"sites": [
"CBT",
"MLC",
"MLB",
"MLM",
"MCO"
],
"attributes": [
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "27 cm",
"struct": {
"number": 27.0,
"unit": "cm"
}
},
{
"name": "27 cm",
"struct": {
"number": 27.0,
"unit": "cm"
}
},
{
"name": "27 cm",
"struct": {
"number": 27.0,
"unit": "cm"
}
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "29 cm",
"struct": {
"number": 29.0,
"unit": "cm"
}
},
{
"name": "29 cm",
"struct": {
"number": 29.0,
"unit": "cm"
}
},
{
"name": "29 cm",
"struct": {
"number": 29.0,
"unit": "cm"
}
}
]
},
{
"id": "BR_SIZE",
"values": [
{
"name": "38 BR",
"struct": {
"number": 38.0,
"unit": "BR"
}
}
]
},
{
"id": "MX_SIZE",
"values": [
{
"name": "25 MX",
"struct": {
"number": 25.0,
"unit": "MX"
}
}
]
},
{
"id": "CL_SIZE",
"values": [
{
"name": "35 CL",
"struct": {
"number": 35.0,
"unit": "CL"
}
}
]
},
{
"id": "CO_SIZE",
"values": [
{
"name": "36 CO",
"struct": {
"number": 36.0,
"unit": "CO"
}
}
]
},
{
"id": "M_US_SIZE",
"values": [
{
"name": "6.5 US",
"struct": {
"number": 6.5,
"unit": "US"
}
}
]
},
{
"id": "EU_SIZE",
"values": [
{
"name": "39 EU",
"struct": {
"number": 39.0,
"unit": "EU"
}
}
]
},
{
"id": "UK_SIZE",
"values": [
{
"name": "7 UK",
"struct": {
"number": 7.0,
"unit": "UK"
}
}
]
}
]
},
{
"id": "1746997:4",
"sites": [
"CBT",
"MLM",
"MLB",
"MLC",
"MCO"
],
"attributes": [
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "30 cm",
"struct": {
"number": 30.0,
"unit": "cm"
}
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "32 cm",
"struct": {
"number": 32.0,
"unit": "cm"
}
}
]
},
{
"id": "MANUFACTURER_SIZE",
"name": "Manufacturer size",
"label": "Manufacturer size",
"values": [
{
"name": "MM"
}
]
},
{
"id": "BR_SIZE",
"values": [
{
"name": "42 BR",
"struct": {
"number": 42.0,
"unit": "BR"
}
}
]
},
{
"id": "MX_SIZE",
"values": [
{
"name": "30 MX",
"struct": {
"number": 30.0,
"unit": "MX"
}
}
]
},
{
"id": "CL_SIZE",
"values": [
{
"name": "35 CL",
"struct": {
"number": 35.0,
"unit": "CL"
}
}
]
},
{
"id": "CO_SIZE",
"values": [
{
"name": "36 CO",
"struct": {
"number": 36.0,
"unit": "CO"
}
}
]
},
{
"id": "M_US_SIZE",
"values": [
{
"name": "7.5 US",
"struct": {
"number": 7.5,
"unit": "US"
}
}
]
},
{
"id": "EU_SIZE",
"values": [
{
"name": "44 EU",
"struct": {
"number": 44.0,
"unit": "EU"
}
}
]
},
{
"id": "UK_SIZE",
"values": [
{
"name": "7 UK",
"struct": {
"number": 7.0,
"unit": "UK"
}
}
]
}
]
}
]
}Size chart
Modify size charts
From a previously created size charts it will only be possible to modify the name field. If a mistake was made when creating the size charts, e.g. in the main sizes or in the gender assignment, the size charts must be recreated.
Request:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -d{...}https://api.mercadolibre.com/catalog/charts/$CHART_IDExample:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -d
'{
"names": {
"MLC": "New name MLC",
"MLM": "New name MLM",
"MLB": "New name MLB",
"CBT": "New name CBT",
"MCO": "New name MCO"
}
}'
https://api.mercadolibre.com/catalog/charts/5Delete size charts
By performing the following request you will be able to delete size charts unlinked to items.
Request:
curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog/charts/$CHART_IDExample:
curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/catalog/charts/1398269Response: {"message": "Before removing the size chart, we'll check that it isn't linked to any listing. If it's still there after 24 hours, it means it's linked to one or more listings and you'll have to unlink it to remove it"}
The size guide is not deleted immediately. According to the success message from the API, we check that the entered size guide is not linked to any item. If it is, and it still needs to be deleted, it is mandatory to unlink the size guide from all items. After deleting a Size Guide, it will be updated with new status data when a query or search is performed:
{
"id": "1398269",
"chart_status": "INACTIVE",
"names": {
"CBT": "Sizechart teste",
"MLB": "Sizechart teste",
"MCO": "Sizechart teste",
"MLM": "Sizechart teste",
"MLC": "Sizechart teste"
},
"domain_id": "HIKING_BOOTS",
"site_id": "CBT",
"type": "SPECIFIC",
"..."
}
Please run a search again to check that the size guide has been deleted.
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"
}
]
}
]