Documentation Mercado Libre
Check out all the necessary information about APIs Mercado Libre.
Documentation
Last update 06/09/2023
First steps
So, look at the technical flow to get quality items with size chart associated:
- Get data sheet: with this documentation.
- Manage Size Chart: using all data sheet information.
- Quality items (validations): validate all possible errors and messages of recommendations.
- Recommendations for Quality photo: check the certifications about your photos.
Define fashion domain to publish
To advance in the publication flow of a fashion article with an associated size chart, use the category predictor and get the domain_id on which it will be published.
Example
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/domain_discovery/search?q=Boots for womanResponse:
[
{
"domain_id": "CBT-BOOTS_AND_BOOTIES",
"domain_name": "Boots and booties",
"category_id": "CBT414251",
"category_name": "Boots & Booties",
"attributes": []
}
]Available domains for size chart
Then, check if the domain_id matches with one of available domains to associate size charts. See the available domains id to create size chart:
Request:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog/charts/CBT/configurations/active_domainsResponse:
{
“domains”: [
{
“domain_id”: “CBT-SNEAKERS”
},
{
“domain_id”: “CBT-BOOTS_AND_BOOTIES”
},
{
“domain_id”: “CBT-LOAFERS_AND_OXFORDS”
},
{
“domain_id”: “CBT-FOOTBALL_SHOES”
},
{
“domain_id”: “CBT-SANDALS_AND_CLOGS”
},
{
“domain_id”: “CBT-T_SHIRTS”
},
{
“domain_id”: “CBT-PAJAMAS”
},
{
“domain_id”: “CBT-SHIRTS”
},
{
“domain_id”: “CBT-JACKETS_AND_COATS”
},
{
“domain_id”: “CBT-DRESSES”
},
{
“domain_id”: “CBT-SWEATSHIRTS_AND_HOODIES”
},
{
“domain_id”: “CBT-BLOUSES”
}
]
}
Consult domain data sheet
Now, use the domain_id to consult the domain's data sheet. Please, recognize the attributes with value_type: grid_id and grid_row_id that will allow you to identify if the domain requires a size chart. In addition, see the attributes with grid_template_required tag, which you will use to search the data sheet of size chart.
Request:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/domains/$DOMAIN_ID/technical_specsExample consulting the CBT-SNEAKERS domain data sheet:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/domains/CBT-SNEAKERS/technical_specsResponse with the details of the domain's datasheet:
{
"input": {
"groups": [
{
"id": "MAIN",
"label": "Características principales",
"relevance": 1,
"section": "SPECIFICATIONS",
"ui_config": {},
"components": [
{
"component": "COMBO",
"label": "Brand",
"ui_config": {
"hint": "Indicate the actual brand of the product or 'Generic' if it has no brand.",
"allow_custom_value": true,
"allow_filtering": true
},
"attributes": [
{
"id": "BRAND",
"name": "Brand",
"value_type": "string",
"value_max_length": 255,
"tags": [
"grid_filter",
"catalog_required",
"required"
],
"values": [...],
"unified_units": []
},
{
"component": "TEXT_INPUT",
"label": "Line",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": false
},
"attributes": [
{
"id": "LINE",
"name": "Line",
"value_type": "string",
"value_max_length": 255,
"tags": [
"hidden"
],
"hierarchy": "PARENT_PK",
"relevance": 1
}
],
"unified_units": []
},
{
"component": "TEXT_INPUT",
"label": "Model",
"ui_config": {
"tooltip": "It is the product specific name.",
"allow_custom_value": false,
"allow_filtering": false
},
"attributes": [
{
"id": "MODEL",
"name": "Model",
"value_type": "string",
"value_max_length": 255,
"tags": [
"catalog_required",
"required"
],
"hierarchy": "PARENT_PK",
"relevance": 1
}
],
"unified_units": []
}...
],
"unified_units": []
},
{
"component": "COMBO",
"label": "Gender",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": true
},
"attributes": [
{
"id": "GENDER",
"name": "Gender",
"value_type": "list",
"tags": [
"grid_template_required",
"grid_filter",
"catalog_required",
"required"
],
"values": [
{
"id": "339665",
"name": "Woman"
}...
],
"hierarchy": "PARENT_PK",
"relevance": 1
}
],
"unified_units": []
},
{
"component": "COMBO",
"label": "Age group",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": true
},
"attributes": [
{
"id": "AGE_GROUP",
"name": "Age group",
"value_type": "list",
"tags": [
"hidden",
"read_only",
"grid_filter"
],
"values": [...],
"unified_units": []
},
{
"component": "TEXT_INPUT",
"label": "Alphanumeric model",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": false
},
"attributes": [
{
"id": "ALPHANUMERIC_MODEL",
"name": "Alphanumeric model",
"value_type": "string",
"value_max_length": 255,
"tags": [
"hidden"
],
"hierarchy": "PARENT_PK",
"relevance": 1
}
],
"unified_units": []
},
{
"component": "COLOR_INPUT",
"label": "Color",
"ui_config": {
"connector": ""
},
"attributes": [
{
"id": "COLOR",
"name": "Color",
"value_type": "string",
"value_max_length": 255,
"tags": [
"defines_picture",
"allow_variations",
"required"
],
"values": [
{
"id": "52019",
"name": "Dark green"
}...
],
"hierarchy": "CHILD_PK",
"relevance": 1
},
{
"id": "MAIN_COLOR",
"name": "Main color",
"value_type": "list",
"tags": [
"vip_hidden",
"variation_attribute"
],
"values": [
{
"id": "2450295",
"name": "Black",
"metadata": {
"rgb": "000000"
}
},
...
],
"hierarchy": "CHILD_DEPENDENT",
"relevance": 1
}
],
"unified_units": []
},
{
"component": "COMBO",
"label": "Fabric design",
"ui_config": {
"allow_custom_value": true,
"allow_filtering": true
},
"attributes": [
{
"id": "FABRIC_DESIGN",
"name": "Fabric design",
"value_type": "string",
"value_max_length": 255,
"tags": [
"defines_picture",
"allow_variations"
],
"values": [...],
"unified_units": []
},
{
"component": "COMBO",
"label": "Width type",
"ui_config": {
"allow_custom_value": true,
"allow_filtering": true
},
"attributes": [...],
"hierarchy": "CHILD_PK",
"relevance": 1
}
],
"unified_units": []
},
{
"component": "GRID_ROW_INPUT",
"label": "Size grid row ID",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": false
},
"attributes": [
{
"id": "SIZE_GRID_ROW_ID",
"name": "Size grid row ID",
"value_type": "grid_row_id",
"value_max_length": 255,
"tags": [
"vip_hidden",
"hidden",
"variation_attribute"
],
"hierarchy": "CHILD_PK",
"relevance": 1
}
],
"unified_units": []
},
{
"component": "COMBO",
"label": "Size",
"ui_config": {
"allow_custom_value": true,
"allow_filtering": true
},
"attributes": [
{
"id": "SIZE",
"name": "Size",
"value_type": "string",
"value_max_length": 255,
"tags": [
"allow_variations",
"required"
],
"values": [
{
"id": "6367305",
"name": "Only"
},
{
"id": "3259490",
"name": "Custom made"
}
],
"hierarchy": "CHILD_PK",
"relevance": 1
}
],
"unified_units": []
}
]
},
{
"id": "OTHER",
"label": "Otros",
"relevance": 1,
"section": "SPECIFICATIONS",
"ui_config": {},
"components": [
{...}
],
"unified_units": []
},
{
"component": "NUMBER_UNIT_INPUT",
"label": "Package height",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": false
},
"attributes": [
{
"id": "PACKAGE_HEIGHT",
"name": "Package height",
"value_type": "number_unit",
"value_max_length": 255,
"tags": [
"vip_hidden",
"variation_attribute",
"required"
],
"default_unit_id": "cm",
"units": [...],
"hierarchy": "CHILD_DEPENDENT",
"relevance": 1
}
],
"default_unified_unit_id": "cm",
"unified_units": [
{
"id": "mm",
"name": "mm"
},
{
"id": "cm",
"name": "cm"
},
{
"id": "m",
"name": "m"
},
{
"id": "\"",
"name": "\""
},
{
"id": "ft",
"name": "ft"
}
]
},
{
"component": "NUMBER_UNIT_INPUT",
"label": "Package width",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": false
},
"attributes": [
{
"id": "PACKAGE_WIDTH",
"name": "Package width",
"value_type": "number_unit",
"value_max_length": 255,
"tags": [
"vip_hidden",
"variation_attribute",
"required"
],
"default_unit_id": "cm",
"units": [
{
"id": "mm",
"name": "mm"
},
{
"id": "cm",
"name": "cm"
},
{
"id": "m",
"name": "m"
},
{
"id": "\"",
"name": "\""
},
{
"id": "ft",
"name": "ft"
}
],
"hierarchy": "CHILD_DEPENDENT",
"relevance": 1
}
],
"default_unified_unit_id": "cm",
"unified_units": [
{
"id": "mm",
"name": "mm"
},
{
"id": "cm",
"name": "cm"
},
{
"id": "m",
"name": "m"
},
{
"id": "\"",
"name": "\""
},
{
"id": "ft",
"name": "ft"
}
]
},
{
"component": "NUMBER_UNIT_INPUT",
"label": "Package length",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": false
},
"attributes": [
{
"id": "PACKAGE_LENGTH",
"name": "Package length",
"value_type": "number_unit",
"value_max_length": 255,
"tags": [
"vip_hidden",
"variation_attribute",
"required"
],
"default_unit_id": "cm",
"units": [
{
"id": "mm",
"name": "mm"
},
{
"id": "cm",
"name": "cm"
},
{
"id": "m",
"name": "m"
},
{
"id": "\"",
"name": "\""
},
{
"id": "ft",
"name": "ft"
}
],
"hierarchy": "CHILD_DEPENDENT",
"relevance": 1
}
],
"default_unified_unit_id": "cm",
"unified_units": [
{
"id": "mm",
"name": "mm"
},
{
"id": "cm",
"name": "cm"
},
{
"id": "m",
"name": "m"
},
{
"id": "\"",
"name": "\""
},
{
"id": "ft",
"name": "ft"
}
]
},
{
"component": "NUMBER_UNIT_INPUT",
"label": "Package weight",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": false
},
"attributes": [
{
"id": "PACKAGE_WEIGHT",
"name": "Package weight",
"value_type": "number_unit",
"value_max_length": 255,
"tags": [...],
"default_unit_id": "g",
"units": [
{
"id": "mg",
"name": "mg"
},
{
"id": "g",
"name": "g"
},
{
"id": "kg",
"name": "kg"
},
{
"id": "lb",
"name": "lb"
},
{
"id": "oz",
"name": "oz"
}
],
"hierarchy": "CHILD_DEPENDENT",
"relevance": 1
}
],
"default_unified_unit_id": "g",
"unified_units": [
{
"id": "mg",
"name": "mg"
},
{
"id": "g",
"name": "g"
},
{
"id": "kg",
"name": "kg"
},
{
"id": "lb",
"name": "lb"
},
{
"id": "oz",
"name": "oz"
}
]
},
{
"component": "GRID_INPUT",
"label": "Size grid ID",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": false
},
"attributes": [
{
"id": "SIZE_GRID_ID",
"name": "Size grid ID",
"value_type": "grid_id",
"value_max_length": 255,
"tags": [
"vip_hidden"
],
"hierarchy": "FAMILY",
"relevance": 1
}
],
"unified_units": []
},
{
"component": "COMBO",
"label": "Style",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": true
},
"attributes": [
{
"id": "STYLE",
"name": "Style",
"value_type": "list",
"tags": [
"required"
],
"values": [
{
"id": "6694772",
"name": "Sport"
},
{
"id": "6694773",
"name": "Urban"
}
],
"hierarchy": "FAMILY",
"relevance": 1
}
],
"unified_units": []
},
{
"component": "COMBO",
"label": "Recommended sports",
"ui_config": {
"tooltip": "It is the sport for which the product was designed.",
"allow_custom_value": true,
"allow_filtering": true,
"example": "Running; Trekking; Soccer; Tennis; Swimming; Hockey"
},
"attributes": [
{
"id": "RECOMMENDED_SPORTS",
"name": "Recommended sports",
"value_type": "string",
"value_max_length": 255,
"tags": [
"multivalued",
"grid_filter"
],
"values": [...],
"hierarchy": "FAMILY",
"relevance": 1
}
],
"unified_units": []
},
{
"component": "COMBO",
"label": "Exterior materials",
"ui_config": {
"tooltip": "These are the materials of the external part of the product.",
"allow_custom_value": true,
"allow_filtering": true,
"example": "Leather; Polycarbonate; Plastic; Fabric"
},
"attributes": [...],
"unified_units": []
},
{
"component": "COMBO",
"label": "Interior materials",
"ui_config": {
"allow_custom_value": true,
"allow_filtering": true
},
"attributes": [
{
"id": "INTERIOR_MATERIALS",
"name": "Interior materials",
"value_type": "string",
"value_max_length": 255,
"tags": [
"multivalued"
],
"values": [...],
"unified_units": []
},
{
"component": "COMBO",
"label": "Outsole materials",
"ui_config": {
"allow_custom_value": true,
"allow_filtering": true,
"example": "Rubber; Plastic; Aluminum; Polyurethane"
},
"attributes": [...],
"unified_units": []
},
{
"component": "COMBO",
"label": "Footwear technologies",
"ui_config": {
"allow_custom_value": true,
"allow_filtering": true,
"example": "Cloudfoam"
},
"attributes": [
{
"id": "FOOTWEAR_TECHNOLOGIES",
"name": "Footwear technologies",
"value_type": "string",
"value_max_length": 255,
"tags": [
"hidden",
"multivalued"
],
"values": [
{
"id": "5913148",
"name": "Pureboost"
},
{
"id": "5913149",
"name": "Ultraboost"
}
],
"hierarchy": "FAMILY",
"relevance": 1
}
],
"unified_units": []
},
{
"component": "COMBO",
"label": "Footwear type",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": true
},
"attributes": [...],
"hierarchy": "FAMILY",
"relevance": 1
}
],
"unified_units": []
},
{
"component": "COMBO",
"label": "Adjustment types",
"ui_config": {
"allow_custom_value": true,
"allow_filtering": true,
"example": "Shoelaces"
},
"attributes": [...],
"unified_units": []
},
{
"component": "TEXT_INPUT",
"label": "Universal product code",
"ui_config": {
"hint": "It may be an EAN, UPC or another GTIN.",
"tooltip": "How do I find it?\n\nIt is the number that identifies a product globally and has between 8 and 14 digits. Look for it on the packaging or label, next to the bar code. You must add a code for each variation. If you can not find it, you can ask the manufacturer or use a code search engine on the internet.",
"allow_custom_value": false,
"allow_filtering": false
},
"attributes": [
{
"id": "GTIN",
"name": "Universal product code",
"value_type": "string",
"value_max_length": 255,
"tags": [
"vip_hidden",
"multivalued",
"used_hidden",
"variation_attribute",
"required",
"validate"
],
"hierarchy": "PRODUCT_IDENTIFIER",
"relevance": 1
}
],
"unified_units": []
},
{
"component": "NUMBER_UNIT_INPUT",
"label": "Foot width",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": false
},
"attributes": [
{
"id": "FOOT_WIDTH",
"name": "Foot width",
"value_type": "number_unit",
"value_max_length": 255,
"tags": [
"hidden",
"variation_attribute"
],
"default_unit_id": "cm",
"units": [
{
"id": "\"",
"name": "\""
},
{
"id": "cm",
"name": "cm"
}
],
"hierarchy": "CHILD_DEPENDENT",
"relevance": 2
}
],
"default_unified_unit_id": "cm",
"unified_units": [
{
"id": "\"",
"name": "\""
},
{
"id": "cm",
"name": "cm"
}
]
},
{
"component": "NUMBER_UNIT_INPUT",
"label": "Footwear weight",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": false
},
"attributes": [...],
"default_unified_unit_id": "g",
"unified_units": [
{
"id": "g",
"name": "g"
}
]
},
{
"component": "COMBO",
"label": "Exterior composition",
"ui_config": {
"allow_custom_value": true,
"allow_filtering": true
},
"attributes": [
{
"id": "EXTERIOR_COMPOSITION",
"name": "Exterior composition",
"value_type": "string",
"value_max_length": 255,
"tags": [
"hidden",
"multivalued"
],
"values": [
{
"id": "11098228",
"name": "80% canvas"
},
{
"id": "11098229",
"name": "40% leather"
}
],
"hierarchy": "FAMILY",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "COMBO",
"label": "Outsole composition",
"ui_config": {
"allow_custom_value": true,
"allow_filtering": true
},
"attributes": [...],
"values": [
{
"id": "11098230",
"name": "80% EVA foam"
},
{
"id": "11098231",
"name": "40% polyurethane"
}
],
"hierarchy": "FAMILY",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "BOOLEAN_INPUT",
"label": "Is",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": true
},
"attributes": [
{
"id": "IS_IMPERMEABLE",
"name": "Impermeable",
"value_type": "boolean",
"tags": [
"hidden"
],
"values": [
{
"id": "242084",
"name": "No",
"metadata": {
"value": false
}
},
{...}
}
],
"hierarchy": "FAMILY",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "BOOLEAN_INPUT",
"label": "With",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": true
},
"attributes": [
{
"id": "WITH_ANTI_SLIP_OUTSOLE",
"name": "Anti-slip outsole",
"value_type": "boolean",
"tags": [
"hidden"
],
"values": [
{
"id": "242084",
"name": "No",
"metadata": {
"value": false
}
},
{
"id": "242085",
"name": "Yes",
"metadata": {
"value": true
}
}
],
"hierarchy": "FAMILY",
"relevance": 2
}
],
"unified_units": []
},
{...},
"attributes": [
{
"id": "WITH_REMOVABLE_INSOLES",
"name": "Removable insoles",
"value_type": "boolean",
"tags": [
"hidden"
],
"values": [...],
"hierarchy": "FAMILY",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "BOOLEAN_INPUT",
"label": "With",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": true
},
"attributes": [
{
"id": "WITH_BREATHEABLE_INSOLES",
"name": "Breatheable insoles",
"value_type": "boolean",
"tags": [
"hidden"
],
"values": [
{
"id": "242084",
"name": "No",
"metadata": {
"value": false
}
},
{
"id": "242085",
"name": "Yes",
"metadata": {
"value": true
}
}
],
"hierarchy": "FAMILY",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "COMBO",
"label": "Insoles materials",
"ui_config": {
"allow_custom_value": true,
"allow_filtering": true,
"example": "Cloth; Foam"
},
"attributes": [
{
"id": "INSOLES_MATERIALS",
"name": "Insoles materials",
"value_type": "string",
"value_max_length": 255,
"tags": [
"hidden",
"multivalued"
],
"values": [...],
"hierarchy": "FAMILY",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "COMBO",
"label": "Shaft type",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": true
},
"attributes": [
{
"id": "SHAFT_TYPE",
"name": "Shaft type",
"value_type": "list",
"tags": [
"hidden"
],
"values": [
{
"id": "1164225",
"name": "High"
},
{
"id": "1164226",
"name": "Low"
},
{
"id": "1164227",
"name": "Medium"
}
],
"hierarchy": "FAMILY",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "COMBO",
"label": "Midsole materials",
"ui_config": {
"allow_custom_value": true,
"allow_filtering": true
},
"attributes": [
{
"id": "MIDSOLE_MATERIALS",
"name": "Midsole materials",
"value_type": "string",
"value_max_length": 255,
"tags": [
"hidden",
"multivalued"
],
"values": [...],
"hierarchy": "FAMILY",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "BOOLEAN_INPUT",
"label": "With",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": true
},
"attributes": [
{
"id": "WITH_PADDED_MIDSOLE",
"name": "Padded midsole",
"value_type": "boolean",
"tags": [
"hidden"
],
"values": [...],
"hierarchy": "FAMILY",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "BOOLEAN_INPUT",
"label": "With",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": true
},
"attributes": [
{
"id": "WITH_PADDED_TONGUE",
"name": "Padded tongue",
"value_type": "boolean",
"tags": [
"hidden"
],
"values": [
{
"id": "242084",
"name": "No",
"metadata": {
"value": false
}
},
{
"id": "242085",
"name": "Yes",
"metadata": {
"value": true
}
}
],
"hierarchy": "FAMILY",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "BOOLEAN_INPUT",
"label": "With",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": true
},
"attributes": [
{
"id": "WITH_PADDED_COLLAR",
"name": "Padded collar",
"value_type": "boolean",
"tags": [
"hidden"
],
"values": [...],
"hierarchy": "FAMILY",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "COMBO",
"label": "Suitable surfaces",
"ui_config": {
"allow_custom_value": true,
"allow_filtering": true
},
"attributes": [...],
"hierarchy": "FAMILY",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "COMBO",
"label": "Release season",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": true
},
"attributes": [
{
"id": "RELEASE_SEASON",
"name": "Release season",
"value_type": "list",
"tags": [
"hidden"
],
"values": [
{
"id": "994283",
"name": "Spring/Summer"
}...
],
"hierarchy": "FAMILY",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "NUMBER_INPUT",
"label": "Release year",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": false
},
"attributes": [...],
"unified_units": []
},
{
"component": "COMBO",
"label": "Item condition",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": true
},
"attributes": [...],
"unified_units": []
},
{
"component": "TEXT_INPUT",
"label": "Filtrable size",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": false
},
"attributes": [
{
"id": "FILTRABLE_SIZE",
"name": "Filtrable size",
"value_type": "string",
"value_max_length": 255,
"tags": [
"vip_hidden",
"hidden",
"read_only",
"variation_attribute"
],
"hierarchy": "ITEM",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "TEXT_INPUT",
"label": "MPN",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": false
},
"attributes": [
{
"id": "MPN",
"name": "MPN",
"value_type": "string",
"value_max_length": 255,
"tags": [
"vip_hidden",
"hidden",
"multivalued",
"variation_attribute"
],
"hierarchy": "PRODUCT_IDENTIFIER",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "TEXT_INPUT",
"label": "SKU",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": false
},
"attributes": [
{
"id": "SELLER_SKU",
"name": "SKU",
"value_type": "string",
"value_max_length": 255,
"tags": [
"vip_hidden",
"hidden",
"variation_attribute"
],
"hierarchy": "ITEM",
"relevance": 1
}
],
"unified_units": []
},
{
"component": "BOOLEAN_INPUT",
"label": "Is",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": true
},
"attributes": [...],
"unified_units": []
},
{
"component": "BOOLEAN_INPUT",
"label": "Is",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": true
},
"attributes": [
{
"id": "IS_KIT",
"name": "Kit",
"value_type": "boolean",
"tags": [
"hidden"
],
"values": [
{
"id": "242084",
"name": "No",
"metadata": {
"value": false
}
},
{
"id": "242085",
"name": "Yes",
"metadata": {
"value": true
}
}
],
"hierarchy": "ITEM",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "TEXT_INPUT",
"label": "Descriptive tags",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": false
},
"attributes": [
{
"id": "DESCRIPTIVE_TAGS",
"name": "Descriptive tags",
"value_type": "string",
"value_max_length": 255,
"tags": [
"vip_hidden",
"hidden",
"read_only",
"multivalued"
],
"hierarchy": "ITEM",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "COMBO",
"label": "Product features",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": true
},
"attributes": [
{
"id": "PRODUCT_FEATURES",
"name": "Product features",
"value_type": "list",
"tags": [
"vip_hidden",
"hidden",
"read_only",
"multivalued"
],
"values": [
{
"id": "7435885",
"name": "Contains liquid"
}...
],
"hierarchy": "ITEM",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "COMBO",
"label": "Product chemical features",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": true
},
"attributes": [...],
"hierarchy": "ITEM",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "COMBO",
"label": "Foods and drinks",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": true
},
"attributes": [...],
"values": [
{
"id": "7575926",
"name": "For humans"
},
{
"id": "7575927",
"name": "For animals"
}
],
"hierarchy": "ITEM",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "COMBO",
"label": "Medicines",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": true
},
"attributes": [
{...}
],
"unified_units": []
},
{
"component": "COMBO",
"label": "Batteries features",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": true
},
"attributes": [
{
"id": "BATTERIES_FEATURES",
"name": "Batteries features",
"value_type": "list",
"tags": [...],
"values": [
{
"id": "7575934",
"name": "Stand-alone lithium (loose or isolated)"
},
{
"id": "7575935",
"name": "Lithium installed"
},
{
"id": "7575936",
"name": "For cars (lead-acid)"
}
],
"hierarchy": "ITEM",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "COMBO",
"label": "Shipment packing",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": true
},
"attributes": [
{
"id": "SHIPMENT_PACKING",
"name": "Shipment packing",
"value_type": "list",
"tags": [
"vip_hidden",
"hidden",
"read_only",
"multivalued"
],
"values": [
{
"id": "7435891",
"name": "Bag"
},
{
"id": "7435892",
"name": "Box"
},
{
"id": "7575939",
"name": "Self-shipping"
}
],
"hierarchy": "ITEM",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "COMBO",
"label": "Additional info required",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": true
},
"attributes": [
{
"id": "ADDITIONAL_INFO_REQUIRED",
"name": "Additional info required",
"value_type": "list",
"tags": [
"vip_hidden",
"hidden",
"read_only",
"multivalued"
],
"values": [
{...}
],
"hierarchy": "ITEM",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "COMBO",
"label": "Excluded platforms",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": true
},
"attributes": [
{
"id": "EXCLUDED_PLATFORMS",
"name": "Excluded platforms",
"value_type": "list",
"tags": [
"vip_hidden",
"hidden",
"read_only",
"multivalued"
],
"values": [...],
"hierarchy": "ITEM",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "BOOLEAN_INPUT",
"label": "Is",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": true
},
"attributes": [
{
"id": "IS_SUITABLE_FOR_SHIPMENT",
"name": "Suitable for shipment",
"value_type": "boolean",
"tags": [
"vip_hidden",
"hidden",
"read_only"
],
"values": [
{
"id": "242084",
"name": "No",
"metadata": {
"value": false
}
},
{
"id": "242085",
"name": "Yes",
"metadata": {
"value": true
}
}
],
"hierarchy": "ITEM",
"relevance": 2
}
],
"unified_units": []
},
{
"component": "TEXT_INPUT",
"label": "Product data source",
"ui_config": {
"allow_custom_value": false,
"allow_filtering": false
},
"attributes": [
{
"id": "PRODUCT_DATA_SOURCE",
"name": "Product data source",
"value_type": "string",
"value_max_length": 255,
"tags": [
"vip_hidden",
"hidden"
],
"hierarchy": "ITEM",
"relevance": 2
}
],
"unified_units": []
}
]
}
]
},
"output": {
"main_title": "Características Principales",
"groups": [
{
"id": "GENERAL_CHARACTERISTICS",
"label": "Características generales",
"relevance": 1,
"section": "SPECIFICATIONS",
"ui_config": {},
"components": [
{
"component": "TEXT_OUTPUT",
"label": "Brand",
"ui_config": {
"hint": "Indicate the actual brand of the product or 'Generic' if it has no brand."
},
"attributes": [
{
"id": "BRAND",
"name": "Brand",
"value_type": "string",
"tags": [],
"hierarchy": "PARENT_PK",
"relevance": 1
}
]
},
{
"component": "TEXT_OUTPUT",
"label": "Line",
"ui_config": {},
"attributes": [...]
},
{
"component": "TEXT_OUTPUT",
"label": "Alphanumeric model",
"ui_config": {},
"attributes": [
{
"id": "ALPHANUMERIC_MODEL",
"name": "Alphanumeric model",
"value_type": "string",
"tags": [],
"hierarchy": "PARENT_PK",
"relevance": 1
}
]
},
{
"component": "COLOR_OUTPUT",
"label": "Color",
"ui_config": {
"connector": ""
},
"attributes": [
{
"id": "COLOR",
"name": "Color",
"value_type": "string",
"tags": [],
"hierarchy": "CHILD_PK",
"relevance": 1
}
]
},
{
"component": "TEXT_OUTPUT",
"label": "Width type",
"ui_config": {},
"attributes": [
{
"id": "WIDTH_TYPE",
"name": "Width type",
"value_type": "string",
"tags": [],
"hierarchy": "CHILD_PK",
"relevance": 1
}
]
},
{
"component": "TEXT_OUTPUT",
"label": "Detailed model",
"ui_config": {},
"attributes": [
{
"id": "DETAILED_MODEL",
"name": "Detailed model",
"value_type": "string",
"tags": [],
"hierarchy": "CHILD_DEPENDENT",
"relevance": 1
}
]
}
]
},
{
"id": "DESIGN",
"label": "Diseño",
"relevance": 1,
"section": "SPECIFICATIONS",
"ui_config": {},
"components": [
{
"component": "TEXT_OUTPUT",
"label": "Fabric design",
"ui_config": {},
"attributes": [...]
},
{
"component": "BOOLEAN_OUTPUT",
"label": "With",
"ui_config": {},
"attributes": [
{
"id": "WITH_ANTI_SLIP_OUTSOLE",
"name": "Anti-slip outsole",
"value_type": "boolean",
"tags": [],
"hierarchy": "FAMILY",
"relevance": 2
}
]
},
{
"component": "BOOLEAN_OUTPUT",
"label": "With",
"ui_config": {},
"attributes": [
{
"id": "WITH_PLATFORM",
"name": "Platform",
"value_type": "boolean",
"tags": [],
"hierarchy": "FAMILY",
"relevance": 2
}
]
}...
{
"component": "BOOLEAN_OUTPUT",
"label": "With",
"ui_config": {},
"attributes": [
{
"id": "WITH_PADDED_COLLAR",
"name": "Padded collar",
"value_type": "boolean",
"tags": [],
"hierarchy": "FAMILY",
"relevance": 2
}
]
}
]
},
{
"id": "SIZE",
"label": "Talle",
"relevance": 1,
"section": "SPECIFICATIONS",
"ui_config": {},
"components": [
{
"component": "TEXT_OUTPUT",
"label": "Size",
"ui_config": {},
"attributes": [
{
"id": "SIZE",
"name": "Size",
"value_type": "string",
"tags": [],
"hierarchy": "CHILD_PK",
"relevance": 1
}
]
},
{
"component": "NUMBER_UNIT_OUTPUT",
"label": "Foot width",
"ui_config": {},
"attributes": [
{...}
]
}
]
},
{
"id": "SPECS",
"label": "Especificaciones",
"relevance": 1,
"section": "SPECIFICATIONS",
"ui_config": {},
"components": [
{
"component": "TEXT_OUTPUT",
"label": "Style",
"ui_config": {},
"attributes": [
{
"id": "STYLE",
"name": "Style",
"value_type": "list",
"tags": [],
"hierarchy": "FAMILY",
"relevance": 1
}
]
},
{
"component": "TEXT_OUTPUT",
"label": "Recommended sports",
"ui_config": {},
"attributes": [
{
"id": "RECOMMENDED_SPORTS",
"name": "Recommended sports",
"value_type": "string",
"tags": [],
"hierarchy": "FAMILY",
"relevance": 1
}
]
},
{
"component": "TEXT_OUTPUT",
"label": "Footwear technologies",
"ui_config": {},
"attributes": [
{
"id": "FOOTWEAR_TECHNOLOGIES",
"name": "Footwear technologies",
"value_type": "string",
"tags": [],
"hierarchy": "FAMILY",
"relevance": 1
}
]
}
]
},
{
"id": "MATERIALS",
"label": "Materiales",
"relevance": 1,
"section": "SPECIFICATIONS",
"ui_config": {},
"components": [...]
},
{
"component": "TEXT_OUTPUT",
"label": "Outsole materials",
"ui_config": {},
"attributes": [
{
"id": "OUTSOLE_MATERIALS",
"name": "Outsole materials",
"value_type": "string",
"tags": [],
"hierarchy": "FAMILY",
"relevance": 1
}
]
}...
{
"component": "NUMBER_OUTPUT",
"label": "Release year",
"ui_config": {},
"attributes": [
{
"id": "RELEASE_YEAR",
"name": "Release year",
"value_type": "number",
"tags": [],
"hierarchy": "FAMILY",
"relevance": 2
}
]
}
]
},
{
"id": "OTHER",
"label": "Otros",
"relevance": 1,
"section": "SPECIFICATIONS",
"ui_config": {},
"components": [...]
}
...
{
"component": "BOOLEAN_OUTPUT",
"label": "Is",
"ui_config": {},
"attributes": [
{
"id": "IS_FLAMMABLE",
"name": "Flammable",
"value_type": "boolean",
"tags": [],
"hierarchy": "FAMILY",
"relevance": 2
}
]
},
{...}
]
}
]
}
]
}
}Well, the GENDER attributes is the only with grid_template_required tag. So, use it and the domain id to get the data sheet of size chart for your product.
Consulting a size charts data sheet
The size chart data sheet will determine the structure of the attributes with a size chart in the listing. Following the previous example, execute a POST with the attributes: SPECIFIC (mandatory, type of chart) and all the attributes previously recognized with the grid_template_required tag as GENDER.
Request:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" https://api.mercadolibre.com/catalog/charts/searchExample consulting the details of the technical data sheet for a specific size chart (personalized) and the female gender:
"domain_id": "SNEAKERS",
"site_id": "CBT",
"type": "SPECIFIC",
"seller_id": 1161438226,
"attributes": [
{
"id": "GENDER",
"values": [
{
"id": "339665",
"value" : "Woman"
}
]
}
]Before carrying out research on the size chart, you should consider the attribute with the grid_template_required tag in the technical sheet that defines the POST attributes. Consider that in all cases, you must send the attributes of: domain, site, seller are mandatory.
If in the body of the POST is sent:
Without the type field, it will return all the results: specific (custom) size chart or brands according to the filters sent in the POST.
type= SPECIFIC: Will return all results: custom size chart sent in the POST, according to the gender to be sent.
type= BRAND: Will return all results: size chart previously established by the brand according to the filters sent in the POST.
Response with the detail of the technical data sheet of the size chart:
{
"id": "868447",
"names": {
"CBT": "Woman Equiv"
},
"domain_id": "SNEAKERS",
"site_id": "CBT",
"type": "SPECIFIC",
"seller_id": 1161438226,
"main_attribute_id": "UK_SIZE",
"secondary_attribute_id": "F_US_SIZE",
"attributes": [
{
"id": "GENDER",
"name": "Gender",
"values": [
{
"id": "339665",
"name": "Woman"
}
]
}
],
"rows": [
]
},If the search does not return results from the suggested tables, the answer you will get is the following and you must first create a size chart for the seller:
{
"charts": []
}If you perform a search with a domain that is not configured with the new size chart, you will receive an error.
{
"error": "domain_not_active",
"message": "Domain CBT-HATS_AND_CAPS is not active to be used in charts.",
"status": 400
}When checking the product specification sheet of size charts in TOPS and BOTTOMS domains, a list data type will be found, which establishes the possible values of a List. These values must be taken into account when creating a customized size chart in these domains:
Consult the tech spec to know all filtrable_size international disponible.
Ex. to filtrable size to T-SHIRT
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/domains/CBT-T_SHIRTS/technical_specs"attributes": [{
"id": "FILTRABLE_SIZE",
"name": "Equivalencies",
"value_type": "list",
"value_max_length": 255,
"tags": [
"vip_hidden",
"hidden",
"read_only",
"multivalued",
"variation_attribute",
"required"
],
"values": [{
"id": "12917835",
"name": "3XS"
},
{
"id": "12917836",
"name": "2XS"
},
{
"id": "12917776",
"name": "XS"
},
{
"id": "12917796",
"name": "S"
},
{
"id": "12917795",
"name": "M"
},
{
"id": "12917802",
"name": "L"
},
{
"id": "12917787",
"name": "XL"
},
{
"id": "12917846",
"name": "2XL"
},
{
"id": "12917837",
"name": "3XL"
},
{
"id": "12917843",
"name": "4XL"
},
{
"id": "12917842",
"name": "5XL"
},
{
"id": "12917838",
"name": "6XL"
},
{
"id": "12917841",
"name": "7XL"
},
{
"id": "12917845",
"name": "8XL"
},
{
"id": "12917844",
"name": "9XL"
},
{
"id": "12917839",
"name": "10XL"
}
],
"hierarchy": "ITEM",
"relevance": 2
}]Domains with uploaded size charts
This resource aims to inform the domains that have size charts created (SPECIFIC type) for a specific site. You must send in the body of the POST the filter type=SPECIFIC and the corresponding site.
Request:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog/charts/CBT/configurations/active_domainsResponse:
{
“domains”: [
{
“domain_id”: “CBT-SNEAKERS”
},
{
“domain_id”: “CBT-BOOTS_AND_BOOTIES”
},
{
“domain_id”: “CBT-LOAFERS_AND_OXFORDS”
},
{
“domain_id”: “CBT-FOOTBALL_SHOES”
},
{
“domain_id”: “CBT-SANDALS_AND_CLOGS”
},
{
“domain_id”: “CBT-T_SHIRTS”
},
{
“domain_id”: “CBT-PAJAMAS”
},
{
“domain_id”: “CBT-SHIRTS”
},
{
“domain_id”: “CBT-JACKETS_AND_COATS”
},
{
“domain_id”: “CBT-DRESSES”
},
{
“domain_id”: “CBT-SWEATSHIRTS_AND_HOODIES”
},
{
“domain_id”: “CBT-BLOUSES”
}
]
}
Next: Manage size chart.