Last update 28/12/2022

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,
    "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": "VERSION",
    "name": "Version",
    "tags": {
      "hidden": true
    },
    "hierarchy": "PARENT_PK",
    "relevance": 1,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "IS_DUAL_SIM",
    "name": "Is Dual SIM",
    "tags": {
      "required": true
    },
    "hierarchy": "PARENT_PK",
    "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": "COLOR",
    "name": "Color",
    "tags": {
      "allow_variations": true,
      "defines_picture": true,
      "required": 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": "INTERNAL_MEMORY",
    "name": "Internal memory",
    "tags": {
      "required": true
    },
    "hierarchy": "CHILD_PK",
    "relevance": 1,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "GB",
        "name": "GB"
      },
      {
        "id": "MB",
        "name": "MB"
      },
      {
        "id": "TB",
        "name": "TB"
      }
    ],
    "default_unit": "GB",
    "tooltip": "It is the storage capacity of the cellphone. How much information I can save without the need for external cards.",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "RAM",
    "name": "RAM memory",
    "tags": {
      "required": true
    },
    "hierarchy": "CHILD_PK",
    "relevance": 1,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "GB",
        "name": "GB"
      },
      {
        "id": "MB",
        "name": "MB"
      }
    ],
    "default_unit": "GB",
    "tooltip": "Manages open applications at once, the greater amount of memory the better performance having multiple applications open.",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others",
    "hint": "Usually goes from 1 to 8 gb"
  },
  {
    "id": "MAIN_COLOR",
    "name": "Main color",
    "tags": {
      "variation_attribute": true
    },
    "hierarchy": "CHILD_DEPENDENT",
    "relevance": 1,
    "type": "color",
    "value_type": "list",
    "values": [
      {
        "id": "2450295",
        "name": "Black",
        "metadata": {
          "rgb": "000000"
        }
      },
      {
        "id": "2450293",
        "name": "Blue",
        "metadata": {
          "rgb": "1717FF"
        }
      },
      {
        "id": "2450307",
        "name": "Red",
        "metadata": {
          "rgb": "FF0000"
        }
      },
      {
        "id": "2450311",
        "name": "Violet",
        "metadata": {
          "rgb": "9F00FF"
        }
      },
      {
        "id": "2450291",
        "name": "Brown",
        "metadata": {
          "rgb": "A0522D"
        }
      },
      {
        "id": "2450314",
        "name": "Green",
        "metadata": {
          "rgb": "0DA600"
        }
      },
      {
        "id": "2450327",
        "name": "Orange",
        "metadata": {
          "rgb": "FF8C00"
        }
      },
      {
        "id": "2450278",
        "name": "Heavenly",
        "metadata": {
          "rgb": "83DDFF"
        }
      },
      {
        "id": "2450312",
        "name": "Pink",
        "metadata": {
          "rgb": "FCB1BE"
        }
      },
      {
        "id": "2450289",
        "name": "Golden",
        "metadata": {
          "rgb": "FFD700"
        }
      },
      {
        "id": "2450296",
        "name": "Yellow",
        "metadata": {
          "rgb": "FFED00"
        }
      },
      {
        "id": "2450294",
        "name": "Grey",
        "metadata": {
          "rgb": "E1E1E1"
        }
      },
      {
        "id": "2450308",
        "name": "Blank",
        "metadata": {
          "rgb": "FFFFFF"
        }
      },
      {
        "id": "2450302",
        "name": "Blue steel",
        "metadata": {
          "rgb": "6FA8DC",
          "parent_id": "2450293"
        }
      },
      {
        "id": "2450298",
        "name": "Light blue",
        "metadata": {
          "rgb": "DCECFF",
          "parent_id": "2450293"
        }
      },
      {
        "id": "2450325",
        "name": "Navy blue",
        "metadata": {
          "rgb": "0F5299",
          "parent_id": "2450293"
        }
      },
      {
        "id": "2450306",
        "name": "Dark blue",
        "metadata": {
          "rgb": "013267",
          "parent_id": "2450293"
        }
      },
      {
        "id": "2450322",
        "name": "Maroon",
        "metadata": {
          "rgb": "830500",
          "parent_id": "2450307"
        }
      },
      {
        "id": "2450318",
        "name": "Coral",
        "metadata": {
          "rgb": "FA8072",
          "parent_id": "2450307"
        }
      },
      {
        "id": "2450313",
        "name": "Light coral",
        "metadata": {
          "rgb": "F9AC95",
          "parent_id": "2450307"
        }
      },
      {
        "id": "2450317",
        "name": "Terracotta",
        "metadata": {
          "rgb": "C63633",
          "parent_id": "2450307"
        }
      },
      {
        "id": "2450316",
        "name": "Lavender",
        "metadata": {
          "rgb": "D9D2E9",
          "parent_id": "2450311"
        }
      },
      {
        "id": "2450321",
        "name": "Lilac",
        "metadata": {
          "rgb": "CC87FF",
          "parent_id": "2450311"
        }
      },
      {
        "id": "2450290",
        "name": "Dark violet",
        "metadata": {
          "rgb": "4E0087",
          "parent_id": "2450311"
        }
      },
      {
        "id": "2450279",
        "name": "Indigo",
        "metadata": {
          "rgb": "7A64C6",
          "parent_id": "2450311"
        }
      },
      {
        "id": "2450281",
        "name": "Beige",
        "metadata": {
          "rgb": "F5F3DC",
          "parent_id": "2450291"
        }
      },
      {
        "id": "2450292",
        "name": "Light brown",
        "metadata": {
          "rgb": "AF8650",
          "parent_id": "2450291"
        }
      },
      {
        "id": "2450297",
        "name": "Dark brown",
        "metadata": {
          "rgb": "5D3806",
          "parent_id": "2450291"
        }
      },
      {
        "id": "2450287",
        "name": "Cleat",
        "metadata": {
          "rgb": "FAEBD7",
          "parent_id": "2450291"
        }
      },
      {
        "id": "2450319",
        "name": "Light green",
        "metadata": {
          "rgb": "9FF39F",
          "parent_id": "2450314"
        }
      },
      {
        "id": "2450305",
        "name": "Lemon green",
        "metadata": {
          "rgb": "73E129",
          "parent_id": "2450314"
        }
      },
      {
        "id": "2450310",
        "name": "Moss green",
        "metadata": {
          "rgb": "3F7600",
          "parent_id": "2450314"
        }
      },
      {
        "id": "2450324",
        "name": "Dark green",
        "metadata": {
          "rgb": "003D00",
          "parent_id": "2450314"
        }
      },
      {
        "id": "2450282",
        "name": "Chocolate",
        "metadata": {
          "rgb": "9B3F14",
          "parent_id": "2450327"
        }
      },
      {
        "id": "2450323",
        "name": "Light orange",
        "metadata": {
          "rgb": "FDAF20",
          "parent_id": "2450327"
        }
      },
      {
        "id": "2450328",
        "name": "Dark orange",
        "metadata": {
          "rgb": "D2691E",
          "parent_id": "2450327"
        }
      },
      {
        "id": "2450286",
        "name": "Fur",
        "metadata": {
          "rgb": "FFE4C4",
          "parent_id": "2450327"
        }
      },
      {
        "id": "2450283",
        "name": "Water",
        "metadata": {
          "rgb": "E0FFFF",
          "parent_id": "2450278"
        }
      },
      {
        "id": "2450288",
        "name": "Oil blue",
        "metadata": {
          "rgb": "1E6E7F",
          "parent_id": "2450278"
        }
      },
      {
        "id": "2450315",
        "name": "Cyan",
        "metadata": {
          "rgb": "00FFFF",
          "parent_id": "2450278"
        }
      },
      {
        "id": "2450320",
        "name": "Turquoise",
        "metadata": {
          "rgb": "40E0D0",
          "parent_id": "2450278"
        }
      },
      {
        "id": "2450326",
        "name": "Fuchsia",
        "metadata": {
          "rgb": "FF00EC",
          "parent_id": "2450312"
        }
      },
      {
        "id": "2450284",
        "name": "Pink gum",
        "metadata": {
          "rgb": "FF51A8",
          "parent_id": "2450312"
        }
      },
      {
        "id": "2450280",
        "name": "Light pink",
        "metadata": {
          "rgb": "FADBE2",
          "parent_id": "2450312"
        }
      },
      {
        "id": "2450285",
        "name": "Dark pink",
        "metadata": {
          "rgb": "D06EA8",
          "parent_id": "2450312"
        }
      },
      {
        "id": "2450301",
        "name": "Khaki",
        "metadata": {
          "rgb": "F0E68C",
          "parent_id": "2450296"
        }
      },
      {
        "id": "2450300",
        "name": "Cream",
        "metadata": {
          "rgb": "FFFFE0",
          "parent_id": "2450296"
        }
      },
      {
        "id": "2450309",
        "name": "Dark gold",
        "metadata": {
          "rgb": "BF9000",
          "parent_id": "2450296"
        }
      },
      {
        "id": "2450304",
        "name": "Ochre",
        "metadata": {
          "rgb": "EACB53",
          "parent_id": "2450296"
        }
      },
      {
        "id": "2450299",
        "name": "Dark grey",
        "metadata": {
          "rgb": "666666",
          "parent_id": "2450294"
        }
      },
      {
        "id": "2450303",
        "name": "Silver",
        "metadata": {
          "rgb": "CBCFD0",
          "parent_id": "2450294"
        }
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "DETAILED_MODEL",
    "name": "Detailed model",
    "tags": {
      "hidden": true
    },
    "hierarchy": "CHILD_DEPENDENT",
    "relevance": 1,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "WITH_IMEI",
    "name": "With IMEI",
    "tags": {
      "fixed": true,
      "hidden": true
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "boolean",
    "values": [
      {
        "id": "242085",
        "name": "Yes"
      }
    ],
    "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. ![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": "CARRIER",
    "name": "Carrier",
    "tags": {
      "required": true
    },
    "hierarchy": "ITEM",
    "relevance": 1,
    "value_type": "list",
    "values": [
      {
        "id": "298335",
        "name": "Unlocked"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "WITH_ESIM",
    "name": "With eSIM",
    "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": "OPERATING_SYSTEM_NAME",
    "name": "Operating system name",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "OPERATING_SYSTEM_VERSION",
    "name": "Operating system version",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "OPERATING_SYSTEM_EDITION",
    "name": "Operating system edition",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "MANUFACTURER_OPERATING_SYSTEM_SHELL",
    "name": "Manufacturer operating system shell",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "RELEASE_YEAR",
    "name": "Release year",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "number",
    "value_max_length": 18,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "WEIGHT",
    "name": "Weight",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "g",
        "name": "g"
      },
      {
        "id": "kg",
        "name": "kg"
      },
      {
        "id": "mg",
        "name": "mg"
      }
    ],
    "default_unit": "g",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "HEIGHT",
    "name": "Height",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": """,
        "name": """
      },
      {
        "id": "cm",
        "name": "cm"
      },
      {
        "id": "mm",
        "name": "mm"
      }
    ],
    "default_unit": "mm",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "WIDTH",
    "name": "Width",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": """,
        "name": """
      },
      {
        "id": "cm",
        "name": "cm"
      },
      {
        "id": "mm",
        "name": "mm"
      }
    ],
    "default_unit": "mm",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "DEPTH",
    "name": "Depth",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": """,
        "name": """
      },
      {
        "id": "cm",
        "name": "cm"
      },
      {
        "id": "mm",
        "name": "mm"
      }
    ],
    "default_unit": "mm",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "WITH_TOUCH_SCREEN",
    "name": "With touch screen",
    "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": "DISPLAY_SIZE",
    "name": "Display size",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": """,
        "name": """
      },
      {
        "id": "cm",
        "name": "cm"
      },
      {
        "id": "mm",
        "name": "mm"
      }
    ],
    "default_unit": """,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "DISPLAY_RESOLUTION",
    "name": "Display resolution",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "PIXELS_PER_INCH",
    "name": "Pixels per inch",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "dpi",
        "name": "dpi"
      },
      {
        "id": "ppi",
        "name": "ppi"
      }
    ],
    "default_unit": "ppi",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "SCREEN_TECHNOLOGY",
    "name": "Screen technology",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "values": [
      {
        "id": "80490",
        "name": "IPS"
      },
      {
        "id": "80493",
        "name": "Super AMOLED"
      },
      {
        "id": "80489",
        "name": "TFT"
      },
      {
        "id": "95442",
        "name": "STN"
      },
      {
        "id": "80492",
        "name": "AMOLED"
      },
      {
        "id": "80491",
        "name": "OLED"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "MAX_BRIGHTNESS",
    "name": "Max brightness",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "cd/m²",
        "name": "cd/m²"
      }
    ],
    "default_unit": "cd/m²",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "WITH_CAMERA",
    "name": "With camera",
    "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": "REAR_CAMERAS_NUMBER",
    "name": "Rear cameras number",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "number",
    "value_max_length": 18,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "MAIN_REAR_CAMERA_RESOLUTION",
    "name": "Main rear camera resolution",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "px",
        "name": "px"
      },
      {
        "id": "Mpx",
        "name": "Mpx"
      }
    ],
    "default_unit": "Mpx",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "REAR_CAMERAS_RESOLUTION",
    "name": "Rear cameras resolution",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "REAR_CAMERA_RECORDING_RESOLUTION",
    "name": "Rear camera recording resolution",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "REAR_CAMERA_APERTURE",
    "name": "Rear camera aperture",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "FRONT_CAMERAS_NUMBER",
    "name": "Front cameras number",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "number",
    "value_max_length": 18,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "MAIN_FRONT_CAMERA_RESOLUTION",
    "name": "Main front camera resolution",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "px",
        "name": "px"
      },
      {
        "id": "Mpx",
        "name": "Mpx"
      }
    ],
    "default_unit": "Mpx",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "FRONT_CAMERAS_RESOLUTION",
    "name": "Front cameras resolution",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "FRONT_CAMERA_RECORDING_RESOLUTION",
    "name": "Front camera recording resolution",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "FRONT_CAMERA_APERTURE",
    "name": "Front camera aperture",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "WITH_FRONT_CAMERA_FLASH",
    "name": "With front camera flash",
    "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_SLOW_MOTION_CAMERA_FUNCTION",
    "name": "With slow motion camera function",
    "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": "OPTICAL_ZOOM",
    "name": "Optical zoom",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "x",
        "name": "x"
      }
    ],
    "default_unit": "x",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "DIGITAL_ZOOM",
    "name": "Digital zoom",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "x",
        "name": "x"
      }
    ],
    "default_unit": "x",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "MOBILE_NETWORK",
    "name": "Network",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "values": [
      {
        "id": "7472026",
        "name": "2G"
      },
      {
        "id": "367874",
        "name": "3G"
      },
      {
        "id": "367876",
        "name": "4G/LTE"
      },
      {
        "id": "7472027",
        "name": "5G"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "NUMBER_OF_SIM_CARD_SLOTS",
    "name": "SIM card slots number",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "number",
    "value_max_length": 18,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "SIM_SIZES",
    "name": "Compatible SIM card sizes",
    "tags": {
      "hidden": true,
      "multivalued": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "values": [
      {
        "id": "80451",
        "name": "Micro-SIM"
      },
      {
        "id": "80453",
        "name": "Nano-SIM"
      },
      {
        "id": "80452",
        "name": "Mini-SIM"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "MEMORY_CARD_TYPES",
    "name": "Memory card types",
    "tags": {
      "hidden": true,
      "multivalued": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "values": [
      {
        "id": "101379",
        "name": "Multimedia Card"
      },
      {
        "id": "101380",
        "name": "miniSD"
      },
      {
        "id": "101372",
        "name": "SD"
      },
      {
        "id": "101373",
        "name": "SDIO"
      },
      {
        "id": "101374",
        "name": "SDHC"
      },
      {
        "id": "101375",
        "name": "SDXC"
      },
      {
        "id": "7199655",
        "name": "microSD"
      },
      {
        "id": "101377",
        "name": "microSDXC"
      },
      {
        "id": "101378",
        "name": "microSDHC"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "MAX_MEMORY_CARD_CAPACITY",
    "name": "Max memory card capacity",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "GB",
        "name": "GB"
      },
      {
        "id": "MB",
        "name": "MB"
      },
      {
        "id": "TB",
        "name": "TB"
      }
    ],
    "default_unit": "GB",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "PROCESSOR_MODEL",
    "name": "Processor model",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "CPU_MODEL",
    "name": "CPU model",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "PROCESSOR_CORES_NUMBER",
    "name": "Processor cores number",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "number",
    "value_max_length": 18,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "PROCESSOR_SPEED",
    "name": "Processor speed",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "GHz",
        "name": "GHz"
      },
      {
        "id": "kHz",
        "name": "kHz"
      },
      {
        "id": "rpm",
        "name": "rpm"
      }
    ],
    "default_unit": "GHz",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "GPU_MODEL",
    "name": "GPU model",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "WITH_PHYSICAL_QWERTY_KEYBOARD",
    "name": "With physical QWERTY keyboard",
    "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_USB_CONNECTOR",
    "name": "With USB connector",
    "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_WIFI",
    "name": "With Wi-Fi",
    "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_GPS",
    "name": "With GPS",
    "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_BLUETOOTH",
    "name": "With Bluetooth",
    "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_MINI_HDMI",
    "name": "With mini HDMI",
    "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_RADIO",
    "name": "With radio",
    "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_TV_TUNER",
    "name": "With TV tuner",
    "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_FINGERPRINT_READER",
    "name": "With fingerprint reader",
    "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_FACIAL_RECOGNITION",
    "name": "With facial recognition",
    "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_ACCELEROMETER",
    "name": "With accelerometer",
    "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_PROXIMITY_SENSOR",
    "name": "With proximity sensor",
    "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_GYROSCOPE",
    "name": "With gyroscope",
    "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_SPLASH_RESISTANT",
    "name": "Is splash resistant",
    "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_WATER_RESISTANT",
    "name": "Is water resistant",
    "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_WATERPROOF",
    "name": "Is waterproof",
    "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": "BATTERY_TYPE",
    "name": "Battery type",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "values": [
      {
        "id": "95013",
        "name": "Lithium-ion"
      },
      {
        "id": "7573636",
        "name": "Lithium polymer"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "BATTERY_CAPACITY",
    "name": "Battery capacity",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "mAh",
        "name": "mAh"
      },
      {
        "id": "Ah",
        "name": "Ah"
      }
    ],
    "default_unit": "mAh",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "WITH_REMOVABLE_BATTERY",
    "name": "With removable battery",
    "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": "STANDBY_TIME",
    "name": "Standby time",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "h",
        "name": "h"
      },
      {
        "id": "m",
        "name": "m"
      }
    ],
    "default_unit": "h",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "TALK_TIME",
    "name": "Talk time",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "h",
        "name": "h"
      },
      {
        "id": "m",
        "name": "m"
      },
      {
        "id": "s",
        "name": "s"
      }
    ],
    "default_unit": "h",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Others"
  },
  {
    "id": "ORIGIN",
    "name": "Origin",
    "tags": {
      "hidden": true
    },
    "hierarchy": "FAMILY",
    "relevance": 2,
    "value_type": "string",
    "value_max_length": 255,
    "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": "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": "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": "km",
        "name": "km"
      },
      {
        "id": "ft",
        "name": "ft"
      },
      {
        "id": "pulgadas",
        "name": "pulgadas"
      },
      {
        "id": "m",
        "name": "m"
      },
      {
        "id": "mm",
        "name": "mm"
      },
      {
        "id": "µm",
        "name": "µm"
      },
      {
        "id": "hh",
        "name": "hh"
      },
      {
        "id": "U",
        "name": "U"
      },
      {
        "id": "nm",
        "name": "nm"
      },
      {
        "id": "in",
        "name": "in"
      },
      {
        "id": """,
        "name": """
      },
      {
        "id": "cm",
        "name": "cm"
      },
      {
        "id": "yd",
        "name": "yd"
      }
    ],
    "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": "mcg",
        "name": "mcg"
      },
      {
        "id": "oz",
        "name": "oz"
      },
      {
        "id": "g",
        "name": "g"
      },
      {
        "id": "t",
        "name": "t"
      },
      {
        "id": "kg",
        "name": "kg"
      },
      {
        "id": "mg",
        "name": "mg"
      },
      {
        "id": "lb",
        "name": "lb"
      }
    ],
    "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": "km",
        "name": "km"
      },
      {
        "id": "ft",
        "name": "ft"
      },
      {
        "id": "pulgadas",
        "name": "pulgadas"
      },
      {
        "id": "m",
        "name": "m"
      },
      {
        "id": "mm",
        "name": "mm"
      },
      {
        "id": "µm",
        "name": "µm"
      },
      {
        "id": "hh",
        "name": "hh"
      },
      {
        "id": "U",
        "name": "U"
      },
      {
        "id": "nm",
        "name": "nm"
      },
      {
        "id": "in",
        "name": "in"
      },
      {
        "id": """,
        "name": """
      },
      {
        "id": "cm",
        "name": "cm"
      },
      {
        "id": "yd",
        "name": "yd"
      }
    ],
    "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": "km",
        "name": "km"
      },
      {
        "id": "ft",
        "name": "ft"
      },
      {
        "id": "pulgadas",
        "name": "pulgadas"
      },
      {
        "id": "m",
        "name": "m"
      },
      {
        "id": "mm",
        "name": "mm"
      },
      {
        "id": "µm",
        "name": "µm"
      },
      {
        "id": "hh",
        "name": "hh"
      },
      {
        "id": "U",
        "name": "U"
      },
      {
        "id": "nm",
        "name": "nm"
      },
      {
        "id": "in",
        "name": "in"
      },
      {
        "id": """,
        "name": """
      },
      {
        "id": "cm",
        "name": "cm"
      },
      {
        "id": "yd",
        "name": "yd"
      }
    ],
    "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": "EXCLUSIVE_CHANNEL",
    "name": "Exclusive channel",
    "tags": {
      "hidden": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "7865258",
        "name": "Mercado Shops"
      },
      {
        "id": "7865259",
        "name": "Mercado Libre"
      },
      {
        "id": "7889418",
        "name": "Private"
      }
    ],
    "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.