List vehicles
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 -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/MLB1045563828Response:
{
"id": "MLB1045563828",
"site_id": "MLB",
"title": "Anuncio Teste Prova Carro - Nao Comprar",
"subtitle": null,
"seller_id": 307415664,
"category_id": "MLB1744",
"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.
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
Before publishing items, sellers must define a category on the Mercado Libre site and it accepts a preset ID. Therefore, we recommend that you use the category predictor to obtain the appropriate category. Remember that brand and model are currently mandatory attributes. Below, we illustrate the change in the flow of publication of vehicle items:
For the Motorcycles and Nautical categories, which previously had one level more than the others to specify the type of vehicle, they also have 2 levels and a new attribute to specify the type: moto_type and vehicle_type.
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",
},
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 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
{
"title": "ANUNCIO TESTE PROVA CARRO - NAO COMPRAR",
"description": "Veículo em ótimo estado",
"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"
},
],
"video_id": "sJLCxVgshzY"
"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": "BRAND",
"value_name": "Kia"
},
{
"id": "MODEL",
"value_name": "Soul"
},
{
"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"
}
]
}
https://api.mercadolibre.com/itemsThe 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": "sJLCxVgshzY",
"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
Brand and model are required attributes (learn more about categories and attributes) but version is an attribute named “TRIM”. This attribute is also required and must be submitted together with the other attributes in the "attributes" array. This is an open text field and the integrator must send the version as text type. In the example above, TRIM = XRS.
Official Stores for Vehicles and Real Estate
See the following guide on Official Stores for Vehicles and Real Estate.
