Documentation Mercado Libre

Check out all the necessary information about APIs Mercado Libre.
circulos azuis em degrade

Documentation

Last update 31/08/2023

Variations

Importante:
As of December 14, 2022, the maximum number of variations allowed (max_variations_allowed) per category to 100.

This guide will explain what to do if, for example, you have to list the same shoe model, but in different colors and sizes. Variations will help you describe all item variations in the same listing, also keeping a differential stock for each of them. This way, when your receive a purchase, the purchase order will show the color and size chosen by the buyer for a smooth post-sale process. Good news! Variations are not applicable to apparel only: you can also use them in other categories. For example, in electric drills, changing items for voltage. Therefore, you will be able to sell 110V- and 220V-drills in the same listing.

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.

Note:
- To learn about mandatory variation attributes, look for those with tags required = true. A category with allow variation but without attributes with this tag means that you can create items without variations.
- The VIP does not currently, but will in the future, show attributes with the variation_attribute tag. We encourage you to complete them in order to get ready for the new functionality involving these attributes!
Imagine that you want to sell a fan with Brown and Black color variations, but you also want to upload the bar code (EAN). To do that, go to the attribute API of that category and check if the attributes Color and EAN have the allow_variations and variation_attribute tags, respectively.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/$CATEGORY_ID/attributes

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/CBT1055/attributes

Response:

[
  {
      "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![Universal product code](https://http2.mlstatic.com/static/org-img/sd-landings/assets/pi-tooltip.png)",
      "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": []
}
Notes:
- There are mandatory properties that should be sent in each variation. These are: price, available_quantity, pictures and attribute_combinations.
- The maximum number of images that can be sent per variation is defined by the field max_pictures_per_item_var in the Categories API.
- attribute_combinations of all variations should include the same attributes, but with no repetition of value combinations.
- If an attribute that does not belong to the category is sent, it will be ignored, which can cause two variations yo have the same attributes and present duplicate variations.
- You can add an attribute with the allow_variations tag in the item's attributes property.
- You can add an attribute with the variation_attribute tag in the item's attributes property.

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.

Important:
If the required attribute is not sent, you will receive the following error as a response (400 item.attributes.missing_required - Do not send required attribute).
{
	"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."
	}]
}
Notes:
- In the event that the attribute is not required, the required tag will not appear.
- You cannot eliminate attributes marked as required from an item.

 

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_ID

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA658778048?attributes=variations

Response:

{
    "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/variations

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/CBT926430395?variations

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,
    "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_ID

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/items/CBT926430395/variations/55621017072

Response:

{
    "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
                }
            ]
        }
    ]
}
Note:
To view the attributes property in each variation, you should add the include_attributes=all parameter to the query URL.

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/CBT910505150?include_attributes=all
Note:
In case you want to consult the section variations attributes, you should send the parameter "include_attributes=all" inside the request (https://api.mercadolibre.com/items/CBT926430395?include_attributes=all).

Add 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.

Note:
Remember to send the id of the other variations or they will be deleted.

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.

Note:
For the sales variations, you can only add new attributes without changing or eliminating the existing ones.

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"
     }
   ]
 }
]
Note:
Whenever you want to modify a variant, you must send the ID. In case you do not send it, the variant will be deleted and a new one will be created with the information included in the request, losing, this way, all the sales history, or generating an error if all the necessary fields for the creation of the same are not present.

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"
}
Notes:
If you do not want to keep the previous pictures, don’t send them in the Json and they will be automatically discarded.

 

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
}
Note:
If you do not want to keep the previous pictures, don’t send them in the Json and they will be automatically discarded.

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/10449631060

Response

{
    "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/15092589430

Next: List products.