Documentação do Mercado Livre
Confira todas as informações necessárias sobre as APIs Mercado Livre.
Documentação do
Última atualização em 31/10/2023
List vehicles
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
Plate
The following license plate format recommendations (LICENSE_PLATE) apply to Brazil:
- The license plate must correspond to the vehicle you are publishing (brand, model, year and version).
- The license plate must not be repeated in another advertisement.
- The expected length is 7 characters (without hyphen) or 8 (with hyphen).
- The formats can be (A: Letters - n: Numbers).
For example:
- AAAnnnn: Old format, length 7, letters and numbers without hyphenation.
- AAA-nnnn: Old format, length 8, letters and numbers separated by a hyphen.
- AAAnAnn: Mercosur format.
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.
We also recommend using test users to publish test articles. If you are not familiar with them,
please refer to the section on generating test users here.
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",
"channels":
[
"marketplace"
],
"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”.
Penalized items
Penalized items need the seller's attention in order to have a good exposure or, in serious cases, not to be paused. To identify these items for the Vehicle and Real Estate domains, we provide 2 tags with the following penalty reasons:
- misplaced_personal_data: item penalized for personal data in fields not indicated.
- moderation_penalty : Penalized item. In this case, being a generic tag, it is necessary to query the /infractions resource to know the reason.
To list items in this condition, it is possible to use GET:
Request:
curl --location --request GET 'https://api.mercadolibre.com/users/$USER_ID/items/search?tags=$TAG' \
--header 'Authorization: Bearer $ACCESS_TOKEN'Example:
curl --location --request GET 'https://api.mercadolibre.com/users/705332753/items/search?tags=misplaced_personal_data' \
--header 'Authorization: Bearer $ACCESS_TOKEN'Response:
{
"seller_id": "705332753",
"query": null,
"paging": {
"limit": 50,
"offset": 0,
"total": 1
},
"results": [
"MLB1790900231"
],
"orders": [
{
"id": "stop_time_asc",
"name": "Order by stop time ascending"
}
],
"available_orders": [
{
"id": "stop_time_asc",
"name": "Order by stop time ascending"
},
{
"id": "stop_time_desc",
"name": "Order by stop time descending"
},
{
"id": "start_time_asc",
"name": "Order by start time ascending"
},
{
"id": "start_time_desc",
"name": "Order by start time descending"
},
{
"id": "available_quantity_asc",
"name": "Order by available quantity ascending"
},
{
"id": "available_quantity_desc",
"name": "Order by available quantity descending"
},
{
"id": "sold_quantity_asc",
"name": "Order by sold quantity ascending"
},
{
"id": "sold_quantity_desc",
"name": "Order by sold quantity descending"
},
{
"id": "price_asc",
"name": "Order by price ascending"
},
{
"id": "price_desc",
"name": "Order by price descending"
},
{
"id": "last_updated_desc",
"name": "Order by lastUpdated descending"
},
{
"id": "last_updated_asc",
"name": "Order by last updated ascending"
},
{
"id": "total_sold_quantity_asc",
"name": "Order by total sold quantity ascending"
},
{
"id": {
"id": "total_sold_quantity_desc",
"field": "sold_quantity",
"missing": "_last",
"order": "desc"
},
"name": "Order by total sold quantity descending"
},
{
"id": {
"id": "inventory_id_asc",
"field": "inventory_id",
"missing": "_last",
"order": "asc"
},
"name": "Order by inventory id ascending"
}
]
}
}
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.
Publish in category Transactional motorcycles
Transactional Motorcycles category_id are: MLM455863, MLA455863, MCO455863, MLB455863 and MLU455863 respectively according to the site. In case the seller is not authorized, you will receive the error: moderations.seller_id.not_authorized - Seller is not authorized for this brand and category. If the customer is not authorized, he should contact the Mercado Libre sales executive assigned to him.
Configure package for test user
To add a package for test publications, upload your test user data in the form.
Next: Sync listintgs.