Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Última actualización 31/08/2023
Variations
Benefits
- The buyer can see the different alternatives and their availability in the same listing.
- Fewer questions between buyer and seller.
- The purchase order will show the color and size chosen by the buyer for a smooth post-sale process and no claims.
- Improved stock control and handling.
Considerations
- You can send the stock code (SKU) for each variation. The correct way to keep the SKU is in the item attribute. This attribute is the SELLER_SKU, leaving the seller_custom_field field for internal use by the seller and without relationship between the two fields.
- In the /orders resource, both fields are currently available as in the /items resource and these are not combinable.
- Whenever the item has the attribute SELLER_SKU, both the /items and /orders will display the value of the attribute. You must always load the value in the attribute for it to be considered.
- The price must be the same for each variation. Only the highest price will be seen in the VIP and will also be taken into account at the time the payment is made.
List items with variations
To list items with variations, you should choose the category where you want to list. Once selected, you must check if the same allows variations identifying those attributes with the allow_variations tag. This type of attributes must be loaded in the section attribute_combinations, within variations, keeping in mind that you must load them for all the variations.
In turn, you can send the attributes property for each variation, specifying the item characteristics typical of each variation. In this section you can upload the attributes identified with the variation_attribute tag in the API. For example, if you sell a mobile phone in different colors and have a barcode for each one, you can upload it for each variation in the attributes section.
Request:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/$CATEGORY_ID/attributesExample:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/CBT1055/attributesResponse:
[
{
"id": "BRAND",
"name": "Brand",
"tags": {
"catalog_required": true,
"required": true
},
"hierarchy": "PARENT_PK",
"relevance": 1,
"value_type": "string",
"value_max_length": 255,
"values": [
{
"id": "360",
"name": "Consul"
},
{
"id": "18527",
"name": "Durabrand"
},
{
"id": "41935",
"name": "Esmaltec"
},
{
"id": "85327",
"name": "Fame"
},
{
"id": "1158795",
"name": "GE"
},
{
"id": "1022797",
"name": "Imperio"
},
{
"id": "449",
"name": "Kenwood"
},
{
"id": "20034",
"name": "Luft"
},
{
"id": "2785951",
"name": "Marbela"
},
{
"id": "58069",
"name": "Siam"
},
{
"id": "2785963",
"name": "Sitec"
},
{
"id": "187938",
"name": "Springer"
},
{
"id": "2785958",
"name": "Techna"
},
{
"id": "27327",
"name": "Telefunken"
},
{
"id": "2785959",
"name": "Tron Greco"
},
{
"id": "2785952",
"name": "Tufão"
},
{
"id": "2785953",
"name": "Ventax"
},
{
"id": "255",
"name": "Yelmo"
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "LINE",
"name": "Line",
"tags": {},
"hierarchy": "PARENT_PK",
"relevance": 1,
"value_type": "string",
"value_max_length": 255,
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "MODEL",
"name": "Model",
"tags": {
"catalog_required": true,
"required": true
},
"hierarchy": "PARENT_PK",
"relevance": 1,
"value_type": "string",
"value_max_length": 255,
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "ALPHANUMERIC_MODEL",
"name": "Alphanumeric model",
"tags": {
"hidden": true
},
"hierarchy": "PARENT_PK",
"relevance": 1,
"value_type": "string",
"value_max_length": 255,
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "FAN_TYPE",
"name": "Fan type",
"tags": {
"required": true
},
"hierarchy": "PARENT_PK",
"relevance": 1,
"value_type": "string",
"value_max_length": 255,
"values": [
{
"id": "124613",
"name": "Tower"
},
{
"id": "291721",
"name": "Pedestal"
},
{
"id": "291720",
"name": "Wall mount"
},
{
"id": "291722",
"name": "Table"
},
{
"id": "291719",
"name": "Ceiling"
},
{
"id": "6350778",
"name": "Window fan"
},
{
"id": "6694850",
"name": "Floor"
},
{
"id": "6774219",
"name": "Hand held"
},
{
"id": "7900931",
"name": "Car"
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "DIAMETER",
"name": "Diameter",
"tags": {},
"hierarchy": "CHILD_PK",
"relevance": 1,
"value_type": "number_unit",
"value_max_length": 255,
"allowed_units": [
{
"id": "\"",
"name": "\""
},
{
"id": "cm",
"name": "cm"
},
{
"id": "mm",
"name": "mm"
}
],
"default_unit": "cm",
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "STRUCTURE_COLOR",
"name": "Structure color",
"tags": {
"allow_variations": true,
"defines_picture": true
},
"hierarchy": "CHILD_PK",
"relevance": 1,
"value_type": "string",
"value_max_length": 255,
"values": [
{
"id": "52019",
"name": "Dark green"
},
{
"id": "283160",
"name": "Turquoise"
},
{
"id": "52022",
"name": "Water"
},
{
"id": "283162",
"name": "Indigo"
},
{
"id": "52036",
"name": "Lavender"
},
{
"id": "283163",
"name": "Pink gum"
},
{
"id": "51998",
"name": "Maroon"
},
{
"id": "52003",
"name": "Fur"
},
{
"id": "52055",
"name": "Blank"
},
{
"id": "283161",
"name": "Navy blue"
},
{
"id": "52008",
"name": "Cream"
},
{
"id": "52045",
"name": "Pale pink"
},
{
"id": "283153",
"name": "Cleat"
},
{
"id": "283150",
"name": "Light orange"
},
{
"id": "52028",
"name": "Blue"
},
{
"id": "52043",
"name": "Light pink"
},
{
"id": "283148",
"name": "Light coral"
},
{
"id": "283149",
"name": "Coral"
},
{
"id": "52021",
"name": "Heavenly"
},
{
"id": "52031",
"name": "Blue steel"
},
{
"id": "283156",
"name": "Khaki"
},
{
"id": "52001",
"name": "Beige"
},
{
"id": "51993",
"name": "Red"
},
{
"id": "51996",
"name": "Terracotta"
},
{
"id": "283165",
"name": "Grey"
},
{
"id": "52035",
"name": "Violet"
},
{
"id": "283154",
"name": "Light brown"
},
{
"id": "52049",
"name": "Black"
},
{
"id": "283155",
"name": "Dark brown"
},
{
"id": "52053",
"name": "Silver"
},
{
"id": "52047",
"name": "Dark violet"
},
{
"id": "51994",
"name": "Pink"
},
{
"id": "52007",
"name": "Yellow"
},
{
"id": "283157",
"name": "Lime green"
},
{
"id": "52012",
"name": "Dark gold"
},
{
"id": "52015",
"name": "Light green"
},
{
"id": "283151",
"name": "Dark orange"
},
{
"id": "52024",
"name": "Oil blue"
},
{
"id": "52051",
"name": "Dark grey"
},
{
"id": "283152",
"name": "Chocolate"
},
{
"id": "52014",
"name": "Green"
},
{
"id": "283164",
"name": "Golden"
},
{
"id": "52000",
"name": "Orange"
},
{
"id": "52033",
"name": "Dark blue"
},
{
"id": "52010",
"name": "Ochre"
},
{
"id": "283158",
"name": "Moss green"
},
{
"id": "52005",
"name": "Brown"
},
{
"id": "52038",
"name": "Lilac"
},
{
"id": "52042",
"name": "Fuchsia"
},
{
"id": "338779",
"name": "Cyan"
},
{
"id": "52029",
"name": "Light blue"
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "BLADES_COLOR",
"name": "Blades color",
"tags": {
"allow_variations": true,
"defines_picture": true
},
"hierarchy": "CHILD_PK",
"relevance": 1,
"value_type": "string",
"value_max_length": 255,
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "VOLTAGE",
"name": "Voltage",
"tags": {},
"hierarchy": "CHILD_PK",
"relevance": 1,
"value_type": "string",
"value_max_length": 255,
"values": [
{
"id": "198814",
"name": "110V"
},
{
"id": "106543",
"name": "380V"
},
{
"id": "198812",
"name": "110V/220V"
},
{
"id": "198813",
"name": "220V"
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "BLADES_MATERIAL",
"name": "Blades material",
"tags": {},
"hierarchy": "CHILD_PK",
"relevance": 1,
"value_type": "string",
"value_max_length": 255,
"values": [
{
"id": "6350781",
"name": "Wood"
},
{
"id": "6350782",
"name": "Plastic"
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "DETAILED_MODEL",
"name": "Detailed model",
"tags": {
"hidden": true,
"variation_attribute": true
},
"hierarchy": "CHILD_DEPENDENT",
"relevance": 1,
"value_type": "string",
"value_max_length": 255,
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "GRID_MATERIAL",
"name": "Grid material",
"tags": {},
"hierarchy": "FAMILY",
"relevance": 1,
"value_type": "string",
"value_max_length": 255,
"values": [
{
"id": "82755",
"name": "Metal"
},
{
"id": "82756",
"name": "Plastic"
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "SPEEDS",
"name": "Speeds number",
"tags": {},
"hierarchy": "FAMILY",
"relevance": 1,
"value_type": "number",
"value_max_length": 18,
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "INCLUDES_REMOTE_CONTROL",
"name": "Includes remote control",
"tags": {},
"hierarchy": "FAMILY",
"relevance": 1,
"value_type": "boolean",
"values": [
{
"id": "242084",
"name": "No",
"metadata": {
"value": false
}
},
{
"id": "242085",
"name": "Yes",
"metadata": {
"value": true
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "WITH_LIGHT",
"name": "With light",
"tags": {},
"hierarchy": "FAMILY",
"relevance": 1,
"value_type": "boolean",
"values": [
{
"id": "242084",
"name": "No",
"metadata": {
"value": false
}
},
{
"id": "242085",
"name": "Yes",
"metadata": {
"value": true
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "GTIN",
"name": "Universal product code",
"tags": {
"multivalued": true,
"required": true,
"variation_attribute": true,
"used_hidden": true,
"validate": true
},
"hierarchy": "PRODUCT_IDENTIFIER",
"relevance": 1,
"type": "product_identifier",
"value_type": "string",
"value_max_length": 255,
"tooltip": "How do I recognize it? It is an 8 to 14 digit number next to the barcode, on the product box or on its label.\n\n",
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others",
"hint": "It may be an EAN, UPC or another GTIN."
},
{
"id": "POWER_SUPPLY",
"name": "Power supply",
"tags": {
"hidden": true
},
"hierarchy": "FAMILY",
"relevance": 2,
"value_type": "string",
"value_max_length": 255,
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "IS_INDUSTRIAL",
"name": "Is industrial",
"tags": {
"hidden": true
},
"hierarchy": "FAMILY",
"relevance": 2,
"value_type": "boolean",
"values": [
{
"id": "242084",
"name": "No",
"metadata": {
"value": false
}
},
{
"id": "242085",
"name": "Yes",
"metadata": {
"value": true
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "IS_SILENT",
"name": "Is silent",
"tags": {
"hidden": true
},
"hierarchy": "FAMILY",
"relevance": 2,
"value_type": "boolean",
"values": [
{
"id": "242084",
"name": "No",
"metadata": {
"value": false
}
},
{
"id": "242085",
"name": "Yes",
"metadata": {
"value": true
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "WITH_ROTATING_GRID",
"name": "With rotating grid",
"tags": {
"hidden": true
},
"hierarchy": "FAMILY",
"relevance": 2,
"value_type": "boolean",
"values": [
{
"id": "242084",
"name": "No",
"metadata": {
"value": false
}
},
{
"id": "242085",
"name": "Yes",
"metadata": {
"value": true
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "BLADES_NUMBER",
"name": "Blades number",
"tags": {
"hidden": true
},
"hierarchy": "FAMILY",
"relevance": 2,
"value_type": "number",
"value_max_length": 18,
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "POWER",
"name": "Power",
"tags": {
"hidden": true
},
"hierarchy": "CHILD_DEPENDENT",
"relevance": 2,
"value_type": "number_unit",
"value_max_length": 255,
"allowed_units": [
{
"id": "W",
"name": "W"
}
],
"default_unit": "W",
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "WITH_ADJUSTABLE_HEIGHT",
"name": "With adjustable height",
"tags": {
"hidden": true
},
"hierarchy": "FAMILY",
"relevance": 2,
"value_type": "boolean",
"values": [
{
"id": "242084",
"name": "No",
"metadata": {
"value": false
}
},
{
"id": "242085",
"name": "Yes",
"metadata": {
"value": true
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "WITH_LATERAL_OSCILLATION",
"name": "With lateral oscillation",
"tags": {
"hidden": true
},
"hierarchy": "FAMILY",
"relevance": 2,
"value_type": "boolean",
"values": [
{
"id": "242084",
"name": "No",
"metadata": {
"value": false
}
},
{
"id": "242085",
"name": "Yes",
"metadata": {
"value": true
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "OSCILLATION_TYPE",
"name": "Oscillation type",
"tags": {
"hidden": true
},
"hierarchy": "FAMILY",
"relevance": 2,
"value_type": "string",
"value_max_length": 255,
"values": [
{
"id": "7900932",
"name": "Lateral"
},
{
"id": "7900933",
"name": "360°"
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "ITEM_CONDITION",
"name": "Item condition",
"tags": {
"hidden": true
},
"hierarchy": "ITEM",
"relevance": 2,
"value_type": "list",
"values": [
{
"id": "2230284",
"name": "New"
},
{
"id": "2230582",
"name": "Refurbished"
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "UPC",
"name": "UPC",
"tags": {
"hidden": true,
"multivalued": true,
"variation_attribute": true,
"validate": true
},
"hierarchy": "PRODUCT_IDENTIFIER",
"relevance": 2,
"type": "product_identifier",
"value_type": "string",
"value_max_length": 255,
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "MPN",
"name": "MPN",
"tags": {
"hidden": true,
"multivalued": true,
"variation_attribute": true
},
"hierarchy": "PRODUCT_IDENTIFIER",
"relevance": 2,
"type": "product_identifier",
"value_type": "string",
"value_max_length": 255,
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "EAN",
"name": "EAN",
"tags": {
"hidden": true,
"multivalued": true,
"variation_attribute": true,
"validate": true
},
"hierarchy": "PRODUCT_IDENTIFIER",
"relevance": 2,
"type": "product_identifier",
"value_type": "string",
"value_max_length": 255,
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "SELLER_SKU",
"name": "SKU",
"tags": {
"hidden": true,
"variation_attribute": true
},
"hierarchy": "ITEM",
"relevance": 1,
"value_type": "string",
"value_max_length": 255,
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "IS_FLAMMABLE",
"name": "Is flammable",
"tags": {
"hidden": true,
"read_only": true
},
"hierarchy": "FAMILY",
"relevance": 2,
"value_type": "boolean",
"values": [
{
"id": "242084",
"name": "No",
"metadata": {
"value": false
}
},
{
"id": "242085",
"name": "Yes",
"metadata": {
"value": true
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "IS_KIT",
"name": "Is kit",
"tags": {
"hidden": true
},
"hierarchy": "ITEM",
"relevance": 2,
"value_type": "boolean",
"values": [
{
"id": "242084",
"name": "No",
"metadata": {
"value": false
}
},
{
"id": "242085",
"name": "Yes",
"metadata": {
"value": true
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "DESCRIPTIVE_TAGS",
"name": "Descriptive tags",
"tags": {
"hidden": true,
"multivalued": true,
"read_only": true
},
"hierarchy": "ITEM",
"relevance": 2,
"value_type": "string",
"value_max_length": 255,
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "PACKAGE_LENGTH",
"name": "Package length",
"tags": {
"hidden": true,
"variation_attribute": true
},
"hierarchy": "ITEM",
"relevance": 2,
"value_type": "number_unit",
"value_max_length": 255,
"allowed_units": [
{
"id": "yd",
"name": "yd"
},
{
"id": "km",
"name": "km"
},
{
"id": "\"",
"name": "\""
},
{
"id": "ft",
"name": "ft"
},
{
"id": "hh",
"name": "hh"
},
{
"id": "pulgadas",
"name": "pulgadas"
},
{
"id": "m",
"name": "m"
},
{
"id": "in",
"name": "in"
},
{
"id": "mm",
"name": "mm"
},
{
"id": "µm",
"name": "µm"
},
{
"id": "cm",
"name": "cm"
},
{
"id": "nm",
"name": "nm"
},
{
"id": "U",
"name": "U"
}
],
"default_unit": "cm",
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "PACKAGE_WEIGHT",
"name": "Package weight",
"tags": {
"hidden": true,
"variation_attribute": true
},
"hierarchy": "ITEM",
"relevance": 2,
"value_type": "number_unit",
"value_max_length": 255,
"allowed_units": [
{
"id": "mg",
"name": "mg"
},
{
"id": "g",
"name": "g"
},
{
"id": "mcg",
"name": "mcg"
},
{
"id": "oz",
"name": "oz"
},
{
"id": "lb",
"name": "lb"
},
{
"id": "t",
"name": "t"
},
{
"id": "kg",
"name": "kg"
}
],
"default_unit": "g",
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "PACKAGE_WIDTH",
"name": "Package width",
"tags": {
"hidden": true,
"variation_attribute": true
},
"hierarchy": "ITEM",
"relevance": 2,
"value_type": "number_unit",
"value_max_length": 255,
"allowed_units": [
{
"id": "yd",
"name": "yd"
},
{
"id": "km",
"name": "km"
},
{
"id": "\"",
"name": "\""
},
{
"id": "ft",
"name": "ft"
},
{
"id": "hh",
"name": "hh"
},
{
"id": "pulgadas",
"name": "pulgadas"
},
{
"id": "m",
"name": "m"
},
{
"id": "in",
"name": "in"
},
{
"id": "mm",
"name": "mm"
},
{
"id": "µm",
"name": "µm"
},
{
"id": "cm",
"name": "cm"
},
{
"id": "nm",
"name": "nm"
},
{
"id": "U",
"name": "U"
}
],
"default_unit": "cm",
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "PACKAGE_HEIGHT",
"name": "Package height",
"tags": {
"hidden": true,
"variation_attribute": true
},
"hierarchy": "ITEM",
"relevance": 2,
"value_type": "number_unit",
"value_max_length": 255,
"allowed_units": [
{
"id": "yd",
"name": "yd"
},
{
"id": "km",
"name": "km"
},
{
"id": "\"",
"name": "\""
},
{
"id": "ft",
"name": "ft"
},
{
"id": "hh",
"name": "hh"
},
{
"id": "pulgadas",
"name": "pulgadas"
},
{
"id": "m",
"name": "m"
},
{
"id": "in",
"name": "in"
},
{
"id": "mm",
"name": "mm"
},
{
"id": "µm",
"name": "µm"
},
{
"id": "cm",
"name": "cm"
},
{
"id": "nm",
"name": "nm"
},
{
"id": "U",
"name": "U"
}
],
"default_unit": "cm",
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "PRODUCT_FEATURES",
"name": "Product features",
"tags": {
"hidden": true,
"multivalued": true,
"read_only": true
},
"hierarchy": "ITEM",
"relevance": 2,
"value_type": "list",
"values": [
{
"id": "7435885",
"name": "Contains liquid"
},
{
"id": "7435883",
"name": "Fragile"
},
{
"id": "7435888",
"name": "With expiration"
},
{
"id": "7575917",
"name": "Disinfectant and sanitizer"
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "PRODUCT_CHEMICAL_FEATURES",
"name": "Product chemical features",
"tags": {
"hidden": true,
"multivalued": true,
"read_only": true
},
"hierarchy": "ITEM",
"relevance": 2,
"value_type": "list",
"values": [
{
"id": "7651070",
"name": "Flammable"
},
{
"id": "7651071",
"name": "Aerosol"
},
{
"id": "7651072",
"name": "Oxidizer"
},
{
"id": "7651073",
"name": "Corrosive"
},
{
"id": "7651074",
"name": "Explosive"
},
{
"id": "7651075",
"name": "Toxic or infectious"
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "FOODS_AND_DRINKS",
"name": "Foods and drinks",
"tags": {
"hidden": true,
"multivalued": true,
"read_only": true
},
"hierarchy": "ITEM",
"relevance": 2,
"value_type": "list",
"values": [
{
"id": "7575926",
"name": "For humans"
},
{
"id": "7575927",
"name": "For animals"
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "MEDICINES",
"name": "Medicines",
"tags": {
"hidden": true,
"multivalued": true,
"read_only": true
},
"hierarchy": "ITEM",
"relevance": 2,
"value_type": "list",
"values": [
{
"id": "7575930",
"name": "For humans with a medical prescription"
},
{
"id": "7575931",
"name": "For humans without a medical prescription"
},
{
"id": "7575932",
"name": "For animals with a medical prescription"
},
{
"id": "7575933",
"name": "For animals without a medical prescription"
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "BATTERIES_FEATURES",
"name": "Batteries features",
"tags": {
"hidden": true,
"multivalued": true,
"read_only": true
},
"hierarchy": "ITEM",
"relevance": 2,
"value_type": "list",
"values": [
{
"id": "7575934",
"name": "Stand-alone lithium (loose or isolated)"
},
{
"id": "7575935",
"name": "Lithium installed"
},
{
"id": "7575936",
"name": "For cars (lead-acid)"
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "SHIPMENT_PACKING",
"name": "Shipment packing",
"tags": {
"hidden": true,
"multivalued": true,
"read_only": true
},
"hierarchy": "ITEM",
"relevance": 2,
"value_type": "list",
"values": [
{
"id": "7435891",
"name": "Bag"
},
{
"id": "7435892",
"name": "Box"
},
{
"id": "7575937",
"name": "Envelope"
},
{
"id": "7575938",
"name": "Voluminous"
},
{
"id": "7575939",
"name": "Self-shipping"
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "ADDITIONAL_INFO_REQUIRED",
"name": "Additional info required",
"tags": {
"hidden": true,
"multivalued": true,
"read_only": true
},
"hierarchy": "ITEM",
"relevance": 2,
"value_type": "list",
"values": [
{
"id": "7435893",
"name": "Has IMEI"
},
{
"id": "7435894",
"name": "Has serial number"
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "IS_SUITABLE_FOR_SHIPMENT",
"name": "Is suitable for shipment",
"tags": {
"hidden": true,
"read_only": true
},
"hierarchy": "ITEM",
"relevance": 2,
"value_type": "boolean",
"values": [
{
"id": "242084",
"name": "No",
"metadata": {
"value": false
}
},
{
"id": "242085",
"name": "Yes",
"metadata": {
"value": true
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
}
]After checking the attribute API configuration, you should create a listing JSON like the one below.
Example:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/items/ -d
{
"title": "Test",
"category_id": "CBT11796",
"price": 111.22,
"currency_id": "USD",
"available_quantity": "12",
"buying_mode": "buy_it_now",
"condition": "new",
"listing_type_id": "gold_pro",
"description": "30ml Shot Measure Liquor Bottle Pourer Measuring Drink Wine",
"video_id": null,
"sale_terms": [
{
"id": "WARRANTY_TIME",
"value_name": "90 days"
},
{
"id": "WARRANTY_TYPE",
"value_id": "2230279"
}
],
"site_id": "CBT",
"pictures": [
{
"source": "http://image-us.bigbuy.win/upload/image/assistant/TJA01327/TJA01327-2.jpg"
}
],
"attributes": [
{
"id": "MODEL",
"name": "Model",
"value_id": "",
"value_name": "No Brand",
"value_struct": null,
"values": [
{
"id": "",
"name": "No Brand",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "FOOTWEAR_TYPE",
"name": "Footwear type",
"value_id": "517584",
"value_name": "Shoe",
"value_struct": null,
"values": [
{
"id": "517584",
"name": "Shoe",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
}
],
"variations": [
{
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "51996",
"value_name": "Terracotta"
}
],
"price": 111.22,
"available_quantity": 100,
"attributes": [
{
"id": "UPC",
"value_name": "743562848603"
},
{
"id": "PACKAGE_HEIGHT",
"value_name": "0.01 cm"
},
{
"id": "PACKAGE_WIDTH",
"value_name": "1 cm"
},
{
"id": "PACKAGE_LENGTH",
"value_name": "1 cm"
},
{
"id": "PACKAGE_WEIGHT",
"value_name": "0.008 kg"
}
],
"sold_quantity": 100,
"picture_ids": [
"http://image-us.bigbuy.win/upload/image/assistant/TJA01327/TJA01327-2.jpg"
]
},
{
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "52003",
"value_name": "Fur"
}
],
"price": 111.22,
"available_quantity": 100,
"attributes": [
{
"id": "UPC",
"value_name": "743562848623"
},
{
"id": "PACKAGE_HEIGHT",
"value_name": "0.01 cm"
},
{
"id": "PACKAGE_WIDTH",
"value_name": "1 cm"
},
{
"id": "PACKAGE_LENGTH",
"value_name": "1 cm"
},
{
"id": "PACKAGE_WEIGHT",
"value_name": "0.008 kg"
}
],
"sold_quantity": 100,
"picture_ids": [
"http://image-us.bigbuy.win/upload/image/assistant/TJA01327/TJA01327-2.jpg"
]
}
]
}Response:
{
"id": "CBT926430395",
"site_id": "CBT",
"title": "Test",
"subtitle": null,
"seller_id": 523130418,
"category_id": "CBT11796",
"official_store_id": null,
"price": 111.22,
"base_price": 111.22,
"original_price": null,
"inventory_id": null,
"currency_id": "USD",
"initial_quantity": 200,
"available_quantity": 200,
"sold_quantity": 0,
"sale_terms": [
{
"id": "WARRANTY_TIME",
"name": "Warranty time",
"value_id": null,
"value_name": "90 days",
"value_struct": {
"number": 90,
"unit": "days"
},
"values": [
{
"id": null,
"name": "90 days",
"struct": {
"number": 90,
"unit": "days"
}
}
]
},
{
"id": "WARRANTY_TYPE",
"name": "Type of warranty",
"value_id": "2230279",
"value_name": "Factory warranty",
"value_struct": null,
"values": [
{
"id": "2230279",
"name": "Factory warranty",
"struct": null
}
]
}
],
"buying_mode": "buy_it_now",
"listing_type_id": "gold_pro",
"start_time": "2020-05-11T11:44:02.823Z",
"stop_time": "2040-05-06T04:00:00.000Z",
"end_time": "2040-05-06T04:00:00.000Z",
"expiration_time": "2020-07-30T11:44:02.894Z",
"condition": "new",
"permalink": "",
"pictures": [
{
"id": "954304-CBT41764803832_052020",
"url": "http://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/O-ES.jpg",
"secure_url": "https://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/O-ES.jpg",
"size": "500x500",
"max_size": "500x500",
"quality": ""
}
],
"video_id": null,
"descriptions": [
{
"id": "CBT926430395-2653866148"
}
],
"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": 1086581840,
"comment": "",
"address_line": "498 NW 3rd Av",
"zip_code": "12345",
"city": {
"id": "Q04tQ1FDaG9uZ3Fpbmc",
"name": "Chongqing"
},
"state": {
"id": "CN-CQ",
"name": "Chongqing"
},
"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": "MODEL",
"name": "Model",
"value_id": null,
"value_name": "No Brand",
"value_struct": null,
"values": [
{
"id": null,
"name": "No Brand",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "FOOTWEAR_TYPE",
"name": "Footwear type",
"value_id": "517584",
"value_name": "Shoe",
"value_struct": null,
"values": [
{
"id": "517584",
"name": "Shoe",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "GENDER",
"name": "Gender",
"value_id": "371795",
"value_name": "Babies",
"value_struct": null,
"values": [
{
"id": "371795",
"name": "Babies",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
}
],
"warnings": [],
"listing_source": "",
"variations": [
{
"id": 55621017072,
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "51996",
"value_name": "Terracotta",
"value_struct": null,
"values": [
{
"id": "51996",
"name": "Terracotta",
"struct": null
}
]
}
],
"price": 111.22,
"available_quantity": 100,
"sold_quantity": 0,
"sale_terms": [],
"picture_ids": [
"954304-CBT41764803832_052020"
],
"seller_custom_field": null,
"catalog_product_id": null,
"attributes": [
{
"id": "PACKAGE_HEIGHT",
"name": "Package height",
"value_id": null,
"value_name": "0.01 cm",
"value_struct": {
"number": 0.01,
"unit": "cm"
},
"values": [
{
"id": null,
"name": "0.01 cm",
"struct": {
"number": 0.01,
"unit": "cm"
}
}
]
},
{
"id": "PACKAGE_LENGTH",
"name": "Package length",
"value_id": null,
"value_name": "1 cm",
"value_struct": {
"number": 1,
"unit": "cm"
},
"values": [
{
"id": null,
"name": "1 cm",
"struct": {
"number": 1,
"unit": "cm"
}
}
]
},
{
"id": "PACKAGE_WEIGHT",
"name": "Package weight",
"value_id": null,
"value_name": "0.008 kg",
"value_struct": {
"number": 0.008,
"unit": "kg"
},
"values": [
{
"id": null,
"name": "0.008 kg",
"struct": {
"number": 0.008,
"unit": "kg"
}
}
]
},
{
"id": "PACKAGE_WIDTH",
"name": "Package width",
"value_id": null,
"value_name": "1 cm",
"value_struct": {
"number": 1,
"unit": "cm"
},
"values": [
{
"id": null,
"name": "1 cm",
"struct": {
"number": 1,
"unit": "cm"
}
}
]
},
{
"id": "GTIN",
"name": "Universal product code",
"value_id": null,
"value_name": "743562848603",
"value_struct": null,
"values": [
{
"id": null,
"name": "743562848603",
"struct": null
}
]
}
],
"inventory_id": null,
"item_relations": []
},
{
"id": 55621017079,
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "52003",
"value_name": "Fur",
"value_struct": null,
"values": [
{
"id": "52003",
"name": "Fur",
"struct": null
}
]
}
],
"price": 111.22,
"available_quantity": 100,
"sold_quantity": 0,
"sale_terms": [],
"picture_ids": [
"954304-CBT41764803832_052020"
],
"seller_custom_field": null,
"catalog_product_id": null,
"attributes": [
{
"id": "PACKAGE_HEIGHT",
"name": "Package height",
"value_id": null,
"value_name": "0.01 cm",
"value_struct": {
"number": 0.01,
"unit": "cm"
},
"values": [
{
"id": null,
"name": "0.01 cm",
"struct": {
"number": 0.01,
"unit": "cm"
}
}
]
},
{
"id": "PACKAGE_LENGTH",
"name": "Package length",
"value_id": null,
"value_name": "1 cm",
"value_struct": {
"number": 1,
"unit": "cm"
},
"values": [
{
"id": null,
"name": "1 cm",
"struct": {
"number": 1,
"unit": "cm"
}
}
]
},
{
"id": "PACKAGE_WEIGHT",
"name": "Package weight",
"value_id": null,
"value_name": "0.008 kg",
"value_struct": {
"number": 0.008,
"unit": "kg"
},
"values": [
{
"id": null,
"name": "0.008 kg",
"struct": {
"number": 0.008,
"unit": "kg"
}
}
]
},
{
"id": "PACKAGE_WIDTH",
"name": "Package width",
"value_id": null,
"value_name": "1 cm",
"value_struct": {
"number": 1,
"unit": "cm"
},
"values": [
{
"id": null,
"name": "1 cm",
"struct": {
"number": 1,
"unit": "cm"
}
}
]
}
],
"inventory_id": null,
"item_relations": []
}
],
"thumbnail": "http://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/I-ES.jpg",
"secure_thumbnail": "https://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/I-ES.jpg",
"status": "active",
"sub_status": [],
"tags": [
"immediate_payment"
],
"catalog_product_id": null,
"domain_id": null,
"seller_custom_field": null,
"parent_item_id": null,
"differential_pricing": null,
"deal_ids": [],
"automatic_relist": false,
"date_created": "2020-05-11T11:44:03.062Z",
"last_updated": "2020-05-11T11:44:03.062Z",
"health": null,
"catalog_listing": false,
"item_relations": []
}Example: if you want to use size 46 and it is not among possible Size attribute values in category MLU185734, you can use it anyway as "value_name": "46", as shown below:
"variations": [{
"attribute_combinations": [{
"id": "103000",
"value_id": "4883e91" --> value_id que corresponde al talle: 38
}, {
"id": "11000",
"value_id": "10295e4"
}],
"available_quantity": 17,
"price": 1299.0,
"seller_custom_field": "611111",
"picture_ids": ["https://s-media-cache-ak0.pinimg.com/736x/63/9c/a0/639ca03b5ca79e73002b4f2d4776d03b.jpg",
]
}, {
"attribute_combinations": [{
"id": "103000",
"value_id": "86e5356" --> value_id que corresponde al talle: 44
}, {
"id": "11000",
"value_id": "10295e4"
}],
"available_quantity": 12,
"price": 1299.0,
"seller_custom_field": "6131111",
"picture_ids": ["https://s-media-cache-ak0.pinimg.com/736x/63/9c/a0/639ca03b5ca79e73002b4f2d4776d03b.jpg",
]
}, {
"attribute_combinations": [{
"id": "103000",
"value_name": "46" --> value_name que agregamos para el talle 46
}, {
"id": "11000",
"value_id": "10295e4"
}],
"available_quantity": 21,
"price": 1299.0,
"seller_custom_field": "611111”,
"picture_ids": ["https://s-media-cache-ak0.pinimg.com/736x/63/9c/a0/639ca03b5ca79e73002b4f2d4776d03b.jpg",
]
}]For more information review documentation about Attributes.
Required attributes
Now when you make new publications, you must read the required:true tag to identify the attributes that are required by category.
{
"message": "Validation error",
"error": "validation_error",
"status": 400,
"cause": [{
"code": "item.attributes.missing_required",
"message": "One or more required attributes are not present in the item. Check the attribute is present in the attributes list or in the variations attributes_combination or attributes."
}]
}
Query variations
There are two ways to consult the variations of your item, one is by looking at the variations section in the item information:
Request:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_IDExample:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA658778048?attributes=variationsResponse:
{
"variations": [
{
"id": 15093610263,
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "52000",
"value_name": "Naranja"
}
],
"price": 100,
"available_quantity": 4,
"sold_quantity": 0,
"picture_ids": [
"553111-MLA20482692355_112015"
],
"seller_custom_field": null,
"catalog_product_id": null
}
]
}Or otherwise, with the next request, which will directly filter the previous response to show the variations only:
Request:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/variationsExample:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/CBT926430395?variationsResponse:
{
"id": "CBT926430395",
"site_id": "CBT",
"title": "Test",
"subtitle": null,
"seller_id": 523130418,
"category_id": "CBT11796",
"official_store_id": null,
"price": 111.22,
"base_price": 111.22,
"original_price": null,
"currency_id": "USD",
"initial_quantity": 200,
"available_quantity": 100,
"sold_quantity": 0,
"sale_terms": [
{
"id": "WARRANTY_TIME",
"name": "Warranty time",
"value_id": null,
"value_name": "90 days",
"value_struct": {
"number": 90,
"unit": "days"
},
"values": [
{
"id": null,
"name": "90 days",
"struct": {
"number": 90,
"unit": "days"
}
}
]
},
{
"id": "WARRANTY_TYPE",
"name": "Type of warranty",
"value_id": "2230279",
"value_name": "Factory warranty",
"value_struct": null,
"values": [
{
"id": "2230279",
"name": "Factory warranty",
"struct": null
}
]
}
],
"buying_mode": "buy_it_now",
"listing_type_id": "gold_pro",
"start_time": "2020-05-11T11:44:02.000Z",
"stop_time": "2040-05-06T04:00:00.000Z",
"condition": "new",
"permalink": "",
"thumbnail": "http://cbt-s2-p.mlstatic.com/954304-CBT41764803832_052020-I.jpg",
"secure_thumbnail": "https://cbt-s2-p.mlstatic.com/954304-CBT41764803832_052020-I.jpg",
"pictures": [
{
"id": "954304-CBT41764803832_052020",
"url": "http://cbt-s2-p.mlstatic.com/954304-CBT41764803832_052020-O.jpg",
"secure_url": "https://cbt-s2-p.mlstatic.com/954304-CBT41764803832_052020-O.jpg",
"size": "490x500",
"max_size": "1597x1629",
"quality": ""
}
],
"video_id": null,
"descriptions": [
{
"id": "CBT926430395-2653866148"
}
],
"accepts_mercadopago": true,
"non_mercado_pago_payment_methods": [],
"shipping": {
"mode": "not_specified",
"methods": [],
"tags": [],
"dimensions": null,
"local_pick_up": false,
"free_shipping": false,
"logistic_type": "not_specified",
"store_pick_up": false
},
"international_delivery_mode": "none",
"seller_address": {
"city": {
"id": "Q04tQ1FDaG9uZ3Fpbmc",
"name": "Chongqing"
},
"state": {
"id": "CN-CQ",
"name": "Chongqing"
},
"country": {
"id": "CN",
"name": "China"
},
"id": 1086581840
},
"seller_contact": null,
"location": {},
"coverage_areas": [],
"attributes": [
{
"id": "FOOTWEAR_TYPE",
"name": "Footwear type",
"value_id": "517584",
"value_name": "Shoe",
"value_struct": null,
"values": [
{
"id": "517584",
"name": "Shoe",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "GENDER",
"name": "Gender",
"value_id": "371795",
"value_name": "Babies",
"value_struct": null,
"values": [
{
"id": "371795",
"name": "Babies",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
},
{
"id": "MODEL",
"name": "Model",
"value_id": null,
"value_name": "No Brand",
"value_struct": null,
"values": [
{
"id": null,
"name": "No Brand",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others"
}
],
"warnings": [],
"listing_source": "",
"variations": [
{
"id": 55621017072,
"price": 111.22,
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "51996",
"value_name": "Terracotta",
"value_struct": null,
"values": [
{
"id": "51996",
"name": "Terracotta",
"struct": null
}
]
}
],
"available_quantity": 50,
"sold_quantity": 0,
"sale_terms": [],
"picture_ids": [
"954304-CBT41764803832_052020"
],
"catalog_product_id": null
},
{
"id": 55621017079,
"price": 111.22,
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "52003",
"value_name": "Fur",
"value_struct": null,
"values": [
{
"id": "52003",
"name": "Fur",
"struct": null
}
]
}
],
"available_quantity": 50,
"sold_quantity": 0,
"sale_terms": [],
"picture_ids": [
"954304-CBT41764803832_052020"
],
"catalog_product_id": null
}
],
"status": "active",
"sub_status": [],
"tags": [
"immediate_payment"
],
"catalog_product_id": null,
"domain_id": "CBT-BABIES_FOOTWEAR",
"parent_item_id": null,
"differential_pricing": null,
"deal_ids": [],
"automatic_relist": false,
"date_created": "2020-05-11T11:44:03.000Z",
"last_updated": "2020-05-11T11:44:07.000Z",
"health": null,
"catalog_listing": false
}Once you get each variation Id, you can query one in particular by adding the variation_id at the end of the previous request, as shown below.
Request:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/variations/$VARIATION_IDExample:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/items/CBT926430395/variations/55621017072Response:
{
"id": 55621017072,
"price": 111.22,
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "51996",
"value_name": "Terracotta",
"value_struct": null,
"values": [
{
"id": "51996",
"name": "Terracotta",
"struct": null
}
]
}
],
"available_quantity": 100,
"sold_quantity": 0,
"sale_terms": [],
"picture_ids": [
"954304-CBT41764803832_052020"
],
"catalog_product_id": null,
"attributes": [
{
"id": "PACKAGE_HEIGHT",
"name": "Package height",
"value_id": null,
"value_name": "0.01 cm",
"value_struct": {
"number": 0.01,
"unit": "cm"
},
"values": [
{
"id": null,
"name": "0.01 cm",
"struct": {
"number": 0.01,
"unit": "cm"
}
}
]
},
{
"id": "PACKAGE_LENGTH",
"name": "Package length",
"value_id": null,
"value_name": "1 cm",
"value_struct": {
"number": 1,
"unit": "cm"
},
"values": [
{
"id": null,
"name": "1 cm",
"struct": {
"number": 1,
"unit": "cm"
}
}
]
},
{
"id": "PACKAGE_WEIGHT",
"name": "Package weight",
"value_id": null,
"value_name": "0.008 kg",
"value_struct": {
"number": 0.008,
"unit": "kg"
},
"values": [
{
"id": null,
"name": "0.008 kg",
"struct": {
"number": 0.008,
"unit": "kg"
}
}
]
},
{
"id": "PACKAGE_WIDTH",
"name": "Package width",
"value_id": null,
"value_name": "1 cm",
"value_struct": {
"number": 1,
"unit": "cm"
},
"values": [
{
"id": null,
"name": "1 cm",
"struct": {
"number": 1,
"unit": "cm"
}
}
]
},
{
"id": "GTIN",
"name": "Universal product code",
"value_id": null,
"value_name": "743562848603",
"value_struct": null,
"values": [
{
"id": null,
"name": "743562848603",
"struct": null
}
]
}
]
}Example:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/CBT910505150?include_attributes=allAdd new variations
If a new variation of your already listed item becomes available in your stock, you will be able to add a new variation. To do so, you should make a PUT to the item, listing both the existing variations Ids and the variation to be created in the variations property. Well done! If you check the item, you will see the new variation listed.
Example:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/global/items/CBT926687275 -d
{
"variations": [
{
"id": 55667128568
},
{
"id": 55667128576
},
{
"price": 111.22,
"attribute_combinations": [
{
"id": "COLOR",
"value_id": "52036"
}
],
"available_quantity": 100,
"picture_ids": [
"938105-CBT41776607082_052020"
]
}
],
}Change variations
Now that you have learned how to list and make variations queries, you may need to make changes to update stock, prices, add variations of your item, or change the value of some of the listed attributes. Based on the Fan example, we have already shown you how to list a Fan with Color variations. Now imagine that in addition to Color variations, you want to add Voltage variations. To do so, you should make a PUT, as in the example below, sending all the variations and adding the Voltage attribute in the attribute_combinations field of each variation.
Example:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/global/items/CBT926687275 -d
{
"variations": [
{
"id": 55667128568
},
{
"id": 55667128576
},
{
"id":55667239057,
"price": 111.22,
"attribute_combinations": [
{
"id": "COLOR",
"value_id": "52022"
}
],
"available_quantity": 100,
"picture_ids": [
"938105-CBT41776607082_052020"
]
}
],
}'You may also want to change or eliminate an attribute by which your item varies. To do so, you must check that the variations you want to change do not have sales.
Based on the Fan example, imagine that your Fans no longer vary by Voltage, and, in turn, your Fan is not Violet but Dark Violet. To make this change, you should make a PUT, as in the Example: below, sending all the variations with the attribute Voltage with value_id and value_name null to be deleted, and, in turn, the variation corresponding to the Violet color with the value_name changed to Dark Violet.
Example:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/global/items/CBT926687275 -d
{
"variations": [
{
"id": 55667128568
},
{
"id": 55667128576
},
{
"id":55667239057,
"price": 111.22,
"attribute_combinations": [
{
"id": "COLOR",
"value_id": "2450290"
}
],
"available_quantity": 100,
"picture_ids": [
"938105-CBT41776607082_052020"
]
}
],
}'Response:
[
{
"id": 15092589430,
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "52005",
"value_name": "Marrón"
}
],
"price": 100,
"available_quantity": 4,
"sold_quantity": 0,
"picture_ids": [
"553111-MLA20482692355_112015",
"629425-MLA25446587248_032017"
],
"seller_custom_field": null,
"catalog_product_id": null,
"attributes": [
{
"id": "EAN",
"name": "EAN",
"value_id": null,
"value_name": "7794940000796"
},
{
"id": "UPC",
"name": "UPC",
"value_id": null,
"value_name": "7792931000015"
}
]
},{
"id": 15093506680,
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "52035",
"value_name": "Violeta Oscuro"
}
],
"price": 100,
"available_quantity": 4,
"sold_quantity": 0,
"picture_ids": [
"553111-MLA20482692355_112015",
"629425-MLA25446587248_032017"
],
"seller_custom_field": null,
"catalog_product_id": null,
"attributes": [
{
"id": "EAN",
"name": "EAN",
"value_id": null,
"value_name": "7794940000796"
},
{
"id": "UPC",
"name": "UPC",
"value_id": null,
"value_name": "7792931000015"
}
]
}
]Example:
If you have the following variant:
"variations": [
{
"id": 30078896884,
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "52014",
"value_name": "Verde",
"value_struct": null
},
{
"id": "SIZE",
"name": "Talle",
"value_id": null,
"value_name": "M",
"value_struct": null
}
],
"price": 47.81,
"available_quantity": 2
},
{
"id": 30078896888,
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "52014",
"value_name": "Verde",
"value_struct": null
},
{
"id": "SIZE",
"name": "Talle",
"value_id": null,
"value_name": " L",
"value_struct": null
}
],
"price": 47.81,
"available_quantity": 2
}
]And you want to modify the variant 30078896888 and you don’t send its id, like in the following example:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/global/items/$ITEM_ID -d
{
"variations": [
{
"id": 30078896884
},
{
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "52014",
"value_name": "Verde",
"value_struct": null
},
{
"id": "SIZE",
"name": "Talle",
"value_id": null,
"value_name": " L",
"value_struct": null
}
],
"price": 47.81
"available_quantity": 8 -> Se pretende modificar el stock
}
]The variant 30078896888 will be deleted (since its ID was not sent) and a new one will be created with Color Green and Size “L” (which will not be connected to the eliminated variant, although it has the same attributes). The correct way of doing this is:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/global/items/$ITEM_ID -d
{
"variations": [{
"id": 30078896884
},
{
"id": 30078896888,
"available_quantity": 8 -> Se pretende modificar el stock
}
]
}Add or change the typical attributes of each variation
Moreover, at some point you may want to add more attributes typical of one or several particular variations. Follow the Fan Example: until each variation has the information contained in the bar code (EAN). Now imagine that, for some variations, we have information from another bar code -the UPC- and we want to add it. To do so, we have two alternatives: to make a PUT, as in the Example: below, sending all the variations, but adding the attributes field to the variations to which we want to add the UPC attribute.
Example:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' https://api.mercadolibre.com/global/items/CBT1070438395 -d
{
"variations": [{
"id": 23217493044
},
{
"id": 23217493049,
"attributes": [{
"id": "PACKAGE_HEIGHT",
"value_name": "25 cm"
}, {
"id": "PACKAGE_WIDTH",
"value_name": "17 cm"
}, {
"id": "SELLER_SKU",
"value_name": "Prueba3_xxx"
}]
}
]
}Response:
{
"id": "MLM623075370",
"site_id": "MLM",
"title": "Item De Prueba - No Ofertar",
"subtitle": null,
"seller_id": 310695640,
"category_id": "MLM174913",
"official_store_id": null,
"price": 1,
"base_price": 1,
"original_price": null,
"currency_id": "MXN",
"initial_quantity": 2,
"available_quantity": 2,
"sold_quantity": 0,
"sale_terms": [],
"buying_mode": "buy_it_now",
"listing_type_id": "gold_pro",
"start_time": "2018-04-24T16:43:02.000Z",
"historical_start_time": "2018-04-24T16:43:02.000Z",
"stop_time": "2038-04-19T04:00:00.000Z",
"end_time": "2038-04-19T04:00:00.000Z",
"expiration_time": "2018-07-13T17:01:35.847Z",
"condition": "new",
"permalink": "http://articulo.mercadolibre.com.mx/MLM-623075370-item-de-prueba-no-ofertar-_JM",
"thumbnail": "http://mlm-s1-p.mlstatic.com/965478-MLM27243332493_042018-I.jpg",
"secure_thumbnail": "https://mlm-s1-p.mlstatic.com/965478-MLM27243332493_042018-I.jpg",
"pictures": [
{
"id": "965478-MLM27243332493_042018",
"url": "http://mlm-s1-p.mlstatic.com/965478-MLM27243332493_042018-O.jpg",
"secure_url": "https://mlm-s1-p.mlstatic.com/965478-MLM27243332493_042018-O.jpg",
"size": "500x500",
"max_size": "1000x1000",
"quality": ""
}
],
"video_id": null,
"descriptions": [],
"accepts_mercadopago": true,
"non_mercado_pago_payment_methods": [],
"shipping": {
"mode": "not_specified",
"local_pick_up": true,
"free_shipping": false,
"methods": [],
"dimensions": null,
"tags": [],
"logistic_type": "not_specified",
"store_pick_up": false
},
"international_delivery_mode": "none",
"seller_address": {
"id": 855164029,
"comment": "",
"address_line": "Test Address 123",
"zip_code": "",
"city": {
"id": "",
"name": "Ciudad de Mexico"
},
"state": {
"id": "MX-DIF",
"name": "Distrito Federal"
},
"country": {
"id": "MX",
"name": "Mexico"
},
"latitude": "",
"longitude": "",
"search_location": {
"neighborhood": {
"id": "",
"name": ""
},
"city": {
"id": "",
"name": ""
},
"state": {
"id": "TUxNUERJUzYwOTQ",
"name": "Distrito Federal"
}
}
},
"seller_contact": null,
"location": {},
"geolocation": {
"latitude": "",
"longitude": ""
},
"coverage_areas": [],
"attributes": [
{
"id": "MODEL",
"name": "Modelo",
"value_id": null,
"value_name": "Mosaic",
"value_struct": null,
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "BRAND",
"name": "Marca",
"value_id": null,
"value_name": "ROHO",
"value_struct": null,
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "ITEM_CONDITION",
"name": "Condición del ítem",
"value_id": "2230284",
"value_name": "Nuevo",
"value_struct": null,
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
}
],
"warnings": [],
"listing_source": "",
"variations": [
{
"id": 23217493044,
"attribute_combinations": [
{
"id": null,
"name": "Tamaño",
"value_id": null,
"value_name": "16\" x 16\" (40 x 40 cm)",
"value_struct": null
}
],
"price": 1,
"available_quantity": 1,
"sold_quantity": 0,
"sale_terms": [],
"picture_ids": [
"965478-MLM27243332493_042018"
],
"seller_custom_field": "Datos_interno_variacion_xxxx",
"catalog_product_id": null,
"attributes": [
{
"id": "SELLER_SKU",
"name": "SKU ",
"value_id": null,
"value_name": "Prueba-xxx",
"value_struct": null
}
]
},
{
"id": 23217493049,
"attribute_combinations": [
{
"id": null,
"name": "Tamaño",
"value_id": null,
"value_name": "18\" x 18\" (45 x 45 cm)",
"value_struct": null
}
],
"price": 1,
"available_quantity": 1,
"sold_quantity": 0,
"sale_terms": [],
"picture_ids": [
"965478-MLM27243332493_042018"
],
"seller_custom_field": "Datos_interno_variacion_xxxx1",
"catalog_product_id": null,
"attributes": [
{
"id": "PACKAGE_HEIGHT",
"name": "Altura del paquete",
"value_id": null,
"value_name": "25 cm",
"value_struct": {
"unit": "cm",
"number": 25
}
},
{
"id": "PACKAGE_WIDTH",
"name": "Ancho del paquete",
"value_id": null,
"value_name": "17 cm",
"value_struct": {
"unit": "cm",
"number": 17
}
},
{
"id": "SELLER_SKU",
"name": "SKU ",
"value_id": null,
"value_name": "Prueba3_xxx",
"value_struct": null
}
]
}
],
"status": "active",
"sub_status": [],
"tags": [
"test_item",
"good_quality_picture",
"immediate_payment"
],
"catalog_product_id": null,
"domain_id": null,
"seller_custom_field": "Datos_interno_item",
"parent_item_id": null,
"differential_pricing": null,
"deal_ids": [],
"automatic_relist": false,
"date_created": "2018-04-24T16:43:02.000Z",
"last_updated": "2018-04-24T17:01:35.883Z",
"total_listing_fee": null
}
You may also want to change the value of a typical attribute of each variation. Imagine that you want to change the EAN attribute value of a particular variation. To do so, you should make a PUT, as in the example: below, specifying the variation that you want to change. You should send all the attributes in the attributes field and the changed value_name field for the EAN attribute.
Don't forget to send the ID of all the other variations that you don't want to change to prevent deletion.
Example:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' https://api.mercadolibre.com/items/MLA658778048 -d
{
"variations": [{
"id": "15092589430",
"attributes": [{
"id": "EAN",
"name": "EAN",
"value_name": "7792931000015"
},
{
"id": "GTIN",
"name": "GTIN",
"value_name": "7792931000015"
}
]
}]
}Response:
{
"id": "MLA658778048",
"site_id": "MLA",
"title": "Item De Testeo",
"subtitle": null,
"seller_id": 247212006,
"category_id": "MLA378496",
"official_store_id": null,
"price": 100,
"base_price": 100,
"original_price": null,
"currency_id": "ARS",
"initial_quantity": 4,
"available_quantity": 4,
"sold_quantity": 0,
"buying_mode": "buy_it_now",
"listing_type_id": "gold_special",
"start_time": "2017-03-20T15:44:00.000Z",
"stop_time": "2037-03-15T15:44:00.000Z",
"end_time": "2037-03-15T15:44:00.000Z",
"expiration_time": "2017-06-17T14:55:54.306Z",
"condition": "not_specified",
"permalink": "http://articulo.mercadolibre.com.ar/MLA-658778048-item-de-testeo-_JM",
"thumbnail": "http://mla-s2-p.mlstatic.com/553111-MLA20482692355_112015-I.jpg",
"secure_thumbnail": "https://mla-s2-p.mlstatic.com/553111-MLA20482692355_112015-I.jpg",
"pictures": [
{
"id": "553111-MLA20482692355_112015",
"url": "http://mla-s2-p.mlstatic.com/553111-MLA20482692355_112015-O.jpg",
"secure_url": "https://mla-s2-p.mlstatic.com/553111-MLA20482692355_112015-O.jpg",
"size": "320x320",
"max_size": "320x320",
"quality": ""
},
{
"id": "629425-MLA25446587248_032017",
"url": "http://mla-s2-p.mlstatic.com/629425-MLA25446587248_032017-O.jpg",
"secure_url": "https://mla-s2-p.mlstatic.com/629425-MLA25446587248_032017-O.jpg",
"size": "384x500",
"max_size": "922x1200",
"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": null,
"dimensions": null,
"tags": [],
"logistic_type": "not_specified"
},
"international_delivery_mode": "none",
"seller_address": {
"id": 265953311,
"comment": "",
"address_line": "Test Address 123",
"zip_code": "1414",
"city": {
"id": "",
"name": "Palermo"
},
"state": {
"id": "AR-C",
"name": "Capital Federal"
},
"country": {
"id": "AR",
"name": "Argentina"
},
"latitude": "",
"longitude": "",
"search_location": {
"neighborhood": {
"id": "TUxBQlBBTDI1MTVa",
"name": "Palermo"
},
"city": {
"id": "TUxBQ0NBUGZlZG1sYQ",
"name": "Capital Federal"
},
"state": {
"id": "TUxBUENBUGw3M2E1",
"name": "Capital Federal"
}
}
},
"seller_contact": null,
"location": {},
"geolocation": {
"latitude": "",
"longitude": ""
},
"coverage_areas": [],
"attributes": [
{
"id": "FAN_TYPE",
"name": "Tipo de Ventilador",
"value_id": "291719",
"value_name": "De Techo",
"attribute_group_id": "DFLT",
"attribute_group_name": "Otros"
},
{
"id": "HEIGHT_ADJUSTABLE",
"name": "Altura Regulable",
"value_id": "242084",
"value_name": "No",
"attribute_group_id": "DFLT",
"attribute_group_name": "Otros"
},
{
"id": "LATERAL_OSCILLATION",
"name": "Oscilación Lateral",
"value_id": "242084",
"value_name": "No",
"attribute_group_id": "DFLT",
"attribute_group_name": "Otros"
},
{
"id": "REMOTE_CONTROL",
"name": "Control Remoto",
"value_id": "242084",
"value_name": "No",
"attribute_group_id": "DFLT",
"attribute_group_name": "Otros"
},
{
"id": "WITH_LIGHT",
"name": "Con Luz",
"value_id": "242084",
"value_name": "No",
"attribute_group_id": "DFLT",
"attribute_group_name": "Otros"
},
{
"id": "BRAND",
"name": "Marca",
"value_id": "86416",
"value_name": "Eiffel",
"attribute_group_id": "MAIN",
"attribute_group_name": "Atributos Principales"
}
],
"warnings": [],
"listing_source": "",
"variations": [
{
"id": 15092589430,
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "52005",
"value_name": "Marrón"
},
{
"id": "VOLTAGE",
"name": "Voltaje",
"value_id": "198812",
"value_name": "110V/220V (Bivolt)"
}
],
"price": 100,
"available_quantity": 4,
"sold_quantity": 0,
"picture_ids": [
"553111-MLA20482692355_112015",
"629425-MLA25446587248_032017"
],
"seller_custom_field": null,
"catalog_product_id": null,
"attributes": [
{
"id": "GTIN",
"name": "GTIN",
"value_id": null,
"value_name": "7792931000015"
},
{
"id": "EAN",
"name": "EAN",
"value_id": null,
"value_name": "7792931000015"
}
]
}
],
"status": "active",
"sub_status": [],
"tags": [
"poor_quality_picture",
"immediate_payment"
],
"catalog_product_id": null,
"domain_id": "MLA-FANS",
"seller_custom_field": null,
"parent_item_id": null,
"differential_pricing": null,
"deal_ids": [],
"automatic_relist": false,
"date_created": "2017-03-20T15:44:01.000Z",
"last_updated": "2017-03-29T14:55:54.337Z"
}You may also want to change the value of a typical attribute of each variation. Imagine that you want to change the value of the EAN attribute of a particular variation. To do so, you should make a PUT, as in the Example: below, specifying the variation that you want to change. You should send all the attributes in the attributes field and the changed value_name field for the EAN attribute.
Example:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' https://api.mercadolibre.com/global/items/MLA658778048 -d
{
"variations": [{
"id": "15092589430",
"attributes": [{
"id": "EAN",
"name": "EAN",
"value_name": "7792931000015"
},
{
"id": "UPC",
"name": "UPC",
"value_name": "7792931000015"
}
]
}]
}Response:
{
"id": "MLA658778048",
"site_id": "MLA",
"title": "Item De Testeo",
"subtitle": null,
"seller_id": 247212006,
"category_id": "MLA378496",
"official_store_id": null,
"price": 100,
"base_price": 100,
"original_price": null,
"currency_id": "ARS",
"initial_quantity": 4,
"available_quantity": 4,
"sold_quantity": 0,
"buying_mode": "buy_it_now",
"listing_type_id": "gold_special",
"start_time": "2017-03-20T15:44:00.000Z",
"stop_time": "2037-03-15T15:44:00.000Z",
"end_time": "2037-03-15T15:44:00.000Z",
"expiration_time": "2017-06-17T14:55:54.306Z",
"condition": "not_specified",
"permalink": "http://articulo.mercadolibre.com.ar/MLA-658778048-item-de-testeo-_JM",
"thumbnail": "http://mla-s2-p.mlstatic.com/553111-MLA20482692355_112015-I.jpg",
"secure_thumbnail": "https://mla-s2-p.mlstatic.com/553111-MLA20482692355_112015-I.jpg",
"pictures": [
{
"id": "553111-MLA20482692355_112015",
"url": "http://mla-s2-p.mlstatic.com/553111-MLA20482692355_112015-O.jpg",
"secure_url": "https://mla-s2-p.mlstatic.com/553111-MLA20482692355_112015-O.jpg",
"size": "320x320",
"max_size": "320x320",
"quality": ""
},
{
"id": "629425-MLA25446587248_032017",
"url": "http://mla-s2-p.mlstatic.com/629425-MLA25446587248_032017-O.jpg",
"secure_url": "https://mla-s2-p.mlstatic.com/629425-MLA25446587248_032017-O.jpg",
"size": "384x500",
"max_size": "922x1200",
"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": null,
"dimensions": null,
"tags": [],
"logistic_type": "not_specified"
},
"international_delivery_mode": "none",
"seller_address": {
"id": 265953311,
"comment": "",
"address_line": "Test Address 123",
"zip_code": "1414",
"city": {
"id": "",
"name": "Palermo"
},
"state": {
"id": "AR-C",
"name": "Capital Federal"
},
"country": {
"id": "AR",
"name": "Argentina"
},
"latitude": "",
"longitude": "",
"search_location": {
"neighborhood": {
"id": "TUxBQlBBTDI1MTVa",
"name": "Palermo"
},
"city": {
"id": "TUxBQ0NBUGZlZG1sYQ",
"name": "Capital Federal"
},
"state": {
"id": "TUxBUENBUGw3M2E1",
"name": "Capital Federal"
}
}
},
"seller_contact": null,
"location": {},
"geolocation": {
"latitude": "",
"longitude": ""
},
"coverage_areas": [],
"attributes": [
{
"id": "FAN_TYPE",
"name": "Tipo de Ventilador",
"value_id": "291719",
"value_name": "De Techo",
"attribute_group_id": "DFLT",
"attribute_group_name": "Otros"
},
{
"id": "HEIGHT_ADJUSTABLE",
"name": "Altura Regulable",
"value_id": "242084",
"value_name": "No",
"attribute_group_id": "DFLT",
"attribute_group_name": "Otros"
},
{
"id": "LATERAL_OSCILLATION",
"name": "Oscilación Lateral",
"value_id": "242084",
"value_name": "No",
"attribute_group_id": "DFLT",
"attribute_group_name": "Otros"
},
{
"id": "REMOTE_CONTROL",
"name": "Control Remoto",
"value_id": "242084",
"value_name": "No",
"attribute_group_id": "DFLT",
"attribute_group_name": "Otros"
},
{
"id": "WITH_LIGHT",
"name": "Con Luz",
"value_id": "242084",
"value_name": "No",
"attribute_group_id": "DFLT",
"attribute_group_name": "Otros"
},
{
"id": "BRAND",
"name": "Marca",
"value_id": "86416",
"value_name": "Eiffel",
"attribute_group_id": "MAIN",
"attribute_group_name": "Atributos Principales"
}
],
"warnings": [],
"listing_source": "",
"variations": [
{
"id": 15092589430,
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "52005",
"value_name": "Marrón"
},
{
"id": "VOLTAGE",
"name": "Voltaje",
"value_id": "198812",
"value_name": "110V/220V (Bivolt)"
}
],
"price": 100,
"available_quantity": 4,
"sold_quantity": 0,
"picture_ids": [
"553111-MLA20482692355_112015",
"629425-MLA25446587248_032017"
],
"seller_custom_field": null,
"catalog_product_id": null,
"attributes": [
{
"id": "EAN",
"name": "EAN",
"value_id": null,
"value_name": "7792931000015"
},
{
"id": "UPC",
"name": "UPC",
"value_id": null,
"value_name": "7792931000015"
}
]
}
],
"status": "active",
"sub_status": [],
"tags": [
"poor_quality_picture",
"immediate_payment"
],
"catalog_product_id": null,
"domain_id": "MLA-FANS",
"seller_custom_field": null,
"parent_item_id": null,
"differential_pricing": null,
"deal_ids": [],
"automatic_relist": false,
"date_created": "2017-03-20T15:44:01.000Z",
"last_updated": "2017-03-29T14:55:54.337Z"
}
Change price
If you want to change the price of an item with variations, you should make a PUT sending the same price in all the IDs for the variations. Keep in mind that if you send different prices you will receive an error in the response and the information will not be updated and if you don’t send all the IDs of the variations, those that haven’t been sent when making the PUT will be deleted from the item.
Example:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' https://api.mercadolibre.com/items/MLA658778048 -d
{
"variations": [
{
"id": 15092589430,
"price": 300
},
{
"id": 15092544559,
"price": 300
},
{
"id": 15091378470,
"price": 300
}
],
}
Change stock
As with price changes, you just have to make a PUT to the item API, including the variations property, listing each of them with their relevant id, and the new available_quantity for those variations which stock you want to change.
Example:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' https://api.mercadolibre.com/global/items/CBT1071862906 -d
{
"variations": [
{
"id": 15092589430,
"available_quantity": 10
}
],
}Response:
{
"id": "CBT1071862906",
"site_id": "CBT",
"title": "Test Item 2- Do Not Bit Game Mini Consola",
"subtitle": null,
"seller_id": 757729744,
"category_id": "CBT438566",
"official_store_id": null,
"price": 464,
"base_price": 464,
"original_price": null,
"inventory_id": null,
"currency_id": "USD",
"initial_quantity": 176,
"available_quantity": 176,
"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
}
]
}
],
"buying_mode": "buy_it_now",
"listing_type_id": "gold_pro",
"start_time": "2021-08-02T17:38:02.000Z",
"historical_start_time": "2021-08-02T17:38:02.000Z",
"stop_time": "2041-07-28T04:00:00.000Z",
"end_time": "2041-07-28T04:00:00.000Z",
"expiration_time": "2021-10-29T16:54:40.000Z",
"condition": "new",
"permalink": "",
"thumbnail_id": "642343-MLM43870348711_102020",
"thumbnail": "http://http2.mlstatic.com/D_642343-MLM43870348711_102020-I.jpg",
"secure_thumbnail": "https://http2.mlstatic.com/D_642343-MLM43870348711_102020-I.jpg",
"pictures": [
{...},
{
"id": "863167-MLM44413429949_122020",
"url": "http://http2.mlstatic.com/D_863167-MLM44413429949_122020-O.jpg",
"secure_url": "https://http2.mlstatic.com/D_863167-MLM44413429949_122020-O.jpg",
"size": "500x500",
"max_size": "",
"quality": ""
}
],
"video_id": null,
"descriptions": [],
"accepts_mercadopago": true,
"non_mercado_pago_payment_methods": [],
"shipping": {
"mode": "not_specified",
"methods": [],
"tags": [],
"dimensions": null,
"local_pick_up": false,
"free_shipping": false,
"logistic_type": "not_specified",
"store_pick_up": false
},
"international_delivery_mode": "none",
"seller_address": {
"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"
},
"id": 1171646718
},
"seller_contact": null,
"location": {},
"coverage_areas": [],
"attributes": [
{
"id": "BATTERY_CAPACITY",
"name": "Battery capacity",
"value_id": "133511",
"value_name": "1000 mAh",
"value_struct": {
"number": 1000,
"unit": "mAh"
},
"values": [
{
"id": "133511",
"name": "1000 mAh",
"struct": {
"number": 1000,
"unit": "mAh"
},
"source": 1878736620453906
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others",
"source": 1878736620453906
},
{
"id": "BATTERY_TYPE",
"name": "Battery type",
"value_id": "95013",
"value_name": "Lithium-ion",
"value_struct": null,
"values": [...],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others",
"source": 1878736620453906
},
{
"id": "BRAND",
"name": "Brand",
"value_id": "10570283",
"value_name": "SUP",
"value_struct": null,
"values": [
{...}
],
{...},
{
"id": "CAPACITY",
"name": "Capacity",
"value_id": null,
"value_name": "4 GB",
"value_struct": {
"number": 4,
"unit": "GB"
},
"values": [...],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others",
"source": 1878736620453906
},
{...},
"values": [...],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others",
"source": 1878736620453906
},
{
"id": "EDITION",
"name": "Edition",
"value_id": "7779125",
"value_name": "Standard",
"value_struct": null,
"values": [
{
"id": "7779125",
"name": "Standard",
"struct": null,
"source": 1878736620453906
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others",
"source": 1878736620453906
},
{
"id": "INCLUDED_GAMES_NUMBER",
"name": "Included games number",
"value_id": null,
"value_name": "400",
"value_struct": null,
"values": [
{...}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Others",
"source": 1878736620453906
},
{...},
],
"warnings": [],
"listing_source": "",
"variations": [
{
"id": 92906221167,
"price": 464.00,
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "51993",
"value_name": "Red",
"value_struct": null,
"values": [
{...}
],
"source": 1878736620453906
}
],
"available_quantity": 114,
"sold_quantity": 0,
"sale_terms": [],
"picture_ids": [...],
"seller_custom_field": null,
"catalog_product_id": null,
"attributes": [
{...},
"values": [
{...},
"source": 1878736620453906
}
],
"source": 1878736620453906
},
{...},
"values": [
{...},
"source": 1878736620453906
}
],
"source": 1878736620453906
},
{...},
"values": [
{...},
"source": 1878736620453906
}
],
"source": 1878736620453906
},
{...},
{
"id": "GTIN",
"name": "Universal product code",
"value_id": null,
"value_name": "788417836312",
"value_struct": null,
"values": [
{...}
],
"source": 1878736620453906
}
],
"inventory_id": null,
"item_relations": []
},
{
"id": 92906221186,
"price": 464.00,
"attribute_combinations": [...],
"source": 1878736620453906
}
],
"available_quantity": 0,
"sold_quantity": 0,
"sale_terms": [],
"picture_ids": [...],
"seller_custom_field": null,
"catalog_product_id": null,
"attributes": [...],
"source": 1878736620453906
},
{..},
"values": [
{...},
"source": 1878736620453906
}
],
"source": 1878736620453906
},
{...},
"values": [
{
"id": null,
"name": "16 cm",
"struct": {
"number": 16,
"unit": "cm"
},
"source": 1878736620453906
}
],
"source": 1878736620453906
},
{...},
"values": [
{
"id": null,
"name": "0.278 kg",
"struct": {
"number": 0.278,
"unit": "kg"
},
"source": 1878736620453906
}
],
"source": 1878736620453906
},
{...},
"values": [
{
"id": null,
"name": "11 cm",
"struct": {
"number": 11,
"unit": "cm"
},
"source": 1878736620453906
}
],
"source": 1878736620453906
},
{
"id": "SELLER_SKU",
"name": "SKU",
"value_id": null,
"value_name": "M3blue",
"value_struct": null,
"values": [
{...}
],
"source": 1878736620453906
},
{
"id": "GTIN",
"name": "Universal product code",
"value_id": null,
"value_name": "788417836312",
"value_struct": null,
"values": [
{...}
],
"source": 1878736620453906
}
],
"inventory_id": null,
"item_relations": []
},
{
"id": 92906221202,
"price": 464.00,
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "52021",
"value_name": "Heavenly",
"value_struct": null,
"values": [
{...}
],
"source": 1878736620453906
}
],
"available_quantity": 62,
"sold_quantity": 0,
"sale_terms": [],
"picture_ids": [...],
"seller_custom_field": null,
"catalog_product_id": null,
"attributes": [
{
"id": "MAIN_COLOR",
"name": "Main color",
"value_id": "2450278",
"value_name": "Heavenly",
"value_struct": null,
"values": [
{...}
],
"source": 1878736620453906
},
{
"id": "PACKAGE_HEIGHT",
"name": "Package height",
"value_id": null,
"value_name": "278 cm",
"value_struct": {
"number": 278,
"unit": "cm"
},
"values": [
{...},
"source": 1878736620453906
}
],
"source": 1878736620453906
},
{...},
"values": [
{...},
"source": 1878736620453906
}
],
"source": 1878736620453906
},
{...},
"values": [
{
"id": null,
"name": "0.278 kg",
"struct": {
"number": 0.278,
"unit": "kg"
},
"source": 1878736620453906
}
],
"source": 1878736620453906
},
{...},
"values": [
{
"id": null,
"name": "5 cm",
"struct": {
"number": 5,
"unit": "cm"
},
"source": 1878736620453906
}
],
"source": 1878736620453906
},
{
"id": "SELLER_SKU",
"name": "SKU",
"value_id": null,
"value_name": "M3Heavenly",
"value_struct": null,
"values": [
{...}
],
"source": 1878736620453906
},
{
"id": "GTIN",
"name": "Universal product code",
"value_id": null,
"value_name": "788417836312",
"value_struct": null,
"values": [
{...}
],
"source": 1878736620453906
}
],
"inventory_id": null,
"item_relations": []
},
{
"id": 92906221216,
"price": 464.00,
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "52055",
"value_name": "White",
"value_struct": null,
"values": [
{...}
],
"source": 757729744
}
],
"available_quantity": 0,
"sold_quantity": 0,
"sale_terms": [],
"picture_ids": [...],
"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": [
{...}
],
"source": 1878736620453906
},
{
"id": "PACKAGE_HEIGHT",
"name": "Package height",
"value_id": null,
"value_name": "278 cm",
"value_struct": {
"number": 278,
"unit": "cm"
},
"values": [
{
"id": null,
"name": "278 cm",
"struct": {
"number": 278,
"unit": "cm"
},
"source": 1878736620453906
}
],
"source": 1878736620453906
},
{...},
"inventory_id": null,
"item_relations": []
},
{
"id": 93474756023,
"price": 464.00,
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": null,
"value_name": "savage violet",
"value_struct": null,
"values": [
{...}
],
"source": 4428142924625477
}
],
"available_quantity": 0,
"sold_quantity": 0,
"sale_terms": [],
"picture_ids": [...],
"seller_custom_field": null,
"catalog_product_id": null,
"attributes": [...],
"source": 4428142924625477
},
{
"id": "SELLER_SKU",
"name": "SKU",
"value_id": null,
"value_name": "M3Black",
"value_struct": null,
"values": [...],
"source": 4428142924625477
},
{
"id": "GTIN",
"name": "Universal product code",
"value_id": null,
"value_name": "7790894898519",
"value_struct": null,
"values": [...],
"source": 4428142924625477
}
],
"inventory_id": null,
"item_relations": []
},
{
"id": 93690668944,
"price": 464.00,
"attribute_combinations": [...],
"source": 4428142924625477
}
],
"available_quantity": 0,
"sold_quantity": 0,
"sale_terms": [],
"picture_ids": [...],
"seller_custom_field": null,
"catalog_product_id": null,
"attributes": [...],
"source": 4428142924625477
},
{...}
],
"source": 4428142924625477
},
{...}
],
"inventory_id": null,
"item_relations": []
},
{...}
],
"available_quantity": 0,
"sold_quantity": 0,
"sale_terms": [],
"picture_ids": [...],
"seller_custom_field": null,
"catalog_product_id": null,
"attributes": [...],
"source": 4428142924625477
},
{...},
{...}
],
"status": "active",
"sub_status": [],
"tags": [
"good_quality_picture",
"test_item",
"immediate_payment"
],
"warranty": "No warranty",
"catalog_product_id": null,
"domain_id": "CBT-GAME_CONSOLES",
"seller_custom_field": null,
"parent_item_id": null,
"differential_pricing": null,
"deal_ids": [],
"automatic_relist": false,
"date_created": "2021-08-02T17:38:06.000Z",
"last_updated": "2021-08-27T16:30:30.055Z",
"fee": 0,
"client_id": 1878736620453906,
"sale_fee": 0,
"total_listing_fee": null,
"health": 1,
"catalog_listing": false,
"item_relations": [],
"channels": [
"marketplace"
],
"bundle": null
}Working with images in variations
To view the different images of each variation, take into account that the determinant attribute is that with tag defines_picture: true. All the variations that share the same value in the attribute with tag define_picture should ALWAYS have the same images.
Example:
- red/32 and red/28 should have the same images.
- red/32 and green/32 should have different images.
That is:
- All the variations that share the same value in the attribute with tag “defines_picture” should have the same images.
- All the variations with a different value in the attribute with tag “defines_picture” should have different images.
- All the variations should have an associated image.
- Based on the above, you will also be able to have thumbnails properly displayed.
Modify images
If you want to add a picture to an existing variation, you should send its URL or picture_id, if the picture is already uploaded, both in the item’s general picture list and in the variation picture list. Meanwhile, as the update will be done over the items resource, you should send the IDs of every existing variation in the Json. Otherwise, the API will understand that you do not want to keep them in the listing.
Example:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' https://api.mercadolibre.com/global/items/CBT1077755714 -d
{
"pictures": [{
"source": "http://www.apertura.com/export/sites/revistaap/img/Tecnologia/Logo_ML_NUEVO.jpg_33442984.jpg"
},
{
"source": "http://static.ellahoy.es/ellahoy/fotogallery/1200X0/371265/falda-plisada-rosa.jpg"
},
{
"id": "553111-MLA20482692355_112015"
},
{
"id": "629425-MLA25446587248_032017"
}
],
"variations": [{
"id": 18200178910,
"picture_ids": [
"http://static.ellahoy.es/ellahoy/fotogallery/1200X0/371265/falda-plisada-rosa.jpg",
"553111-MLA20482692355_112015"
]
},
{
"id": 18200178913,
"picture_ids": [
"http://www.apertura.com/export/sites/revistaap/img/Tecnologia/Logo_ML_NUEVO.jpg_33442984.jpg",
"629425-MLA25446587248_032017"
]
}
]
}Response:
{
"id": "MLA689372871",
"site_id": "MLA",
"title": "Test Item - No Ofertar",
"subtitle": null,
"seller_id": 235461680,
"category_id": "MLA374515",
"official_store_id": null,
"price": 200,
"base_price": 200,
"original_price": null,
"currency_id": "ARS",
"initial_quantity": 2,
"available_quantity": 2,
"sold_quantity": 0,
"sale_terms": [],
"buying_mode": "buy_it_now",
"listing_type_id": "gold_special",
"start_time": "2017-10-26T13:03:44.000Z",
"historical_start_time": "2017-10-26T13:03:44.000Z",
"stop_time": "2037-10-21T13:03:44.000Z",
"end_time": "2037-10-21T13:03:44.000Z",
"expiration_time": "2018-01-14T16:32:57.725Z",
"condition": "new",
"permalink": "http://articulo.mercadolibre.com.ar/MLA-689372871-test-item-no-ofertar-_JM",
"thumbnail": "http://mla-s1-p.mlstatic.com/942947-MLA26244780225_102017-I.jpg",
"secure_thumbnail": "https://mla-s1-p.mlstatic.com/942947-MLA26244780225_102017-I.jpg",
"pictures": [
{
"id": "942947-MLA26244780225_102017",
"url": "http://mla-s1-p.mlstatic.com/942947-MLA26244780225_102017-O.jpg",
"secure_url": "https://mla-s1-p.mlstatic.com/942947-MLA26244780225_102017-O.jpg",
"size": "500x228",
"max_size": "625x285",
"quality": ""
},
{
"id": "837548-MLA26244864461_102017",
"url": "http://www.mercadolibre.com/jm/img?s=STC&v=O&f=proccesing_image_es.jpg",
"secure_url": "https://www.mercadolibre.com/jm/img?s=STC&v=O&f=proccesing_image_es.jpg",
"size": "500x500",
"max_size": "500x500",
"quality": ""
},
{
"id": "553111-MLA20482692355_112015",
"url": "http://mla-s2-p.mlstatic.com/553111-MLA20482692355_112015-O.jpg",
"secure_url": "https://mla-s2-p.mlstatic.com/553111-MLA20482692355_112015-O.jpg",
"size": "320x320",
"max_size": "320x320",
"quality": ""
},
{
"id": "629425-MLA25446587248_032017",
"url": "http://mla-s2-p.mlstatic.com/629425-MLA25446587248_032017-O.jpg",
"secure_url": "https://mla-s2-p.mlstatic.com/629425-MLA25446587248_032017-O.jpg",
"size": "384x500",
"max_size": "922x1200",
"quality": ""
}
],
"video_id": null,
"descriptions": [
{
"id": "MLA689372871-1476963486"
}
],
"accepts_mercadopago": true,
"non_mercado_pago_payment_methods": [],
"shipping": {
"mode": "not_specified",
"local_pick_up": false,
"free_shipping": false,
"methods": [],
"dimensions": null,
"tags": [
"me2_available"
],
"logistic_type": "not_specified",
"store_pick_up": false
},
"international_delivery_mode": "none",
"seller_address": {
"id": 206175834,
"comment": "",
"address_line": "sssss 111",
"zip_code": "5000",
"city": {
"id": "",
"name": "Cordoba"
},
"state": {
"id": "AR-X",
"name": "Córdoba"
},
"country": {
"id": "AR",
"name": "Argentina"
},
"latitude": -32.8224655,
"longitude": -63.8666332,
"search_location": {
"neighborhood": {
"id": "",
"name": ""
},
"city": {
"id": "TUxBQ0NBUGNiZGQx",
"name": "Córdoba"
},
"state": {
"id": "TUxBUENPUmFkZGIw",
"name": "Córdoba"
}
}
},
"seller_contact": null,
"location": {},
"geolocation": {
"latitude": -32.8224655,
"longitude": -63.8666332
},
"coverage_areas": [],
"attributes": [
{
"id": "GENDER",
"name": "Género",
"value_id": "female",
"value_name": "Mujer",
"value_struct": null,
"attribute_group_id": "DFLT",
"attribute_group_name": "Otros"
},
{
"id": "Season",
"name": "Season",
"value_id": "Season-All-Season",
"value_name": "All-Season",
"value_struct": null,
"attribute_group_id": "DFLT",
"attribute_group_name": "Otros"
}
],
"warnings": [],
"listing_source": "",
"variations": [
{
"id": 18200178910,
"attribute_combinations": [
{
"id": "83000",
"name": "Color Primario",
"value_id": "92028",
"value_name": "Blanco",
"value_struct": null
},
{
"id": "93000",
"name": "Talle",
"value_id": "101994",
"value_name": "S",
"value_struct": null
}
],
"price": 200,
"available_quantity": 1,
"sold_quantity": 0,
"sale_terms": [],
"picture_ids": [
"837548-MLA26244864461_102017",
"553111-MLA20482692355_112015"
],
"seller_custom_field": null,
"catalog_product_id": null,
"attributes": []
},
{
"id": 18200178913,
"attribute_combinations": [
{
"id": "83000",
"name": "Color Primario",
"value_id": "91994",
"value_name": "Rosa",
"value_struct": null
},
{
"id": "93000",
"name": "Talle",
"value_id": "101995",
"value_name": "M",
"value_struct": null
}
],
"price": 200,
"available_quantity": 1,
"sold_quantity": 0,
"sale_terms": [],
"picture_ids": [
"942947-MLA26244780225_102017",
"629425-MLA25446587248_032017"
],
"seller_custom_field": null,
"catalog_product_id": null,
"attributes": []
}
],
"status": "active",
"sub_status": [],
"tags": [
"test_item",
"only_html_description",
"good_quality_thumbnail",
"unknown_quality_picture",
"immediate_payment"
],
"catalog_product_id": null,
"domain_id": null,
"seller_custom_field": null,
"parent_item_id": null,
"differential_pricing": null,
"deal_ids": [],
"automatic_relist": false,
"date_created": "2017-10-26T13:03:44.000Z",
"last_updated": "2017-10-26T16:32:57.945Z",
"total_listing_fee": null
}
Delete variations
If you want to delete a variation, you can do so as shown in the example:
Example:
curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA599099879/variations/10449631060Response
{
"id": "MLA658778048",
"site_id": "MLA",
"title": "Item De Testeo",
"subtitle": null,
"seller_id": 247212006,
"category_id": "MLA378496",
"official_store_id": null,
"price": 300,
"base_price": 300,
"original_price": null,
"currency_id": "ARS",
"initial_quantity": 8,
"available_quantity": 8,
"sold_quantity": 0,
"buying_mode": "buy_it_now",
"listing_type_id": "gold_special",
"start_time": "2017-03-20T15:44:00.000Z",
"stop_time": "2037-03-15T15:44:00.000Z",
"end_time": "2037-03-15T15:44:00.000Z",
"expiration_time": "2017-06-17T15:03:02.000Z",
"condition": "not_specified",
"permalink": "http://articulo.mercadolibre.com.ar/MLA-658778048-item-de-testeo-_JM",
"thumbnail": "http://mla-s2-p.mlstatic.com/553111-MLA20482692355_112015-I.jpg",
"secure_thumbnail": "https://mla-s2-p.mlstatic.com/553111-MLA20482692355_112015-I.jpg",
"pictures": [
{
"id": "553111-MLA20482692355_112015",
"url": "http://mla-s2-p.mlstatic.com/553111-MLA20482692355_112015-O.jpg",
"secure_url": "https://mla-s2-p.mlstatic.com/553111-MLA20482692355_112015-O.jpg",
"size": "320x320",
"max_size": "320x320",
"quality": ""
},
{
"id": "629425-MLA25446587248_032017",
"url": "http://mla-s2-p.mlstatic.com/629425-MLA25446587248_032017-O.jpg",
"secure_url": "https://mla-s2-p.mlstatic.com/629425-MLA25446587248_032017-O.jpg",
"size": "384x500",
"max_size": "922x1200",
"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": null,
"dimensions": null,
"tags": [],
"logistic_type": "not_specified"
},
"international_delivery_mode": "none",
"seller_address": {
"id": 265953311,
"comment": "",
"address_line": "Test Address 123",
"zip_code": "1414",
"city": {
"id": "",
"name": "Palermo"
},
"state": {
"id": "AR-C",
"name": "Capital Federal"
},
"country": {
"id": "AR",
"name": "Argentina"
},
"latitude": "",
"longitude": "",
"search_location": {
"neighborhood": {
"id": "TUxBQlBBTDI1MTVa",
"name": "Palermo"
},
"city": {
"id": "TUxBQ0NBUGZlZG1sYQ",
"name": "Capital Federal"
},
"state": {
"id": "TUxBUENBUGw3M2E1",
"name": "Capital Federal"
}
}
},
"seller_contact": null,
"location": {},
"geolocation": {
"latitude": "",
"longitude": ""
},
"coverage_areas": [],
"attributes": [
{
"id": "FAN_TYPE",
"name": "Tipo de Ventilador",
"value_id": "291719",
"value_name": "De Techo",
"attribute_group_id": "DFLT",
"attribute_group_name": "Otros"
},
{
"id": "HEIGHT_ADJUSTABLE",
"name": "Altura Regulable",
"value_id": "242084",
"value_name": "No",
"attribute_group_id": "DFLT",
"attribute_group_name": "Otros"
},
{
"id": "LATERAL_OSCILLATION",
"name": "Oscilación Lateral",
"value_id": "242084",
"value_name": "No",
"attribute_group_id": "DFLT",
"attribute_group_name": "Otros"
},
{
"id": "REMOTE_CONTROL",
"name": "Control Remoto",
"value_id": "242084",
"value_name": "No",
"attribute_group_id": "DFLT",
"attribute_group_name": "Otros"
},
{
"id": "WITH_LIGHT",
"name": "Con Luz",
"value_id": "242084",
"value_name": "No",
"attribute_group_id": "DFLT",
"attribute_group_name": "Otros"
},
{
"id": "BRAND",
"name": "Marca",
"value_id": "86416",
"value_name": "Eiffel",
"attribute_group_id": "MAIN",
"attribute_group_name": "Atributos Principales"
}
],
"warnings": [],
"listing_source": "",
"variations": [
{
"id": 15092589430,
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "52005",
"value_name": "Marrón"
},
{
"id": "VOLTAGE",
"name": "Voltaje",
"value_id": "198812",
"value_name": "110V/220V (Bivolt)"
}
],
"price": 300,
"available_quantity": 8,
"sold_quantity": 0,
"picture_ids": [
"629425-MLA25446587248_032017"
],
"seller_custom_field": null,
"catalog_product_id": null,
"attributes": [
{
"id": "EAN",
"name": "EAN",
"value_id": null,
"value_name": "7792931000015"
},
{
"id": "UPC",
"name": "UPC",
"value_id": null,
"value_name": "7792931000015"
}
]
}
],
"status": "active",
"sub_status": [],
"tags": [
"poor_quality_picture",
"immediate_payment"
],
"catalog_product_id": null,
"domain_id": "MLA-FANS",
"seller_custom_field": null,
"parent_item_id": null,
"differential_pricing": null,
"deal_ids": [],
"automatic_relist": false,
"date_created": "2017-03-20T15:44:01.000Z",
"last_updated": "2017-03-29T15:04:20.999Z"
}As you can see, we eliminate the variation 10449631060 and we keep the variations 10449631063 and 10449631067. Another way to eliminate variations is sending a PUT to the items API with the variations property, listing only the Ids of the variations that we wish to keep.
Example:
curl -X DELETE -H 'Content-Type: application/json' https://api.mercadolibre.com/items/MLA658778048/variations/15092589430Next: List products.