List products

Now that you went through authentication, users and categories, we think you are ready to list your first listing. Follow this tutorial to learn how to do it.

Contents

→Basics
→Listing results
→Item details page
→Item fields
→Defining attributes
    ↳Title
    ↳Description
    ↳Condition
    ↳Available quantity
    ↳Pictures
    ↳Category
    ↳Purchase method
    ↳Price
    ↳Currency
    ↳Payment methods
    ↳Shipping
    ↳Product Identifiers
    ↳SKU
   
↳Variations
→Listing types
→An item condition
→Product warranty
→List an item
→Items with mandatory Mercado Pago
→List an item with immediate payment
→Categories with immediate payment
→List an Official Store item
→Select the channel where you want to offer products
→Error codes reference
→HTTP response code references


Basics

On MercadoLibre's API, listings are items that contains products and other attributes you can sell or buy. Users can’t exchange contact information right away on them, so every time there’s an intention of buying a product, potential buyers are able to make as many questions they want on the item and when they’re ready, they need to make an offer on the seller’s product, so an order is created for both seller and buyer detailing the transaction as a sale or a purchase for each one, and that’s when contact information is visible automatically between those users.


Listing results

Each item you list will appear in the listing results of a given product search. For example, when a user search for the query “ipod”, as a result he will get a list of all items related. Your item can be in that list. When someone clicks on an item, the item details page is displayed, showing all the information about the item that was provided at the time of listing, keep reading to know more about it.


Item details page

When a user chooses an item from the result, this page displays the following item details:

  • Item_id
  • Title
  • Category
  • Pictures
  • Price
  • City
  • Sold quantity
  • Questions
  • Seller’s reputation
  • Detailed description

Item fields

Let’s see a regular item in detail. This is easy since you only need to know the item_id associated to the product, and since it’s public you can get it from the item’s details page on the top of the page, like in the example picture. You just need to add the site_id before the number and that’s it. Now you can request the Items resource to get all the related 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/MLA600190449

Response:

{
    "id": "MLB1191972200",
    "site_id": "MLB",
    "title": "iPhone Xs  64gb",
    "subtitle": null,
    "seller_id": 386261073,
    "category_id": "MLB1055",
    "official_store_id": 2162,
    "price": 7299,
    "base_price": 7299,
    "original_price": null,
    "currency_id": "BRL",
    "initial_quantity": 5,
    "available_quantity": 2,
    "sold_quantity": 0,
    "sale_terms": [
        {
            "id": "WARRANTY_TYPE",
            "name": "Tipo de garantia",
            "value_id": "2230279",
            "value_name": "Garantia de fábrica",
            "value_struct": null,
            "values": [
                {
                    "id": "2230279",
                    "name": "Garantia de fábrica",
                    "struct": null
                }
            ]
        },
        {
            "id": "WARRANTY_TIME",
            "name": "Tempo de garantia",
            "value_id": null,
            "value_name": "12 meses",
            "value_struct": {
                "number": 12,
                "unit": "meses"
            },
            "values": [
                {
                    "id": null,
                    "name": "12 meses",
                    "struct": {
                        "number": 12,
                        "unit": "meses"
                    }
                }
            ]
        }
    ],
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_pro",
    "start_time": "2019-03-11T20:12:44.000Z",
    "stop_time": "2039-03-06T04:00:00.000Z",
    "condition": "new",
    "permalink": "https://produto.mercadolivre.com.br/MLB-1191972200-iphone-xs-64gb-_JM",
    "thumbnail": "http://mlb-s1-p.mlstatic.com/948658-MLB31730426082_082019-I.jpg",
    "secure_thumbnail": "https://mlb-s1-p.mlstatic.com/948658-MLB31730426082_082019-I.jpg",
    "pictures": [
        {
            "id": "948658-MLB31730426082_082019",
            "url": "http://mlb-s1-p.mlstatic.com/948658-MLB31730426082_082019-O.jpg",
            "secure_url": "https://mlb-s1-p.mlstatic.com/948658-MLB31730426082_082019-O.jpg",
            "size": "247x500",
            "max_size": "526x1064",
            "quality": ""
        },
        {
            "id": "710945-MLB31730422159_082019",
            "url": "http://mlb-s1-p.mlstatic.com/710945-MLB31730422159_082019-O.jpg",
            "secure_url": "https://mlb-s1-p.mlstatic.com/710945-MLB31730422159_082019-O.jpg",
            "size": "500x409",
            "max_size": "1064x872",
            "quality": ""
        },
        {
            "id": "866876-MLB31730419625_082019",
            "url": "http://mlb-s1-p.mlstatic.com/866876-MLB31730419625_082019-O.jpg",
            "secure_url": "https://mlb-s1-p.mlstatic.com/866876-MLB31730419625_082019-O.jpg",
            "size": "247x500",
            "max_size": "457x924",
            "quality": ""
        },
        {
            "id": "667919-MLB31730432393_082019",
            "url": "http://mlb-s1-p.mlstatic.com/667919-MLB31730432393_082019-O.jpg",
            "secure_url": "https://mlb-s1-p.mlstatic.com/667919-MLB31730432393_082019-O.jpg",
            "size": "500x404",
            "max_size": "1064x861",
            "quality": ""
        },
        {
            "id": "679523-MLB31730442422_082019",
            "url": "http://mlb-s1-p.mlstatic.com/679523-MLB31730442422_082019-O.jpg",
            "secure_url": "https://mlb-s1-p.mlstatic.com/679523-MLB31730442422_082019-O.jpg",
            "size": "249x500",
            "max_size": "503x1008",
            "quality": ""
        },
        {
            "id": "916431-MLB31730432193_082019",
            "url": "http://mlb-s1-p.mlstatic.com/916431-MLB31730432193_082019-O.jpg",
            "secure_url": "https://mlb-s1-p.mlstatic.com/916431-MLB31730432193_082019-O.jpg",
            "size": "500x401",
            "max_size": "1074x863",
            "quality": ""
        }
    ],
    "video_id": null,
    "descriptions": [
        {
            "id": "MLB1191972200-2009065041"
        }
    ],
    "accepts_mercadopago": true,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "mode": "me2",
        "free_methods": [
            {
                "id": 100009,
                "rule": {
                    "default": true,
                    "free_mode": "country",
                    "free_shipping_flag": true,
                    "value": null
                }
            }
        ],
        "tags": [
            "mandatory_free_shipping",
            "optional_me2_chosen"
        ],
        "dimensions": null,
        "local_pick_up": false,
        "free_shipping": true,
        "logistic_type": "drop_off",
        "store_pick_up": false
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "city": {
            "id": "TUxCQ1NFUmI1ZGQx",
            "name": "Serra"
        },
        "state": {
            "id": "BR-ES",
            "name": "Espírito Santo"
        },
        "country": {
            "id": "BR",
            "name": "Brasil"
        },
        "search_location": {
            "neighborhood": {
                "id": "TUxCQk1BVEQ3N0Q2",
                "name": "Mata da Serra"
            },
            "city": {
                "id": "TUxCQ1NFUmI1ZGQx",
                "name": "Serra"
            },
            "state": {
                "id": "TUxCUEVTUE8xN2Y3NA",
                "name": "Espírito Santo"
            }
        },
        "latitude": -20.204721,
        "longitude": -40.305973,
        "id": 1017932319
    },
    "seller_contact": null,
    "location": {},
    "geolocation": {
        "latitude": -20.204721,
        "longitude": -40.305973
    },
    "coverage_areas": [],
    "attributes": [
        {
            "id": "MP3",
            "name": "MP3",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "",
            "attribute_group_name": ""
        },
        {
            "id": "USB_CONNECTION",
            "name": "USB",
            "value_id": null,
            "value_name": "Lightning",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "Lightning",
                    "struct": null
                }
            ],
            "attribute_group_id": "",
            "attribute_group_name": ""
        },
        {
            "id": "BATTERY_CAPACITY",
            "name": "Capacidade da bateria",
            "value_id": "7070610",
            "value_name": "2658 mAh",
            "value_struct": {
                "number": 2658,
                "unit": "mAh"
            },
            "values": [
                {
                    "id": "7070610",
                    "name": "2658 mAh",
                    "struct": {
                        "number": 2658,
                        "unit": "mAh"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "BATTERY_TYPE",
            "name": "Tipo de bateria",
            "value_id": "95013",
            "value_name": "Íon de lítio",
            "value_struct": null,
            "values": [
                {
                    "id": "95013",
                    "name": "Íon de lítio",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "BRAND",
            "name": "Marca",
            "value_id": "9344",
            "value_name": "Apple",
            "value_struct": null,
            "values": [
                {
                    "id": "9344",
                    "name": "Apple",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "CARRIER",
            "name": "Operadora",
            "value_id": "298335",
            "value_name": "Desbloqueado",
            "value_struct": null,
            "values": [
                {
                    "id": "298335",
                    "name": "Desbloqueado",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "CPU_MODEL",
            "name": "Modelo de CPU",
            "value_id": "6927770",
            "value_name": "2x2.5 GHz Vortex/4x1.6 GHz Tempest",
            "value_struct": null,
            "values": [
                {
                    "id": "6927770",
                    "name": "2x2.5 GHz Vortex/4x1.6 GHz Tempest",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "DEPTH",
            "name": "Profundidade",
            "value_id": "6288970",
            "value_name": "7.7 mm",
            "value_struct": {
                "number": 7.7,
                "unit": "mm"
            },
            "values": [
                {
                    "id": "6288970",
                    "name": "7.7 mm",
                    "struct": {
                        "number": 7.7,
                        "unit": "mm"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "DIGITAL_ZOOM",
            "name": "Zoom digital",
            "value_id": "7199637",
            "value_name": "10x",
            "value_struct": {
                "number": 10,
                "unit": "x"
            },
            "values": [
                {
                    "id": "7199637",
                    "name": "10x",
                    "struct": {
                        "number": 10,
                        "unit": "x"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "DISPLAY_RESOLUTION",
            "name": "Resolução da tela",
            "value_id": "7199639",
            "value_name": "1125 px x 2436 px",
            "value_struct": null,
            "values": [
                {
                    "id": "7199639",
                    "name": "1125 px x 2436 px",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "DISPLAY_SIZE",
            "name": "Tamanho da tela",
            "value_id": null,
            "value_name": "5.8 polegadas",
            "value_struct": {
                "number": 5.8,
                "unit": "polegadas"
            },
            "values": [
                {
                    "id": null,
                    "name": "5.8 polegadas",
                    "struct": {
                        "number": 5.8,
                        "unit": "polegadas"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "FRONT_CAMERAS_NUMBER",
            "name": "Número de câmeras frontais",
            "value_id": "7477216",
            "value_name": "1",
            "value_struct": null,
            "values": [
                {
                    "id": "7477216",
                    "name": "1",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "FRONT_CAMERA_RECORDING_RESOLUTION",
            "name": "Resolução de vídeo da câmera frontal",
            "value_id": "7173215",
            "value_name": "1920 px x 1080 px",
            "value_struct": null,
            "values": [
                {
                    "id": "7173215",
                    "name": "1920 px x 1080 px",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "HEIGHT",
            "name": "Altura",
            "value_id": "6936436",
            "value_name": "143.6 mm",
            "value_struct": {
                "number": 143.6,
                "unit": "mm"
            },
            "values": [
                {
                    "id": "6936436",
                    "name": "143.6 mm",
                    "struct": {
                        "number": 143.6,
                        "unit": "mm"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "INTERNAL_MEMORY",
            "name": "Memória interna",
            "value_id": null,
            "value_name": "64 GB",
            "value_struct": {
                "number": 64,
                "unit": "GB"
            },
            "values": [
                {
                    "id": null,
                    "name": "64 GB",
                    "struct": {
                        "number": 64,
                        "unit": "GB"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "IS_DUAL_SIM",
            "name": "É Dual SIM",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "IS_WATERPROOF",
            "name": "É à prova d'água",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "ITEM_CONDITION",
            "name": "Condição do item",
            "value_id": "2230284",
            "value_name": "Novo",
            "value_struct": null,
            "values": [
                {
                    "id": "2230284",
                    "name": "Novo",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "LINE",
            "name": "Linha",
            "value_id": "58993",
            "value_name": "iPhone",
            "value_struct": null,
            "values": [
                {
                    "id": "58993",
                    "name": "iPhone",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "MAIN_FRONT_CAMERA_RESOLUTION",
            "name": "Resolução da câmera frontal principal",
            "value_id": "7199634",
            "value_name": "7 Mpx",
            "value_struct": {
                "number": 7,
                "unit": "Mpx"
            },
            "values": [
                {
                    "id": "7199634",
                    "name": "7 Mpx",
                    "struct": {
                        "number": 7,
                        "unit": "Mpx"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "MAIN_REAR_CAMERA_RESOLUTION",
            "name": "Resolução da câmera traseira principal",
            "value_id": "7199628",
            "value_name": "12 Mpx",
            "value_struct": {
                "number": 12,
                "unit": "Mpx"
            },
            "values": [
                {
                    "id": "7199628",
                    "name": "12 Mpx",
                    "struct": {
                        "number": 12,
                        "unit": "Mpx"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "MAX_BRIGHTNESS",
            "name": "Brilho máximo",
            "value_id": "6877637",
            "value_name": "625 cd/m²",
            "value_struct": {
                "number": 625,
                "unit": "cd/m²"
            },
            "values": [
                {
                    "id": "6877637",
                    "name": "625 cd/m²",
                    "struct": {
                        "number": 625,
                        "unit": "cd/m²"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "MAX_MEMORY_CARD_CAPACITY",
            "name": "Capacidade máxima do cartão de memória",
            "value_id": null,
            "value_name": "64 GB",
            "value_struct": {
                "number": 64,
                "unit": "GB"
            },
            "values": [
                {
                    "id": null,
                    "name": "64 GB",
                    "struct": {
                        "number": 64,
                        "unit": "GB"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "MOBILE_NETWORK",
            "name": "Rede",
            "value_id": "367876",
            "value_name": "4G/LTE",
            "value_struct": null,
            "values": [
                {
                    "id": "367876",
                    "name": "4G/LTE",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "MODEL",
            "name": "Modelo",
            "value_id": null,
            "value_name": "MT9G2BZ/A",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "MT9G2BZ/A",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "NUMBER_OF_SIM_CARD_SLOTS",
            "name": "Quantidade de ranhuras para cartão SIM",
            "value_id": "2087812",
            "value_name": "1",
            "value_struct": null,
            "values": [
                {
                    "id": "2087812",
                    "name": "1",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "OPERATING_SYSTEM_NAME",
            "name": "Nome do sistema operacional",
            "value_id": "7404961",
            "value_name": "iOS",
            "value_struct": null,
            "values": [
                {
                    "id": "7404961",
                    "name": "iOS",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "OPERATING_SYSTEM_VERSION",
            "name": "Versão do sistema operacional",
            "value_id": null,
            "value_name": "iOS12",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "iOS12",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "OPTICAL_ZOOM",
            "name": "Zoom óptico",
            "value_id": "1344",
            "value_name": "2x",
            "value_struct": {
                "number": 2,
                "unit": "x"
            },
            "values": [
                {
                    "id": "1344",
                    "name": "2x",
                    "struct": {
                        "number": 2,
                        "unit": "x"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "ORIGIN",
            "name": "Origem",
            "value_id": "97214",
            "value_name": "Brasil",
            "value_struct": null,
            "values": [
                {
                    "id": "97214",
                    "name": "Brasil",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "PIXELS_PER_INCH",
            "name": "Pixels por polegada",
            "value_id": "7070609",
            "value_name": "458 ppi",
            "value_struct": {
                "number": 458,
                "unit": "ppi"
            },
            "values": [
                {
                    "id": "7070609",
                    "name": "458 ppi",
                    "struct": {
                        "number": 458,
                        "unit": "ppi"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "PROCESSOR_CORES_NUMBER",
            "name": "Quantidade de núcleos do processador",
            "value_id": "7199636",
            "value_name": "6",
            "value_struct": null,
            "values": [
                {
                    "id": "7199636",
                    "name": "6",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "PROCESSOR_MODEL",
            "name": "Modelo do processador",
            "value_id": "6927771",
            "value_name": "Apple A12 Bionic",
            "value_struct": null,
            "values": [
                {
                    "id": "6927771",
                    "name": "Apple A12 Bionic",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "PROCESSOR_SPEED",
            "name": "Velocidade do processador",
            "value_id": "365850",
            "value_name": "2.5 GHz",
            "value_struct": {
                "number": 2.5,
                "unit": "GHz"
            },
            "values": [
                {
                    "id": "365850",
                    "name": "2.5 GHz",
                    "struct": {
                        "number": 2.5,
                        "unit": "GHz"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "RAM",
            "name": "Memória RAM",
            "value_id": "-1",
            "value_name": null,
            "value_struct": null,
            "values": [
                {
                    "id": "-1",
                    "name": null,
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "REAR_CAMERAS_NUMBER",
            "name": "Número de câmeras traseiras",
            "value_id": "7477262",
            "value_name": "2",
            "value_struct": null,
            "values": [
                {
                    "id": "7477262",
                    "name": "2",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "REAR_CAMERAS_RESOLUTION",
            "name": "Resolução das câmeras traseiras",
            "value_id": "7405025",
            "value_name": "12 Mpx/12 Mpx",
            "value_struct": null,
            "values": [
                {
                    "id": "7405025",
                    "name": "12 Mpx/12 Mpx",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "REAR_CAMERA_APERTURE",
            "name": "Abertura do diafragma da câmera traseira",
            "value_id": "7505957",
            "value_name": "f 1.8/f 2.4",
            "value_struct": null,
            "values": [
                {
                    "id": "7505957",
                    "name": "f 1.8/f 2.4",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "REAR_CAMERA_RECORDING_RESOLUTION",
            "name": "Resolução de vídeo da câmera traseira",
            "value_id": "7199630",
            "value_name": "3840 px x 2160 px",
            "value_struct": null,
            "values": [
                {
                    "id": "7199630",
                    "name": "3840 px x 2160 px",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "SCREEN_TECHNOLOGY",
            "name": "Tecnologia de tela",
            "value_id": "80491",
            "value_name": "OLED",
            "value_struct": null,
            "values": [
                {
                    "id": "80491",
                    "name": "OLED",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "SIM_SIZES",
            "name": "Tamanhos de cartão SIM compatíveis",
            "value_id": "80453",
            "value_name": "Nano-SIM",
            "value_struct": null,
            "values": [
                {
                    "id": "80453",
                    "name": "Nano-SIM",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "TALK_TIME",
            "name": "Autonomia conversação",
            "value_id": "2087877",
            "value_name": "20 h",
            "value_struct": {
                "number": 20,
                "unit": "h"
            },
            "values": [
                {
                    "id": "2087877",
                    "name": "20 h",
                    "struct": {
                        "number": 20,
                        "unit": "h"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WEIGHT",
            "name": "Peso",
            "value_id": "980195",
            "value_name": "177 g",
            "value_struct": {
                "number": 177,
                "unit": "g"
            },
            "values": [
                {
                    "id": "980195",
                    "name": "177 g",
                    "struct": {
                        "number": 177,
                        "unit": "g"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WIDTH",
            "name": "Largura",
            "value_id": "6936437",
            "value_name": "70.9 mm",
            "value_struct": {
                "number": 70.9,
                "unit": "mm"
            },
            "values": [
                {
                    "id": "6936437",
                    "name": "70.9 mm",
                    "struct": {
                        "number": 70.9,
                        "unit": "mm"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_ACCELEROMETER",
            "name": "Com acelerômetro",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_BLUETOOTH",
            "name": "Com Bluetooth",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_CAMERA",
            "name": "Com câmera",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_ESIM",
            "name": "Com eSIM",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_FINGERPRINT_READER",
            "name": "Com leitor de impressão digital",
            "value_id": "242084",
            "value_name": "Não",
            "value_struct": null,
            "values": [
                {
                    "id": "242084",
                    "name": "Não",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_FRONT_CAMERA_FLASH",
            "name": "Com flash na câmara frontal",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_GPS",
            "name": "Com GPS",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_GYROSCOPE",
            "name": "Com giroscópio",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_IMEI",
            "name": "Com IMEI",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_MINI_HDMI",
            "name": "Com mini HDMI",
            "value_id": "242084",
            "value_name": "Não",
            "value_struct": null,
            "values": [
                {
                    "id": "242084",
                    "name": "Não",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_PHYSICAL_QWERTY_KEYBOARD",
            "name": "Com teclado QWERTY físico",
            "value_id": "242084",
            "value_name": "Não",
            "value_struct": null,
            "values": [
                {
                    "id": "242084",
                    "name": "Não",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_PROXIMITY_SENSOR",
            "name": "Com sensor de proximidade",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_RADIO",
            "name": "Com radio",
            "value_id": "242084",
            "value_name": "Não",
            "value_struct": null,
            "values": [
                {
                    "id": "242084",
                    "name": "Não",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_REMOVABLE_BATTERY",
            "name": "Com bateria removível",
            "value_id": "242084",
            "value_name": "Não",
            "value_struct": null,
            "values": [
                {
                    "id": "242084",
                    "name": "Não",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_SLOW_MOTION_CAMERA_FUNCTION",
            "name": "Com função de câmara lenta",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_TOUCH_SCREEN",
            "name": "Com tela tátil",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_TV_TUNER",
            "name": "Com sintonizador de TV",
            "value_id": "242084",
            "value_name": "Não",
            "value_struct": null,
            "values": [
                {
                    "id": "242084",
                    "name": "Não",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_USB_CONNECTOR",
            "name": "Com conector USB",
            "value_id": "242084",
            "value_name": "Não",
            "value_struct": null,
            "values": [
                {
                    "id": "242084",
                    "name": "Não",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_WIFI",
            "name": "Com Wi-Fi",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        }
    ],
    "warnings": [],
    "listing_source": "",
    "variations": [
        {
            "id": 33898892473,
            "price": 7299,
            "attribute_combinations": [
                {
                    "id": "COLOR",
                    "name": "Cor",
                    "value_id": "162060",
                    "value_name": "Cinza-espacial",
                    "value_struct": null,
                    "values": [
                        {
                            "id": "162060",
                            "name": "Cinza-espacial",
                            "struct": null
                        }
                    ]
                }
            ],
            "available_quantity": 1,
            "sold_quantity": 0,
            "sale_terms": [],
            "picture_ids": [
                "948658-MLB31730426082_082019",
                "710945-MLB31730422159_082019"
            ],
            "catalog_product_id": "MLB12866584"
        },
        {
            "id": 33898892476,
            "price": 7299,
            "attribute_combinations": [
                {
                    "id": "COLOR",
                    "name": "Cor",
                    "value_id": "976",
                    "value_name": "Prata",
                    "value_struct": null,
                    "values": [
                        {
                            "id": "976",
                            "name": "Prata",
                            "struct": null
                        }
                    ]
                }
            ],
            "available_quantity": 1,
            "sold_quantity": 0,
            "sale_terms": [],
            "picture_ids": [
                "866876-MLB31730419625_082019",
                "667919-MLB31730432393_082019"
            ],
            "catalog_product_id": "MLB12866585"
        },
        {
            "id": 33898892479,
            "price": 7299,
            "attribute_combinations": [
                {
                    "id": "COLOR",
                    "name": "Cor",
                    "value_id": "283164",
                    "value_name": "Dourado",
                    "value_struct": null,
                    "values": [
                        {
                            "id": "283164",
                            "name": "Dourado",
                            "struct": null
                        }
                    ]
                }
            ],
            "available_quantity": 0,
            "sold_quantity": 0,
            "sale_terms": [],
            "picture_ids": [
                "679523-MLB31730442422_082019",
                "916431-MLB31730432193_082019"
            ],
            "catalog_product_id": "MLB12866583"
        }
    ],
    "status": "active",
    "sub_status": [],
    "tags": [
        "brand_verified",
        "good_quality_picture",
        "good_quality_thumbnail",
        "immediate_payment",
        "cart_eligible"
    ],
    "warranty": "Garantia de fábrica: 12 meses",
    "catalog_product_id": "MLB12866583",
    "domain_id": "MLB-CELLPHONES",
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [
        "MLB1556",
        "MLB1553"
    ],
    "automatic_relist": false,
    "date_created": "2019-03-11T20:12:44.000Z",
    "last_updated": "2019-11-27T11:06:33.000Z",
    "health": 0.9,
    "catalog_listing": false
}
Note:
To consult a description you need to use the /item/descriptions resource, just paste descriptions_id in the /items resource.
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/item_id/descriptions

Defining attributes

Some of the fields are mandatory when you create an item, while some others can be skipped or will be automatically added to the item. They will define how the item is displayed, how buyers can purchase it and the position on search results among other variables.


Title

The title is the key for buyers to find your product. Therefore, it should be as explicit as possible.

  • Generate the title with Product + Brand + product model + some specifications that help identify the product.
  • Avoid in the title information of other services, such as returns, free shipping or installment payments because your information will be seen by your buyers next to the product, without having to enter the publication.
  • If your product is new, used or refurbished, do not include it in the title, upload it in the features and we will show it in the detail of the publication.
  • If you sell the same product but with different colors, do not put the color in the title. Better create variants, so everything will be in a single publication.
  • If you only have stock of a certain color, load the color when publishing or in the characteristics section so that your buyers read the complete technical sheet, but you can add it in the title since it would be a publication that only sells a variant.
  • If you make a discount we will also indicate it showing the percentage of the promotion, we also have a special label to call attention. No need to add it in the title.
  • Separate words with spaces, do not use punctuation or symbols.
  • Check have no spelling errors.
  • It is not allowed to mention stock if you do it your publication will be moderated. The limit of the publication title is set by the category to which it belongs ("max_title_length").

For example: HP Dual Core 425 LED 14 320 GB 4 GB Wifi HDMI Notebook

Note:
You can always make all the changes you need making a PUT on a items resource modifying the tittle field when sold_quantity be 0.

Description

A detailed description will improve your chances to sell a product and will save time from answering questions. There are some considerations when working with descriptions, for example, it's not allowed posting a description with contact information. If you are interested in increasing your knowledge about this topic, check our descriptions guide.

Note:
The product description must be in plain text.

Condition

When listing an item you need to declare if the condition is new, used or not_specified. This attribute is mandatory to complete a list operation.


Available quantity

This attribute defines the stock, that's the number of products available for selling on this item. The highest value is defined by the chosen listing type. See more details in the listing type section.


Also, when you want to publish Fulfillment products you can specify the available quantity to zero, modifying the available_quantity field to 0. In this way, the publication will be created with a paused status and out_of_stock sub-status. This will allow you to not have sales and cannot deliver them due to lack of logistics. What happens when you PUT items and have no stock? It supports the same operations as an item paused due to lack of stock, that is, you will not be able to activate it and you must add units so that it is activated automatically.

Example:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d

'{
    ...
    "available_quantity": 0,
    ...
}'
 
https://api.mercadolibre.com/items

Response:

{
    "id": "MLB1374737433",
    "site_id": "MLB",
    "title": "Item De Teste - Não Comprar",
    "base_price": 10,
    ...
    "initial_quantity": 0,
    "available_quantity": 0,
    "sold_quantity": 0,
    ...
    "status": "paused",
    "sub_status": [
        "out_of_stock"
    ],
    ...
}
Important:
This possibility applies only to Argentina, Mexico and Brazil where we operate Fulfillment.

Pictures

Nice pictures can make an item more appealing and give buyers a better idea of the item’s appearance. Basically, you should add an array of up to six URL pictures on the Json.

{
 ....
 "pictures":[
  {"source":"http://yourServer/path/to/your/picture.jpg"},
  {"source":"http://yourServer/path/to/your/otherPicture.gif"},
  {"source":"http://yourServer/path/to/your/anotherPicture.png"}
 ]
 ...
}

We highly recommend you don’t use slow servers to host your pictures since this can lead to disadvantages when listing. You can also add or change pictures to your item here later on. Please read more about this topic to know which kind of pictures are allowed and how to work with them here.


Category

Sellers must define a category in MercadoLibre site. This attribute is mandatory and only accepts pre-established ids. For more information read categories guide. To get a category suggestion read this article.

Request:

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

Example:

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

Response:

{
  "id": "MLA1055",
  "name": "Celulares y Smartphones",
  "picture": "http://resources.mlstatic.com/category/images/fdca1620-3b63-4af2-bc0b-aeed17048d5d.png",
  "permalink": null,
  "total_items_in_this_category": 79627,
  "path_from_root": [
    {
      "id": "MLA1051",
      "name": "Celulares y Teléfonos"
    },
    {
      "id": "MLA1055",
      "name": "Celulares y Smartphones"
    }
  ],
  "children_categories": [
  ],
  "attribute_types": "variations",
  "settings": {
    "adult_content": false,
    "buying_allowed": true,
    "buying_modes": [
      "buy_it_now",
      "auction"
    ],
    "catalog_domain": "MLA-CELLPHONES",
    "coverage_areas": "not_allowed",
    "currencies": [
      "ARS"
    ],
    "fragile": false,
    "immediate_payment": "required",
    "item_conditions": [
      "not_specified",
      "used",
      "new"
    ],
    "items_reviews_allowed": false,
    "listing_allowed": true,
    "max_description_length": 50000,
    "max_pictures_per_item": 12,
    "max_pictures_per_item_var": 10,
    "max_sub_title_length": 70,
    "max_title_length": 60,
    "maximum_price": null,
    "minimum_price": 22,
    "mirror_category": null,
    "mirror_master_category": null,
    "mirror_slave_categories": [
    ],
    "price": "required",
    "reservation_allowed": "not_allowed",
    "restrictions": [
    ],
    "rounded_address": false,
    "seller_contact": "not_allowed",
    "shipping_modes": [
      "me1",
      "custom",
      "me2",
      "not_specified"
    ],
    "shipping_options": [
      "custom",
      "carrier"
    ],
    "shipping_profile": "optional",
    "show_contact_information": false,
    "simple_shipping": "optional",
    "stock": "required",
    "sub_vertical": "smartphones",
    "subscribable": false,
    "tags": [
    ],
    "vertical": "consumer_electronics",
    "vip_subdomain": "articulo",
    "buyer_protection_programs": [
      "delivered",
      "undelivered"
    ],
    "status": "enabled"
  },
  "meta_categ_id": null,
  "attributable": false,
  "date_created": "2018-04-25T08:12:56.000Z"
}

Considerations
With the /categories resource, you will be able to recognize whether the category is enabled on the site you want to publish.
With listing_allowed and status fields you can identify whether the categories are enabled for publication on the site. To identify those that are enabled, the listing_allowed field should have true value and the status field, enabled value.


Purchase method

Important:
Bidding is a functionality that is no longer active for the Mercado Libre site since January 2019.

The bidding modality ("buying_mode"="auction") will still appear in the APIs of some categories, but you will not be able to use it. As we carry out a constant review of categories, in short, all the APIs will already be updated.
We eliminated this type of advertisement, because almost 100% of our publications have a "Fixed price" and we saw that the experience for the seller and the buyer was being affected when the negotiation was due to bid.
Since then, only the immediate purchase mode ("buying_mode"="buy_it_now") is available, which guarantees that an order will only appear to the seller when the payment is approved, guaranteeing more security in transactions.


Price

This is a mandatory attribute, when you define a new item it must have a price. We suggest you search similar items on our marketplace to know the best price for your products and increase your competitivity. If you defined a price and then you’re not happy with it, you can change it later on, learn to modify items.


Currency

Besides price, you need to define a currency. This one is also a mandatory attribute. You need to define it using a pre-established id. Calling our Currencies resource you will know which Id to send.


Payment methods

It’s important that you have in consideration which payment methods you have available to work with. This will vary depending on the country you are currently working. Check this guide to know more about it .


Shipping

Shipping details are not mandatory, but there are many options to choose, and shipping the products you sell is a competitive advantage. Know more about the shipping options you have here.


Product Identifiers

Not a mandatory attribute either and only available for some countries and user types. Know more about it.


SKU

This information will help your sellers to identify, locate and internally track a product. We only take into account the information loaded in the SELLER_SKU attribute. Learn more about variations considerations.

Variations

With Variations you can count in the same publication all the variants of the item, maintaining even differential stock for each one. In this way, when you receive a purchase, you will see in the purchase order the color and size chosen by the buyer, thus facilitating the after-sales process. Lear more about Variations.


Listing type

This is another case of a mandatory attribute that only accepts pre-defined values and is very important for you to understand about it. There are different listing types available for each country. You should make a mixed call through sites and listing_types resources to know which listing_types are supported.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/{Site_id}/listing_types

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/listing_types

Response:

[
  {
    "site_id": "MLA",
    "id": "gold_pro",
    "name": "Premium"
  },
  {
    "site_id": "MLA",
    "id": "gold_premium",
    "name": "Oro Premium"
  },
  {
    "site_id": "MLA",
    "id": "gold_special",
    "name": "Clásica"
  },
  {
    "site_id": "MLA",
    "id": "gold",
    "name": "Oro"
  },
  {
    "site_id": "MLA",
    "id": "silver",
    "name": "Plata"
  },
  {
    "site_id": "MLA",
    "id": "bronze",
    "name": "Bronce"
  },
  {
    "site_id": "MLA",
    "id": "free",
    "name": "Gratuita"
  }
]

The fees for selling your item, as well as how it ranks on search results will vary according to the chosen listing type. You will find information about each listing type feeds and characteristics on each country marketplace FAQs, or you can make an API call like this:

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/{Site_id}/listing_types/{Listing_type}

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/listing_types/silver

Response:

{
  "id": "silver",
  "not_available_in_categories": [
  ],
  "configuration": {
  "name": "Plata",
  "listing_exposure": "mid",
  "requires_picture": false,
  "max_stock_per_item": 9999,
  "deduction_profile_id": null,
  "differential_pricing_id": null,
  "duration_days": {
    "buy_it_now": 60,
    "auction": 7,
    "classified": null
  },
  "immediate_payment": {
    "buy_it_now": false,
    "auction": false,
    "classified": false
  },
  "mercado_pago": "mandatory",
  "listing_fee_criteria": {
   "min_fee_amount": 5,
    "max_fee_amount": 160,
    "percentage_of_fee_amount": 1,
    "currency": "ARS"
  },
  "sale_fee_criteria": {
    "min_fee_amount": 0,
    "max_fee_amount": 100000000000000000,
    "percentage_of_fee_amount": 7.5,
    "currency": "ARS"
  }
  },
  "exceptions_by_category": [
  {
    "category_id": "MLA1743",
    "category_name": "Autos, Motos y Otros",
    "configuration": {
      "name": "Plata",
      "listing_exposure": "mid",
      "requires_picture": false,
      "max_stock_per_item": 1,
      "deduction_profile_id": null,
      "differential_pricing_id": null,
      "duration_days": {
        "buy_it_now": null,
        "auction": null,
        "classified": 60
      },
      "immediate_payment": {
        "buy_it_now": false,
        "auction": false,
        "classified": false
      },
      "mercado_pago": "not_available",
      "listing_fee_criteria": {
        "min_fee_amount": 147,
        "max_fee_amount": 147,
        "percentage_of_fee_amount": 0,
        "currency": "ARS"
      },
      "sale_fee_criteria": {
        "min_fee_amount": 0,
        "max_fee_amount": 0,
        "percentage_of_fee_amount": 0,
        "currency": null
      }
   },
    "exceptions_by_category": [
    ]
  },
  {
    "category_id": "MLA1459",
    "category_name": "Inmuebles",
    "configuration": {
      "name": "Plata",
      "listing_exposure": "mid",
      "requires_picture": false,
      "max_stock_per_item": 1,
      "deduction_profile_id": null,
      "differential_pricing_id": null,
      "duration_days": {
        "buy_it_now": null,
        "auction": null,
        "classified": 60
      },
      "immediate_payment": {
        "buy_it_now": false,
        "auction": false,
        "classified": false
      },
      "mercado_pago": "not_available",
      "listing_fee_criteria": {
        "min_fee_amount": 147,
        "max_fee_amount": 147,
        "percentage_of_fee_amount": 0,
        "currency": "ARS"
      },
      "sale_fee_criteria": {
        "min_fee_amount": 0,
        "max_fee_amount": 0,
        "percentage_of_fee_amount": 0,
        "currency": null
      }
    },
    "exceptions_by_category": [
    ]
  },
  {
    "category_id": "MLA1540",
    "category_name": "Servicios",
    "configuration": {
      "name": "Básico 365",
      "listing_exposure": "mid",
      "requires_picture": false,
      "max_stock_per_item": 999,
      "deduction_profile_id": null,
      "differential_pricing_id": null,
      "duration_days": {
          "buy_it_now": null,
        "auction": null,
        "classified": 365
      },
      "immediate_payment": {
        "buy_it_now": false,
        "auction": false,
        "classified": false
      },
      "mercado_pago": "not_available",
      "listing_fee_criteria": {
        "min_fee_amount": 727,
        "max_fee_amount": 727,
        "percentage_of_fee_amount": 0,
        "currency": "ARS"
      },
      "sale_fee_criteria": {
        "min_fee_amount": 0,
        "max_fee_amount": 0,
        "percentage_of_fee_amount": 0,
        "currency": null
      }
    },
    "exceptions_by_category": [
    ]
  }
  ]
}

An item condition

To define if a product is new, used or refurbished you will need to send the “item_condition” attribute with the value you intend to give. We recommend you to review the Attribute documentation to learn about category attributes and supported values. 

Note:
While today it is allowed to send if an item is new or used in the “condition” field, it should be placed as attribute in the case of “reacondicionado”.

Example:

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

Response:

{
    "id": "ITEM_CONDITION",
    "name": "Condición del ítem",
    "tags": {
      "hidden": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "2230284",
        "name": "Nuevo"
      },
      {
        "id": "2230581",
        "name": "Usado"
      },
      {
        "id": "2230582",
        "name": "Reacondicionado"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },

Important:
When the listing has “reacondicionado” condition, you need to load the Product Warranty in "sale_terms".

Product warranty

Within an item “sale_terms” section, define the warranty of the listed product. For this, the information should have a combination of attributes:
Warranty Type: represents the forms that warranty can take. For example, seller or factory warranty, etc.
Warranty Time: represents the time that warranty will be in force.

Request:

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

Example:

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

Response:

{
    "id": "WARRANTY_TYPE",
    "name": "Tipo de garantía",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "2230279",
        "name": "Garantía de fábrica"
      },
      {
        "id": "2230280",
        "name": "Garantía del vendedor"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "WARRANTY_TIME",
    "name": "Tiempo de garantía",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "días",
        "name": "días"
      },
      {
        "id": "años",
        "name": "años"
      },
      {
        "id": "meses",
        "name": "meses"
      }
    ],
    "default_unit": "días",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },

Note:
Keep in mind that when setting an item as reconditioned it should be done with a minimum 90-day guarantee. Look more about Publication Policies.

Listing an item

You’re ready to list your first item. Notice you’ll need an access_token to make it. If you have questions regarding how to get your access token, please go back to the Authenticate tutorial. We also recommend using test users to publish test articles. If you don't have your user test yet, see how to perform tests and get yours. You can create a Json for your item basing on the following example, or send it as it is, and you’ll be listing a sample product on the site:

Request:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -d '{
  "title":"Item de test - No Ofertar",
  "category_id":"MLA3530",
  "price":350,
  "currency_id":"ARS",
  "available_quantity":10,
  "buying_mode":"buy_it_now",
  "condition":"new",
  "listing_type_id":"gold_special",
  "description":{
     "plain_text":"Descripción con Texto Plano \n"
  },
  "video_id":"YOUTUBE_ID_HERE",
  "sale_terms":[
     {
        "id":"WARRANTY_TYPE",
        "value_name":"Garantía del vendedor"
     },
     {
        "id":"WARRANTY_TIME",
        "value_name":"90 días"
     }
  ],
  "pictures":[
     {
        "source":"http://mla-s2-p.mlstatic.com/968521-MLA20805195516_072016-O.jpg"
     }
  ],
  "attributes":[
     {
        "id":"BRAND",
        "value_name":"Marca del producto"
     },
     {
        "id":"EAN",
        "value_name":"7898095297749"
     }
  ]
}' 'https://api.mercadolibre.com/items

Example:

{
    "title": "Item de test - No Ofertar",
    "category_id": "MLA3530",
    "price": 350,
    "currency_id": "ARS",
    "available_quantity": 10,
    "buying_mode": "buy_it_now",
    "condition": "new",
    "listing_type_id": "gold_special",
    "description": {
        "plain_text": "Descripción con Texto Plano  \n"
    },
    "video_id": "YOUTUBE_ID_HERE",
    "sale_terms": [
        {
            "id": "WARRANTY_TYPE",
            "vale_name": "Garantía del vendedor"
        },
        {
            "id": "WARRANTY_TIME",
            "value_name": "90 días"
        }
    ],
    "pictures": [
        {
            "source": "http://mla-s2-p.mlstatic.com/968521-MLA20805195516_072016-O.jpg"
        }
    ],
    "attributes": [
        {
            "id": "BRAND",
            "value_name": "Marca del producto"
        },
        {
            "id": "EAN",
            "value_name": "7898095297749"
        }
    ]
}

Note:
If you have any trouble when trying to list, check the API Error Codes Reference chart at the end of this guide.

Items with mandatory Mercado Pago

Just as a user or a category can be marked with immediate payment, so can an item. This scenario occurs when:


List an item with immediate payment

If you want to get your item paid only with Mercado Pago, you may set that choice when you create a new item, or when you change an active one. To that end, use the tag “inmediate_payment”.

Request:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
    "title": "Item de teste - Não Comprar",
    "category_id": "MLB437616",
    "price": 10,
    "currency_id": "BRL",
    "available_quantity": 1,
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_special",
    "condition": "new",
    "description": "Publicação de teste, não comprar",
    "video_id": "YOUTUBE_ID_HERE",
    "tags": [
        "immediate_payment"
    ],
   "sale_terms":[
      {
         "id":"WARRANTY_TYPE",
         "value_name":"Garantia do vendedor"
      },
      {
         "id":"WARRANTY_TIME",
         "value_name":"90 días"
      }
   ],

    "pictures": [
         {
    "source": "https://www.motorino.com.br/site/wp-content/uploads/2018/01/produto_de_teste_amarelo_4_2_20171020224326-400x400.jpg"}

    ]
}
 
'
 
https://api.mercadolibre.com/items

Response:

{
    "id": "MLB1548991737",
    "site_id": "MLB",
    "title": "Item De Teste - Não Comprar",
    "subtitle": null,
    "seller_id": 419059118,
    "category_id": "MLB437616",
    "official_store_id": null,
    "price": 10,
    "base_price": 10,
    "original_price": null,
    "inventory_id": null,
    "currency_id": "BRL",
    "initial_quantity": 1,
    "available_quantity": 1,
    "sold_quantity": 0,
    "sale_terms": [
        {
            "id": "WARRANTY_TYPE",
            "name": "Tipo de garantia",
            "value_id": "2230280",
            "value_name": "Garantia do vendedor",
            "value_struct": null,
            "values": [
                {
                    "id": "2230280",
                    "name": "Garantia do vendedor",
                    "struct": null
                }
            ]
        },
        {
            "id": "WARRANTY_TIME",
            "name": "Tempo de garantia",
            "value_id": null,
            "value_name": "90 días",
            "value_struct": {
                "number": 90,
                "unit": "dias"
            },
            "values": [
                {
                    "id": null,
                    "name": "90 días",
                    "struct": {
                        "number": 90,
                        "unit": "dias"
                    }
                }
            ]
        }
    ],
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_special",
    "start_time": "2020-06-05T13:48:44.964Z",
    "stop_time": "2040-05-31T04:00:00.000Z",
    "end_time": "2040-05-31T04:00:00.000Z",
    "expiration_time": "2020-08-24T13:48:45.039Z",
    "condition": "new",
    "permalink": "http://produto.mercadolivre.com.br/MLB-1548991737-item-de-teste-no-comprar-_JM",
    "pictures": [
        {
            "id": "830983-MLB42088778762_062020",
            "url": "http://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/O-PT.jpg",
            "secure_url": "https://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/O-PT.jpg",
            "size": "500x500",
            "max_size": "500x500",
            "quality": ""
        }
    ],
    "video_id": null,
    "descriptions": [
        {
            "id": "MLB1548991737-2706641462"
        }
    ],
    "accepts_mercadopago": true,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "mode": "me1",
        "local_pick_up": false,
        "free_shipping": false,
        "methods": [],
        "dimensions": null,
        "tags": [],
        "logistic_type": "default",
        "store_pick_up": false
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "id": 1032937241,
        "comment": "",
        "address_line": "Rua Exemplo 123",
        "zip_code": "01234100",
        "city": {
            "id": "BR-SP-44",
            "name": "São Paulo"
        },
        "state": {
            "id": "BR-SP",
            "name": "São Paulo"
        },
        "country": {
            "id": "BR",
            "name": "Brasil"
        },
        "latitude": -23.6251244,
        "longitude": -46.7441422,
        "search_location": {
            "neighborhood": {
                "id": "TUxCQlZJTDI1OTI",
                "name": "Vila Andrade"
            },
            "city": {
                "id": "TUxCQ1NQLTkxMjE",
                "name": "São Paulo Zona Sul"
            },
            "state": {
                "id": "TUxCUFNBT085N2E4",
                "name": "São Paulo"
            }
        }
    },
    "seller_contact": null,
    "location": {},
    "geolocation": {
        "latitude": -23.6251244,
        "longitude": -46.7441422
    },
    "coverage_areas": [],
    "attributes": [
        {
            "id": "ITEM_CONDITION",
            "name": "Condição do item",
            "value_id": "2230284",
            "value_name": "Novo",
            "value_struct": null,
            "values": [
                {
                    "id": "2230284",
                    "name": "Novo",
                    "struct": null
                }
            ],
            "attribute_group_id": "",
            "attribute_group_name": ""
        }
    ],
    "warnings": [],
    "listing_source": "",
    "variations": [],
    "thumbnail": "http://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/I-PT.jpg",
    "secure_thumbnail": "https://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/I-PT.jpg",
    "status": "active",
    "sub_status": [],
    "tags": [
        "cart_eligible",
        "immediate_payment",
        "test_item"
    ],
    "warranty": "Garantia do vendedor: 90 días",
    "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-06-05T13:48:45.176Z",
    "last_updated": "2020-06-05T13:48:45.176Z",
    "health": null,
    "catalog_listing": false,
    "item_relations": []
}

Categories with immediate payment

Some categories within MercadoLibre require Mercado Pago as the only choice. To find out if the category where you wish to list is one of them, check the following:

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

"immediate_payment": "required",
    "item_conditions": [
      "new",
      "not_specified",
      "used"
    ],

If the "immediate_payment" field is set as "required," Mercado Pago is mandatory. If it reads "optional,” it also accepts “As agreed with the seller”.



List an official store item

Listing an official store item is just like listing any other item, except that you also need to add the official_store_id attribute on the JSON.

Example:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
   "title":"Item de Test -No Ofertar",
   "category_id":"MLA5529",
   "price":10,
   "official_store_id":1,
   "currency_id":"ARS",
   "available_quantity":1,
   "buying_mode":"buy_it_now",
   "listing_type_id":"bronze",
   "condition":"new",
   "description":{
      "plain_text":"Item:, Ray-Ban WAYFARER Gloss Black RB2140 901 Model: RB2140. Size: 50mm. Name: WAYFARER. Color: Gloss Black. Includes Ray-Ban Carrying Case and Cleaning Cloth. New in Box"
   },
   "video_id":"YOUTUBE_ID_HERE",
   "sale_terms":[
      {
         "id":"WARRANTY_TYPE",
         "value_name":"Garantia do vendedor"
      },
      {
         "id":"WARRANTY_TIME",
         "value_name":"90 días"
      }
   ],

   "pictures":[
      {
         "source":"http://upload.wikimedia.org/wikipedia/commons/f/fd/Ray_Ban_Original_Wayfarer.jpg"
      },
      {
         "source":"http://en.wikipedia.org/wiki/File:Teashades.gif"
      }
   ]
}'https://api.mercadolibre.com/items?access_token=$ACCESS_TOKEN

Note:
If your store is multi-brand you need to specify the official_store_id of the brand where you want to list that item. Check our Official Stores guide to know more about this topic.

Select the channel where you want to offer products

Important:
This functionality is available only for Argentina, Brazil and Mexico, that is, where Mercado Shops is active.

Using the exclusive_channel attribute you can choose where to publish an article, either only in Mercado Libre, in Mercado Shops or on both channels. Possible values are: 
- Mercado Libre
- Mercado Shops

The presence of this attribute determines in which channel the item is visible exclusively and its absence indicates that the item is visible in both channels. An item with the exclusive_channel attribute with value_id field in null, behaves as if the attribute did not exist.  Below you can see an example of an Item published exclusively in Mercado Shops:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
... 
"attributes": [
  	{
		"id": "EXCLUSIVE_CHANNEL",
		"value_name": "Mercado Shops"
	}]
...
}' https://api.mercadolibre.com/items

The following example corresponds to an item offered exclusively in Mercado Libre:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
... 
"attributes": [
  	{
		"id": "EXCLUSIVE_CHANNEL",
		"value_name": "Mercado Libre"
	}]
...
}' https://api.mercadolibre.com/items

Learn more about Mercado Shops.


Error codes reference

Important:
The moderation for publishing items of the selected brands by non-accredited sellers will be as follows:
- Mercado Libre Argentina: moderates Adidas and Reebok items since February 2020.
- Mercado Libre México: moderates Nike items since August 13, 2020. Since October 08, 2020, Adidas and Reebok items will be moderated.
- Mercado Libre Brazil: From November 11, 2020, items from Adidas and Reebok will be moderated.
Error Error message Description Possible solution
item.start_time.invalid Start time $startTime is only updateable in NOT_YET_ACTIVE ítems. Field start time cannot be updated. The parameter start_time can only be updated if the item status is NOT_YET_ACTIVE
item.category_id.invalid Category $categoryId does not exist. Category not found. To see the available categories check the page/sites/$siteId (Check $sideId).
item.category_id.invalid Is not allowed to post in category $categoryId. Make sure you’re posting in a leaf category. $category.listing_allowed false. Before post an item, make sure it is allowed to post in the chosen category, see the parameter listing_allowed on /categories/$categoryId.
item.buying_mode.invalid Category $categoryId only supports listing modes: $category.buyingModes. $item.buying_modes is invalid. To see the available listing modes in category check the page /categories/$categoryId in parameter settings:{buying_modes:[…]}.
item.attributes.missing_required The attributes $requiredAttributeIds are required for category $item.categoryId. Check the attribute is present in the attributes list or in all variation attributes combination. Category is required atribute. To see the attributes mandatory on this category check the page /categories/$categoryId/attributes in parameter {tags:{required:{true}}}.
item.listing_type_id.invalid Invalid listing_type_id. $item.listing_type_id is invalid. To see the available listing types in category check the page /categories/$categoryId/listing_types.
item.listing_type_id.requiresPictures Pictures are mandatory for listing type $item.listingTypeId. Pictures is required. To see if the pictures is mandatory in category check the page /categories/$categoryId/listing_types/silver in parameter requires_picture:{}.
item.site_id.invalid Site $item.siteId doesn’t exist. $item.site_id is invalid. To the available sites, see the page /sites.
item.description.max The description field is too long. More than $maxSize characters is not allowed. Number of characters exceeded. The number of characters in description must be less then 50000 characters.
item.pictures.max Items in category $item.categoryId cannot exceeds $maxPicturesPerItem pictures. Number of images exceeded. To see the quantity of pictures per item in category check the page /categories/$categoryId in parametermax_pictures_per_item:{}.
item.attributes.invalid_length Invalid value length for attribute $it.attributeId. Maximum length is ${attribute.value_max_length}. To see the attributes max_length on this attribute check the page /categories/$categoryId/attributes in parameter value_max_length for attributes with .value_type string or number.
seller.unable_to_list The seller cannot post. The seller cannot post for certain cause. Identify the “cause” field in the response. - Find out the meaning of “cause” under /users#options, set the status to list, and you will see the meaning.
- Try to make the first manual posting from My Account in Mercado Libre to see the warnings in the flow.
moderations.seller_id.not_authorized Seller is not authorized for this brand and category. The Nike, Adidas and Reebok brands have authorized sellers to sell their products on Mercado Libre. If the seller does not have that relationship, they will not be able to publish the item. The item was moderated and you will not be able to publish. This moderation is active in Mexico and Argentina.

HTTP response code references

If any information could not be obtained, items can return the http code 206. Keep in mind that in most cases the information you receive will be enough to continue working.
In the response header X-Content-Missing you will find the name of the fields without information, which could be “location”, “geolocation” and/or “seller_address”.

Request:

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

Response http 200 OK:

{
    "id": "",
    "seller_id": ,
    ...
    "seller_address": {
        "id": 1011241361,
        "address_line": "Evaristo Lillo 112",
        "zip_code": "7200",
        "comment": "this is a comment",
        "city": {
            "id": "TUxDQ0xBUzU2MTEz",
            "name": "Las Condes"
        },
        "state": {
            "id": "CL-RM",
            "name": "RM (Metropolitana)"
        },
        "country": {
            "id": "CL",
            "name": "Chile"
        },
        "search_location": {
            "neighborhood": {
                "id": "",
                "name": ""
            },
            "city": {
                "id": "TUxDQ0xBUzU2MTEz",
                "name": "Las Condes"
            },
            "state": {
                "id": "TUxDUE1FVEExM2JlYg",
                "name": "RM (Metropolitana)"
            }
        },
        "latitude": -33.4140509,
        "longitude": -70.5814078
    },
    "location": {},
    "geolocation": {
        "latitude": -33.4140509,
        "longitude": -70.5814078
    },
    ...
}

Request:

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

Response :

{
    "id": "",
    "seller_id": ,
    ...
    "seller_address": {
        "id": 1011241361
    },
    "location": {},
    "geolocation": {},
    ...
}

Related articles: Add and configure shipping options for your products and Know listing prices and exposures.


Next topic: Ship products

or register to recieve the latest news about our API