List vehicles

This guide will help you to list your first classified item on Mercado Libre using our API.

Contents

→Basics
→Listing results
→Vehicle fields
→Defining attributes
↳Title
      ↳Description
      ↳Pictures
      ↳Category
      ↳Price
      ↳Currency
→Listing Type
→Location
      ↳Seller contacts
      ↳Available_quantity
      ↳Condition
→List motors items
→Duplicate items
→Brand, model and version
→Official Stores for Vehicles and Real Estate


Basics

In the Mercado Libre API, classified listings are the only ones where contact information is public. So, when users are browsing and have an interest in a list, they can get in touch immediately. Basically there are no transactions or exchanges made on our site for this type of items (with the exception of a reservation), but you will be exposing your profile to each user who is browsing the "Classifieds" section of our platform.


Listing results

Each item you list will appear in the listing results of a given search. For example, when a user search for the query “Peluquería” or “Camioneta”, as a result he will get a list of all items related, that can include yours. 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.


Vehicle fields

Let's see an item in detail. This is easy, because you only need to know the item_id associated with the product and, as it is public, you can get it on the item details page at the top of the page, as in the example image. You must add the site_id before the number and voila. Now you can request the Articles resource to get all the related information:

Call:

curl - X GET https://api.mercadolibre.com/items/{Item_id}

Example:

curl  -X GET https://api.mercadolibre.com/items/MLB1045563828

Response:

{
  "id": "MLB1045563828",
  "site_id": "MLB",
  "title": "Anuncio Teste Prova Carro - Nao Comprar",
  "subtitle": null,
  "seller_id": 307415664,
  "category_id": "MLB76395",
  "official_store_id": null,
  "price": 100000,
  "base_price": 100000,
  "original_price": null,
  "currency_id": "BRL",
  "initial_quantity": 1,
  "available_quantity": 1,
  "sold_quantity": 0,
  "sale_terms": [
    {
      "id": "RESERVATION_PRICE",
      "name": "Valor de reserva",
      "value_id": null,
      "value_name": "1000 BRL",
      "value_struct": {
        "number": 1000,
        "unit": "BRL"
      }
    }
  ],
  "buying_mode": "classified",
  "listing_type_id": "silver",
  "start_time": "2018-06-07T19:03:11.000Z",
  "stop_time": "2018-06-09T14:15:56.000Z",
  "condition": "used",
  "permalink": "https://carro.mercadolivre.com.br/MLB-1045563828-anuncio-teste-prova-carro-nao-comprar-_JM",
  "thumbnail": "",
  "secure_thumbnail": "",
  "pictures": [
  ],
  "video_id": null,
  "descriptions": [
    {
      "id": "MLB1045563828-1704138112"
    }
  ],
  "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": null,
    "store_pick_up": false
  },
  "international_delivery_mode": "none",
  "seller_address": {
    "comment": "",
    "address_line": "Rua Dantas Bião 43",
    "zip_code": "48030030",
    "city": {
      "id": "TUxCQ0FMQTlkMWUy",
      "name": "Alagoinhas"
    },
    "state": {
      "id": "BR-BA",
      "name": "Bahia"
    },
    "country": {
      "id": "BR",
      "name": "Brasil"
    },
    "search_location": {
      "neighborhood": {
        "id": "",
        "name": ""
      },
      "city": {
        "id": "TUxCQ0FMQTlkMWUy",
        "name": "Alagoinhas"
      },
      "state": {
        "id": "TUxCUEJBSEFlYmEx",
        "name": "Bahia"
      }
    },
    "latitude": -23.605724,
    "longitude": -46.66427,
    "id": 801390510
  },
  "seller_contact": {
    "contact": "",
    "other_info": "",
    "country_code": "",
    "area_code": "",
    "phone": "",
    "country_code2": "",
    "area_code2": "",
    "phone2": "",
    "email": "",
    "webpage": ""
  },
  "location": {
    "address_line": "Avenida Jurucë, 436",
    "zip_code": "04080011",
    "neighborhood": {
      "id": "",
      "name": ""
    },
    "city": {
      "id": "TVhYQXRpYmFpYVRVeENVRk5CVDA4NU4yRTQ",
      "name": "Atibaia"
    },
    "state": {
      "id": "TUxCUFNBT085N2E4",
      "name": "São Paulo"
    },
    "country": {
      "id": "BR",
      "name": "Brasil"
    },
    "open_hours": "",
    "latitude": "",
    "longitude": ""
  },
  "geolocation": {
    "latitude": "",
    "longitude": ""
  },
  "coverage_areas": [
  ],
  "attributes": [
    {
      "id": "ITEM_CONDITION",
      "name": "Condição do item",
      "value_id": "2230581",
      "value_name": "Usado",
      "value_struct": null,
      "attribute_group_id": "",
      "attribute_group_name": ""
    },
    {
      "id": "CONTACT_SCHEDULE",
      "name": "Horário de contato",
      "value_id": null,
      "value_name": "Me procurar a tarde",
      "value_struct": null,
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionais"
    },
    {
      "id": "SINGLE_OWNER",
      "name": "Único dono",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionais"
    },
    {
      "id": "STEERING",
      "name": "Direção",
      "value_id": "405719",
      "value_name": "Elétrica",
      "value_struct": null,
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionais"
    },
    {
      "id": "TRANSMISSION",
      "name": "Transmissão",
      "value_id": "370876",
      "value_name": "Automática",
      "value_struct": null,
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionais"
    },
    {
      "id": "VEHICLE_BODY_TYPE",
      "name": "Tipo",
      "value_id": "452753",
      "value_name": "Minivan",
      "value_struct": null,
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionais"
    },
    {
      "id": "HAS_AIR_CONDITIONING",
      "name": "Ar-condicionado",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "HAS_AUTOPILOT",
      "name": "Piloto automático",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "HAS_ELECTRIC_MIRRORS",
      "name": "Retrovisores elétricos",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "HAS_HEIGHT_ADJUSTABLE_DRIVER_SEAT",
      "name": "Banco motorista com regulagem de altura",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "HAS_LEATHER_UPHOLSTERY",
      "name": "Bancos em couro",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "HAS_LIGHT_ON_REMINDER",
      "name": "Alarme de luzes acesas",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "HAS_ONBOARD_COMPUTER",
      "name": "Computador de bordo",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "HAS_PARKING_SENSOR",
      "name": "Sensor de estacionamento",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "HAS_POWER_DOOR_LOCKS",
      "name": "Travas elétricas",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "HAS_POWER_WINDOWS",
      "name": "Vidros elétricos",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "HAS_RAIN_SENSOR",
      "name": "Sensor de chuva",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "HAS_REAR_FOLDING_SEAT",
      "name": "Banco traseiro retrátil",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "HAS_SLIDING_ROOF",
      "name": "Teto solar",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Conforto"
    },
    {
      "id": "DISTANCE_BETWEEN_AXES",
      "name": "Distância entre eixos",
      "value_id": null,
      "value_name": "2570 mm",
      "value_struct": {
        "number": 2570,
        "unit": "mm"
      },
      "attribute_group_id": "DFLT",
      "attribute_group_name": "Outros"
    },
    {
      "id": "FUEL_CAPACITY",
      "name": "Tanque de combustível",
      "value_id": null,
      "value_name": "54 L",
      "value_struct": {
        "number": 54,
        "unit": "L"
      },
      "attribute_group_id": "DFLT",
      "attribute_group_name": "Outros"
    },
    {
      "id": "GEAR_NUMBER",
      "name": "Número de velocidades",
      "value_id": null,
      "value_name": "6",
      "value_struct": null,
      "attribute_group_id": "DFLT",
      "attribute_group_name": "Outros"
    },
    {
      "id": "HEIGHT",
      "name": "Altura",
      "value_id": null,
      "value_name": "1625 mm",
      "value_struct": {
        "number": 1625,
        "unit": "mm"
      },
      "attribute_group_id": "DFLT",
      "attribute_group_name": "Outros"
    },
    {
      "id": "LENGTH",
      "name": "Comprimento",
      "value_id": null,
      "value_name": "4140 mm",
      "value_struct": {
        "number": 4140,
        "unit": "mm"
      },
      "attribute_group_id": "DFLT",
      "attribute_group_name": "Outros"
    },
    {
      "id": "LICENSE_PLATE",
      "name": "Placa",
      "value_id": null,
      "value_name": "EWP5306",
      "value_struct": null,
      "attribute_group_id": "DFLT",
      "attribute_group_name": "Outros"
    },
    {
      "id": "PASSENGER_CAPACITY",
      "name": "Quantidade de pessoas",
      "value_id": null,
      "value_name": "8",
      "value_struct": null,
      "attribute_group_id": "DFLT",
      "attribute_group_name": "Outros"
    },
    {
      "id": "VALVES_PER_CYLINDER",
      "name": "Válvulas por cilindro",
      "value_id": null,
      "value_name": "4",
      "value_struct": null,
      "attribute_group_id": "DFLT",
      "attribute_group_name": "Outros"
    },
    {
      "id": "WIDTH",
      "name": "Largura",
      "value_id": null,
      "value_name": "1800 mm",
      "value_struct": {
        "number": 1800,
        "unit": "mm"
      },
      "attribute_group_id": "DFLT",
      "attribute_group_name": "Outros"
    },
    {
      "id": "HAS_WINDSCREEN_WIPER",
      "name": "Limpador traseiro",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "EXTERIOR",
      "attribute_group_name": "Exterior"
    },
    {
      "id": "BRAND",
      "name": "Marca",
      "value_id": "374002",
      "value_name": "Kia",
      "value_struct": null,
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "DOORS",
      "name": "Portas",
      "value_id": null,
      "value_name": "4",
      "value_struct": null,
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "FUEL_TYPE",
      "name": "Tipo de combustível",
      "value_id": "372589",
      "value_name": "Gasolina",
      "value_struct": null,
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "KILOMETERS",
      "name": "Quilômetros",
      "value_id": null,
      "value_name": "92000 km",
      "value_struct": {
        "number": 92000,
        "unit": "km"
      },
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MODEL",
      "name": "Modelo",
      "value_id": "235012",
      "value_name": "Soul",
      "value_struct": null,
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "TRIM",
      "name": "Versão",
      "value_id": null,
      "value_name": "XRS",
      "value_struct": null,
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "VEHICLE_TYPE",
      "name": "Tipo de veículo",
      "value_id": "398351",
      "value_name": "Carros e caminhonetes",
      "value_struct": null,
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "VEHICLE_YEAR",
      "name": "Ano",
      "value_id": null,
      "value_name": "2012",
      "value_struct": null,
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "COLOR",
      "name": "Cor",
      "value_id": "52049",
      "value_name": "Preto",
      "value_struct": null,
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Outros"
    },
    {
      "id": "ARMORED",
      "name": "Blindado",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Segurança"
    },
    {
      "id": "HAS_ABS_BRAKES",
      "name": "Freios ABS",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Segurança"
    },
    {
      "id": "HAS_ALARM",
      "name": "Alarme",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Segurança"
    },
    {
      "id": "HAS_ALLOY_WHEELS",
      "name": "Rodas de liga leve",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Segurança"
    },
    {
      "id": "HAS_CURTAIN_AIRBAG",
      "name": "Airbag de cortina",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Segurança"
    },
    {
      "id": "HAS_FOG_LIGHT",
      "name": "Farol de neblina",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Segurança"
    },
    {
      "id": "HAS_PASSENGER_AIRBAG",
      "name": "Airbag passageiro",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Segurança"
    },
    {
      "id": "HAS_REAR_FOGLIGHTS",
      "name": "Faróis de neblina traseiros",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Segurança"
    },
    {
      "id": "TRACTION_CONTROL",
      "name": "Controle de tração",
      "value_id": "493979",
      "value_name": "Dianteira",
      "value_struct": null,
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Segurança"
    },
    {
      "id": "HAS_AMFM_RADIO",
      "name": "AM/FM",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Som"
    },
    {
      "id": "HAS_AUXILIARY_PORT",
      "name": "Entrada auxiliar",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Som"
    },
    {
      "id": "HAS_MP3_PLAYER",
      "name": "MP3 player",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Som"
    },
    {
      "id": "HAS_STEERING_WHEEL_CONTROL",
      "name": "Controle de som no volante",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Som"
    },
    {
      "id": "HAS_USB",
      "name": "Entrada USB",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Som"
    }
  ],
  "warnings": [
  ],
  "listing_source": "",
  "variations": [
  ],
  "status": "closed",
  "sub_status": [
  ],
  "tags": [
    "test_item",
    "immediate_payment"
  ],
  "warranty": null,
  "catalog_product_id": null,
  "domain_id": "MLB-CARS_AND_VANS",
  "parent_item_id": null,
  "differential_pricing": null,
  "deal_ids": [
  ],
  "automatic_relist": false,
  "date_created": "2018-06-07T19:03:12.000Z",
  "last_updated": "2018-07-11T23:01:48.000Z",
  "health": null
}


Defining attributes

When you create an item, some of the fields are mandatory, while others can be omitted or we will add them automatically. They will define how the item is displayed, how buyers can buy it and the position in the search results, among other variables.


Title

A good title must be concise, but it must contain the brand, version and number of doors of the vehicle. The words of the title are very important, since these are the ones that coincide with the words searched by the users; Therefore, the greater the coincidence of these words, the greater the return. We advise developers who already self-complete the title for their client, in order to suggest a better title for the publication that will be included. Example: Chevrolet Astra Hatch Advantage 2.0 4P


Description

Detailed information will improve your chances of selling a vehicle and save you time by not having to answer questions. If you are interested in knowing more about this topic, see our item description guide.

Note:
The product description must be in plain text. Don´t should you send contact information, such as the phone number, address and site in this field. In case it is sent, we will accept the publication, but it will be penalized and will be misclassified in searches.


Pictures

Good images can make an item more attractive and offer buyers a more accurate idea of ​​its appearance. Basically, you should add a set of up to six URL images in 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 not to 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 later on, please read more about this topic to know which kind of pictures are allowed and how to work with them on our Working with pictures guide.


Category

Sellers must define a category in Mercado Libre site. This attribute is mandatory and only accepts pre-established IDs. Each category has it’s own attributes for you to work with. Get details in our Categories guide.

{
 ....
  "category_id":"MLA12683",
 ...
}


Price

Price is mandatory. When you define a new item, it should have a price. If you have already defined a price, but you are not satisfied with it, you can modify it later.


Currency

In addition to the price, you must define a currency. This attribute is also mandatory. The currency must be defined using a predefined ID. See examples of the currency resource.


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 site. You should make a mixed call through sites and listing_types resources to know which listing_types are supported. Follow our Listing types and item upgrades guide to know which listing type will suite your vehicle best.


Location

When list a classified item, it is mandatory to submit your location. The Mercado Libre location has 4 levels: country, state, city and neighborhood. You must send at least city or neighborhood. Example:

  location: {
    address_line: "Avenida Jurucê, 436",
    zip_code: "04080011",
    neighborhood: {
      id: "TUxCQklORHduMDB0"
    },
    "city": {
      "id": "TUxCQ1NQLTkxMjE",
    },
    "state": {
    "id": "TUxCUFNBT085N2E4",
    },
    "country": {
    "id": "BR",
    },
  },

Remember to send the ID of each sent location, according to the preceding example. For the “address_line” field, always send the street followed by the number (the street number should always be the last information sent in this field. Correct example: Jurucê Avenue, 436 Incorrect example: Jurucê Avenue, 436 Moema. You can learn more about Location codes of Mercado Libre.


Seller contacts

They are the contact details of the seller that owns the ad. These values ​​are optional and, if not informed, Mercado Libre will use the seller's account information. Example:

  seller_contact: {
    contact: "Nome Contato Teste",
    area_code: "11",
    phone: "4444-5555",
    area_code2: "21",
    phone2: "1111-3333",
    email: "contact-email@somedomain.com",
  },
Note:
When there are questions from buyers in the ads, Mercado Libre sends them to the seller's email (entered in the seller_contact.email field). In case you are not informed, Mercado Libre will use the email of the seller's account on the site.


Available_quantity

“1” must always be sent. Represents the number of articles in this ad. In Mercado Libre, classified listings do not work with stocks, each ad represents a unique real estate/vehicle/service registry.


Condition

It can be "new" or "used", depending on the condition of the ad to be sent.


List a motors item

You’re ready to list your first classified 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 Authentication and authorization tutorial. In addition, we highly recommended you validate the JSON you’re sending before making a POST. You can create a JSON for your item basing on the following example, or just send it and you’ll be listing a sample vehicle on the site:

curl -X POST -H "Content-Type: application/json" -d 
{
  "title": "ANUNCIO TESTE PROVA CARRO - NAO COMPRAR",
  "description": {plain_text: "Veículo em ótimo estado \n"},
    "pictures": [
    {
      "source":"https://cdn.pixabay.com/photo/2017/06/15/04/13/car-2404064__340.png"
    },
    {
      "source":"https://cdn.pixabay.com/photo/2018/03/06/19/44/mercedes-benz-3204364__340.png"
    },
  ],
  "category_id": "MLB76395",
  "price": "100000",
  "currency_id": "BRL",
  "listing_type_id": "silver",
  "available_quantity": "1",

  "location": {
    "address_line": "Avenida Juruce, 436",
    "zip_code": "04080011",
    "city": {
      "id": "BR-SP-56"
    }
  },
  
  
  "attributes": [
    {
      "id": "VEHICLE_YEAR",
      "value_name": "2012"
    },
    {
      "id": "DOORS",
      "value_name": "4"
    },
    {
      "id": "KILOMETERS",
      "value_name": "92000km"
    },
    {
      "id": "FUEL_TYPE",
      "value_name": "Gasolina"
    },
    {
      "id": "COLOR",
      "value_name": "Preto"
    },
    {
      "id": "STEERING",
      "value_name": "Elétrica"
    },
    {
      "id": "CONTACT_SCHEDULE",
      "value_name": "Me procurar a tarde"
    },
    {
      "id": "TRANSMISSION",
      "value_name": "Automática"
    },
    {
      "id": "TRACTION_CONTROL",
      "value_name": "Dianteira"
    },
    {
      "id": "ARMORED",
      "value_name": "Sim"
    },
    {
      "id": "HAS_ABS_BRAKES",
      "value_name": "Sim"
    },
    {
      "id": "HAS_AIR_CONDITIONING",
      "value_name": "Sim"
    },
    {
      "id": "HAS_ALARM",
      "value_name": "Sim"
    },
    {
      "id": "HAS_ALLOY_WHEELS",
      "value_name": "Sim"
    },
    {
      "id": "HAS_AMFM_RADIO",
      "value_name": "Sim"
    },
    {
      "id": "HAS_AUXILIARY_PORT",
      "value_name": "Sim"
    },
    {
      "id": "ITEM_CONDITION",
      "value_name": "Novo"
    },
    {
      "id": "LICENSE_PLATE",
      "value_name": "EWP5306"
    },
    {
      "id": "PASSENGER_CAPACITY",
      "value_name": "8"
    },
        {
      "id": "TRIM",
      "value_name": "XRS"
    },
    {
      "id": " SINGLE_OWNER",
      "value_name": "Sim"
    },
    {
      "id": " HAS_WINDSCREEN_WIPER",
      "value_name": "Sim"
    },
    {
      "id": " HAS_USB",
      "value_name": "Sim"
    }
    ,
    {
      "id": " HAS_STEERING_WHEEL_CONTROL",
      "value_name": "Sim"
    }
    ,
    {
      "id": " HAS_POWER_DOOR_LOCKS",
      "value_name": "Sim"
    },
    {
      "id": " HAS_POWER_WINDOWS",
      "value_name": "Sim"
    },
    {
      "id": " HAS_RAIN_SENSOR",
      "value_name": "Sim"
    },
    {
      "id": " HAS_REAR_FOGLIGHTS",
      "value_name": "Sim"
    },
    {
      "id": " HAS_HEIGHT_ADJUSTABLE_DRIVER_SEAT",
      "value_name": "Sim"
    },
    {
      "id": " HAS_SLIDING_ROOF",
      "value_name": "Sim"
    },
    {
      "id": " HAS_LEATHER_UPHOLSTERY",
      "value_name": "Sim"
    },
    {
      "id": " HAS_LIGHT_ON_REMINDER",
      "value_name": "Sim"
    },
    {
      "id": " HAS_MP3_PLAYER",
      "value_name": "Sim"
    },
    {
      "id": " HAS_ONBOARD_COMPUTER",
      "value_name": "Sim"
    },
    {
      "id": " HAS_PARKING_SENSOR",
      "value_name": "Sim"
    },
    {
      "id": " HAS_PASSENGER_AIRBAG",
      "value_name": "Sim"
    },
    {
      "id": " TRANSMISSION",
      "value_name": "Automática"
    },
    {
      "id": " VEHICLE_BODY_TYPE",
      "value_name": "Minivan"
    },
    {
      "id": " HEIGHT",
      "value_name": "1625 mm"
    },
    {
      "id": " WIDTH",
      "value_name": "1800 mm"
    },
    {
      "id": " DISTANCE_BETWEEN_AXES",
      "value_name": "2570 mm"
    },
    {
      "id": " FUEL_CAPACITY",
      "value_name": "54 L"
    },
    {
      "id": " LENGTH",
      "value_name": "4140 mm"
    }
    ,
    {
      "id": " VALVES_PER_CYLINDER",
      "value_name": "4"
    }
    ,
    {
      "id": " GEAR_NUMBER",
      "value_name": "6"
    }
    ,
    {
      "id": " HAS_CURTAIN_AIRBAG",
      "value_name": "Sim"
    }
    ,
    {
      "id": " HAS_FOG_LIGHT",
      "value_name": "Sim"
    }
    ,
    {
      "id": " HAS_REAR_FOLDING_SEAT",
      "value_name": "Sim"
    },
    {
      "id": " HAS_ELECTRIC_MIRRORS",
      "value_name": "Sim"
    },
    {
      "id": " HAS_AUTOPILOT",
      "value_name": "Sim"
    }
  ]
}

The previous example only works in MLB (Brazil). In case you are working in any other country, you must substitute the values ​​of category_id, currency_id and maybe listing_type_id. When performing the previous POST, the Mercado Libre API will send you the return JSON with the information of the created item. One of the returned fields is the permalink, which contains the link to the details page of the newly created ad. Answer example:

{
    "id": "MLB1045563828",
    "site_id": "MLB",
    "title": "Anuncio Teste Prova Carro - Nao Comprar",
    "subtitle": null,
    "seller_id": 307415664,
    "category_id": "MLB76395",
    "official_store_id": null,
    "price": 100000,
    "base_price": 100000,
    "original_price": null,
    "currency_id": "BRL",
    "initial_quantity": 1,
    "available_quantity": 1,
    "sold_quantity": 0,
    "sale_terms": [
        {
            "id": "RESERVATION_PRICE",
            "name": "Valor de reserva",
            "value_id": null,
            "value_name": "1000 BRL",
            "value_struct": {
                "number": 1000,
                "unit": "BRL"
            }
        }
    ],
    "buying_mode": "classified",
    "listing_type_id": "silver",
    "start_time": "2018-06-07T19:03:11.349Z",
    "stop_time": "2018-06-10T04:00:00.000Z",
    "end_time": "2018-06-10T04:00:00.000Z",
    "expiration_time": null,
    "condition": "used",
    "permalink": "http://carro.mercadolivre.com.br/MLB-1045563828-anuncio-teste-prova-carro-nao-comprar-_JM",
    "pictures": [
        {
            "id": "825249-MLB27519106301_062018",
            "url": "http://www.mercadolibre.com/jm/img?s=STC&v=O&f=proccesing_image_pt.jpg",
            "secure_url": "https://www.mercadolibre.com/jm/img?s=STC&v=O&f=proccesing_image_pt.jpg",
            "size": "500x500",
            "max_size": "500x500",
            "quality": ""
        },
        {
            "id": "632976-MLB27519106300_062018",
            "url": "http://www.mercadolibre.com/jm/img?s=STC&v=O&f=proccesing_image_pt.jpg",
            "secure_url": "https://www.mercadolibre.com/jm/img?s=STC&v=O&f=proccesing_image_pt.jpg",
            "size": "500x500",
            "max_size": "500x500",
            "quality": ""
        }
    ],
    "video_id": null,
    "descriptions": [
        {
            "id": "MLB1045563828-1704138112"
        }
    ],
    "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": null,
        "store_pick_up": false
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "id": 801390510,
        "comment": "",
        "address_line": "Rua Dantas Bião 43",
        "zip_code": "48030030",
        "city": {
            "id": "TUxCQ0FMQTlkMWUy",
            "name": "Alagoinhas"
        },
        "state": {
            "id": "BR-BA",
            "name": "Bahia"
        },
        "country": {
            "id": "BR",
            "name": "Brasil"
        },
        "latitude": -23.6091318,
        "longitude": -46.6616978,
        "search_location": {
            "neighborhood": {
                "id": "",
                "name": ""
            },
            "city": {
                "id": "TUxCQ0FMQTlkMWUy",
                "name": "Alagoinhas"
            },
            "state": {
                "id": "TUxCUEJBSEFlYmEx",
                "name": "Bahia"
            }
        }
    },
    "seller_contact": {
        "contact": "",
        "other_info": "",
        "area_code": "",
        "phone": "",
        "area_code2": "",
        "phone2": "",
        "email": "",
        "webpage": "",
        "country_code": "",
        "country_code2": ""
    },
    "location": {
        "address_line": "Avenida Jurucë, 436",
        "zip_code": "04080011",
        "neighborhood": {
            "id": "",
            "name": ""
        },
        "city": {
            "id": "BR-SP-56",
            "name": "Atibaia"
        },
        "state": {
            "id": "BR-SP",
            "name": "São Paulo"
        },
        "country": {
            "id": "BR",
            "name": "Brasil"
        },
        "latitude": "",
        "longitude": "",
        "open_hours": ""
    },
    "geolocation": {
        "latitude": "",
        "longitude": ""
    },
    "coverage_areas": [],
    "attributes": [
        {
            "id": "ITEM_CONDITION",
            "name": "Condição do item",
            "value_id": "2230581",
            "value_name": "Usado",
            "value_struct": null,
            "attribute_group_id": "",
            "attribute_group_name": ""
        },
        {
            "id": "STEERING",
            "name": "Direção",
            "value_id": "405719",
            "value_name": "Elétrica",
            "value_struct": null,
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionais"
        },
        {
            "id": "CONTACT_SCHEDULE",
            "name": "Horário de contato",
            "value_id": null,
            "value_name": "Me procurar a tarde",
            "value_struct": null,
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionais"
        },
        {
            "id": "TRANSMISSION",
            "name": "Transmissão",
            "value_id": "370876",
            "value_name": "Automática",
            "value_struct": null,
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionais"
        },
        {
            "id": "SINGLE_OWNER",
            "name": "Único dono",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionais"
        },
        {
            "id": "VEHICLE_BODY_TYPE",
            "name": "Tipo",
            "value_id": "452753",
            "value_name": "Minivan",
            "value_struct": null,
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionais"
        },
        {
            "id": "HAS_AIR_CONDITIONING",
            "name": "Ar-condicionado",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "HAS_POWER_DOOR_LOCKS",
            "name": "Travas elétricas",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "HAS_POWER_WINDOWS",
            "name": "Vidros elétricos",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "HAS_RAIN_SENSOR",
            "name": "Sensor de chuva",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "HAS_HEIGHT_ADJUSTABLE_DRIVER_SEAT",
            "name": "Banco motorista com regulagem de altura",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "HAS_SLIDING_ROOF",
            "name": "Teto solar",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "HAS_LEATHER_UPHOLSTERY",
            "name": "Bancos em couro",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "HAS_LIGHT_ON_REMINDER",
            "name": "Alarme de luzes acesas",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "HAS_ONBOARD_COMPUTER",
            "name": "Computador de bordo",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "HAS_PARKING_SENSOR",
            "name": "Sensor de estacionamento",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "HAS_REAR_FOLDING_SEAT",
            "name": "Banco traseiro retrátil",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "HAS_ELECTRIC_MIRRORS",
            "name": "Retrovisores elétricos",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "HAS_AUTOPILOT",
            "name": "Piloto automático",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "CONFORT",
            "attribute_group_name": "Conforto"
        },
        {
            "id": "LICENSE_PLATE",
            "name": "Placa",
            "value_id": null,
            "value_name": "EWP5306",
            "value_struct": null,
            "attribute_group_id": "DFLT",
            "attribute_group_name": "Outros"
        },
        {
            "id": "PASSENGER_CAPACITY",
            "name": "Quantidade de pessoas",
            "value_id": null,
            "value_name": "8",
            "value_struct": null,
            "attribute_group_id": "DFLT",
            "attribute_group_name": "Outros"
        },
        {
            "id": "HEIGHT",
            "name": "Altura",
            "value_id": null,
            "value_name": "1625 mm",
            "value_struct": {
                "number": 1625,
                "unit": "mm"
            },
            "attribute_group_id": "DFLT",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WIDTH",
            "name": "Largura",
            "value_id": null,
            "value_name": "1800 mm",
            "value_struct": {
                "number": 1800,
                "unit": "mm"
            },
            "attribute_group_id": "DFLT",
            "attribute_group_name": "Outros"
        },
        {
            "id": "DISTANCE_BETWEEN_AXES",
            "name": "Distância entre eixos",
            "value_id": null,
            "value_name": "2570 mm",
            "value_struct": {
                "number": 2570,
                "unit": "mm"
            },
            "attribute_group_id": "DFLT",
            "attribute_group_name": "Outros"
        },
        {
            "id": "FUEL_CAPACITY",
            "name": "Tanque de combustível",
            "value_id": null,
            "value_name": "54 L",
            "value_struct": {
                "number": 54,
                "unit": "L"
            },
            "attribute_group_id": "DFLT",
            "attribute_group_name": "Outros"
        },
        {
            "id": "LENGTH",
            "name": "Comprimento",
            "value_id": null,
            "value_name": "4140 mm",
            "value_struct": {
                "number": 4140,
                "unit": "mm"
            },
            "attribute_group_id": "DFLT",
            "attribute_group_name": "Outros"
        },
        {
            "id": "VALVES_PER_CYLINDER",
            "name": "Válvulas por cilindro",
            "value_id": null,
            "value_name": "4",
            "value_struct": null,
            "attribute_group_id": "DFLT",
            "attribute_group_name": "Outros"
        },
        {
            "id": "GEAR_NUMBER",
            "name": "Número de velocidades",
            "value_id": null,
            "value_name": "6",
            "value_struct": null,
            "attribute_group_id": "DFLT",
            "attribute_group_name": "Outros"
        },
        {
            "id": "HAS_WINDSCREEN_WIPER",
            "name": "Limpador traseiro",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "EXTERIOR",
            "attribute_group_name": "Exterior"
        },
        {
            "id": "VEHICLE_YEAR",
            "name": "Ano",
            "value_id": null,
            "value_name": "2012",
            "value_struct": null,
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "DOORS",
            "name": "Portas",
            "value_id": null,
            "value_name": "4",
            "value_struct": null,
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "KILOMETERS",
            "name": "Quilômetros",
            "value_id": null,
            "value_name": "92000 km",
            "value_struct": {
                "number": 92000,
                "unit": "km"
            },
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "FUEL_TYPE",
            "name": "Tipo de combustível",
            "value_id": "372589",
            "value_name": "Gasolina",
            "value_struct": null,
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "TRIM",
            "name": "Versão",
            "value_id": null,
            "value_name": "XRS",
            "value_struct": null,
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "BRAND",
            "name": "Marca",
            "value_id": "374002",
            "value_name": "Kia",
            "value_struct": null,
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "MODEL",
            "name": "Modelo",
            "value_id": "235012",
            "value_name": "Soul",
            "value_struct": null,
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "VEHICLE_TYPE",
            "name": "Tipo de veículo",
            "value_id": "398351",
            "value_name": "Carros e caminhonetes",
            "value_struct": null,
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "COLOR",
            "name": "Cor",
            "value_id": "52049",
            "value_name": "Preto",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "TRACTION_CONTROL",
            "name": "Controle de tração",
            "value_id": "493979",
            "value_name": "Dianteira",
            "value_struct": null,
            "attribute_group_id": "SECURITY",
            "attribute_group_name": "Segurança"
        },
        {
            "id": "ARMORED",
            "name": "Blindado",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SECURITY",
            "attribute_group_name": "Segurança"
        },
        {
            "id": "HAS_ABS_BRAKES",
            "name": "Freios ABS",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SECURITY",
            "attribute_group_name": "Segurança"
        },
        {
            "id": "HAS_ALARM",
            "name": "Alarme",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SECURITY",
            "attribute_group_name": "Segurança"
        },
        {
            "id": "HAS_ALLOY_WHEELS",
            "name": "Rodas de liga leve",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SECURITY",
            "attribute_group_name": "Segurança"
        },
        {
            "id": "HAS_REAR_FOGLIGHTS",
            "name": "Faróis de neblina traseiros",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SECURITY",
            "attribute_group_name": "Segurança"
        },
        {
            "id": "HAS_PASSENGER_AIRBAG",
            "name": "Airbag passageiro",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SECURITY",
            "attribute_group_name": "Segurança"
        },
        {
            "id": "HAS_CURTAIN_AIRBAG",
            "name": "Airbag de cortina",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SECURITY",
            "attribute_group_name": "Segurança"
        },
        {
            "id": "HAS_FOG_LIGHT",
            "name": "Farol de neblina",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SECURITY",
            "attribute_group_name": "Segurança"
        },
        {
            "id": "HAS_AMFM_RADIO",
            "name": "AM/FM",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SONIDO",
            "attribute_group_name": "Som"
        },
        {
            "id": "HAS_AUXILIARY_PORT",
            "name": "Entrada auxiliar",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SONIDO",
            "attribute_group_name": "Som"
        },
        {
            "id": "HAS_USB",
            "name": "Entrada USB",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SONIDO",
            "attribute_group_name": "Som"
        },
        {
            "id": "HAS_STEERING_WHEEL_CONTROL",
            "name": "Controle de som no volante",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SONIDO",
            "attribute_group_name": "Som"
        },
        {
            "id": "HAS_MP3_PLAYER",
            "name": "MP3 player",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "attribute_group_id": "SONIDO",
            "attribute_group_name": "Som"
        }
    ],
    "warnings": [],
    "listing_source": "",
    "variations": [],
    "thumbnail": "http://www.mercadolibre.com/jm/img?s=STC&v=I&f=proccesing_image_pt.jpg",
    "secure_thumbnail": "https://www.mercadolibre.com/jm/img?s=STC&v=I&f=proccesing_image_pt.jpg",
    "status": "active",
    "sub_status": [],
    "tags": [
        "test_item",
        "immediate_payment"
    ],
    "warranty": null,
    "catalog_product_id": null,
    "domain_id": "MLB-CARS_AND_VANS",
    "seller_custom_field": null,
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2018-06-07T19:03:12.010Z",
    "last_updated": "2018-06-07T19:03:12.010Z",
    "health": null
}


Duplicate items

Each publication should be included only once. Mercado Libre has mechanisms to identify possible duplicate ads. Be careful not to send duplicate publications. In case it is considered that a publication was duplicated, it will be included via API, but will remain with the status “under review”.


Brand, model and version

Mercado Libre has a catalog of brands and models that are represented by their categories. In the previous example, the category used was MLB76395, which represents the “Soul” model. This category is the daughter of the MLB7079 category, which represents the “Kia” brand, for example. For more information on how to work with categories x makes and models, see our category guide for vehicles. Instead, the version is an attribute called "TRIM." This attribute is mandatory and must be sent together with the other attributes, in the “attributes” matrix. This is an open text field, and the integrator must send the version as text type. In the previous example, TRIM = XRS.


Official Stores for Vehicles and Real Estate

See the following guide on Official Stores for Vehicles and Real Estate.