Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação do

Última atualização em 04/12/2023

Publicação de automóveis

Os automóveis constituem o único tipo de publicação que permite aos usuários mostrarem suas informações de contato ao público; por isso, toda vez que os usuários buscam automóveis para alugar ou comprar e se interessam, podem entrar em contato com você imediatamente. Portanto, nos produtos classificados nenhum tipo de transação é realizado.



Consultar automóveis


Vamos ver um automóvel pela API. Isso é fácil, pois você só precisa conhecer o item_id associado a tal item e, como ele é público, pode ser obtido na página do item. Isso é encontrado na parte superior da página. É preciso acrescentar o site_id antes do número que está vendo e pronto. Agora você pode chamar o recurso Items para obter todas as informações de que precisa.
Chamada:

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

Exemplo:

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

Resposta:

{
  "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
}


Atributos

É necessário saber que, ao criar um JSON para seu produto, alguns dos campos são obrigatórios, enquanto outros podem ser omitidos ou serão automaticamente adicionados pelo ML. Eles definirão o modo como o produto será exibido e sua posição nos resultados da busca.

Tenha em mente o seguinte:
Ao criar um artigo, alguns atributos são obrigatórios, enquanto outros podem ser omitidos. Em determinadas situações, com base no catálogo de veículos do Mercado Livre, a plataforma preencherá os atributos do item que o vendedor tenha omitido, com o objetivo de fornecer informações adicionais ao comprador, desde que o veículo esteja dentro do nosso catálogo. Se o vendedor inserir um valor diferente do registrado em nosso catálogo, prevalecerá a informação fornecida pelo vendedor.

Importante:
Para publicar um veículo no Brasil, será obrigatório informar o atributo Placa. Isso, motivado por melhorar a qualidade das publicações e ter cada vez mais veículos verificados.
Nota:
Ao realizar um POST deve ser especificado o channel ao qual está publicando, envie marketplace para não obter erros ao publicar um item de classificados, pode ver o campo no exemplo do POST.


Title

Um bom título deve ser conciso, porém conter a marca, a versão e o número de portas do veículo. As palavras do título são muito importantes, pois são elas que coincidem com aquelas buscadas pelos usuários, então quanto maior a coincidência destas palavras, maior o retorno. Aconselhamos os integradores a já auto-completarem o título para o seu cliente, para já sugerir um melhor título para a publicação a ser incluída. Exemplo: Chevrolet Astra Hatch Advantage 2.0 4P.


Placa

As seguintes recomendações de formato de placa (LICENSE_PLATE) se aplicam ao Brasil:

  • A placa deve corresponder ao veículo publicado (marca, modelo, ano e versão)
  • A placa não deve ser repetida em outra publicação.
  • O número permitido de caracteres é 7 (sem hífen) ou 8 caracteres (com hífen).
  • Os formatos podem ser (A: letras - n: números).

Por exemplo:

  • AAAnnnn: formato antigo, no máximo 7 caracteres, letras e números sem separação por hífen.
  • AAA-nnnn: formato antigo, no máximo 8 caracteres, letras e números separados por hífen.
  • AAAnAnn: formato Mercosur.


Description

Nota:
Para criar a descrição, você deve primeiro criar a publicação sem uma descrição e, em seguida, enviá-la por um POST para o recurso /items/$ITEM_ID/description.

Conheça como carregar a descrição em um item.

Nota:
Considere que a descrição do produto deverá ser em texto sem formato. Também não enviar informação de contato como número de telefone, endereço e site no campo. Caso seja enviado aceitaremos o anúncio, mas, será penalizado e terá um mal classificado nas buscas.

Conheça como consultar uma descrição por meio de um GET para o recurso /items/$ITEM_ID/description:


Chamada:

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

Exemplo:

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

Resposta:

{
  "text": "",
  "plain_text": "Texto TEST".
  "date_created": "2021-08-20T22:58:02.000Z",
  "snapshot": {}
}


Pictures

Imagens de boa qualidade podem fazer com que seu automóvel seja mais atrativo e dão aos usuários uma ideia mais precisa de como ele é. Basicamente, você deve adicionar um conjunto de até seis imagens URL no 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"}
 ]
 ...
}

Recomendamos não usar servidores lentos para hospedar suas imagens, pois pode gerar inconvenientes ao fazer a publicação. Você também pode adicionar ou alterar as imagens de seu produto aqui posteriormente.Leia mais sobre isso para saber quais são os tipos de imagens permitidas e como trabalhar com elas.



Category

Antes de publicar, os vendedores devem definir uma categoria no site do Mercado Libre utilizando um ID predefinido. Portanto, recomendamos que você use o preditor de categorias para obter a categoria apropriada. Lembre-se de que marca e modelo são atualmente atributos obrigatórios.

A seguir, ilustramos a mudança no fluxo de publicação de itens do veículo:


Nota:
No fluxo, você pode ver um exemplo dos 2 níveis disponíveis e os atributos obrigatórios marca e modelo.

Para as categorias Motocicletas e Náutica, que anteriormente tinham um nível a mais do que os outros para especificar o tipo de veículo, também passarão a ter 2 níveis e um novo atributo para especificar o tipo: moto_type e vehicle_type.



Price

Este atributo é obrigatório. Ao definir um novo anúncio, ele deve ter um preço. Se você já tiver definido um preço, mas não está satisfeito com ele, poderá alterá-lo posteriormente.



Currency

Além do preço, você deverá definir uma moeda. Esse atributo também é obrigatório. A moeda deverá ser definida usando um ID pré-estabelecido.Veja exemplos do recurso de moedas.



Tipo de anúncio

Basicamente é o plano contratado pelo seu cliente. Trata-se de outro caso de atributo obrigatório que só aceita valores pré-definidos e é muito importante que você entenda isso. Existem diferentes tipos de publicação disponíveis para cada site. Você deve fazer uma chamada mista através dos sites e dos recursos listing_types para saber quais são os listing_types aceitos. Siga nosso guia para saber qual o tipo de publicação mais conveniente para seu anúncio.



Localização

Ao publicar um anúncio classificado, é obrigatório enviar sua localização. A localização do Mercado Livre possui 4 níveis: country, state, city e neighborhood. Você deve enviar pelo menos city ou neighborhood.

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

Lembre-se sempre de enviar o id de cada localização enviada, conforme o exemplo acima. Para o campo “address_line”, envie sempre o logradouro seguido do número (o número do logradouro deve sempre ser a última informação enviada neste campo. Exemplo correto: Avenida Jurucê, 436 Exemplo incorreto: Avenida Jurucê, 436 Moema Para saber como consultar os códigos de localizações do Mercado Livre, acesse Localização de veículos.



Contatos do vendedor

São os dados de contato do vendedor dono do anúncio. Estes valores são opcionais, e se não informados, o Mercado Livre irá utilizar os dados da conta do vendedor.

  seller_contact: {
    contact: "Nome Contato Teste",
    area_code: "11",
    phone: "4444-5555",
    area_code2: "21",
    phone2: "1111-3333",
    email: "contact-email@somedomain.com",
  },
Nota:
Quando ocorrem perguntas de compradores nos anúncios, o Mercado Livre as envia para o e-mail do vendedor (confirmado no campo seller_contact.email). Caso não seja informado, o Mercado Livre irá utilizar o email da conta do vendedor no site.
Caso o campo esteja como "seller_contact": "not_allowed", a categoria não permitirá atualizar esta informação.Os campos country_code2, area_code2, phone2 podem ser usados ​​para que o vendedor receba contatos via WhatsApp.


Available_quantity

Deve ser sempre enviado “1”. Representa a quantidade de itens deste anúncio. No Mercado Livre, os anúncios classificados não trabalham com estoque, cada anúncio representa um registro de imóvel / veículo / serviço único.



Condition

Pode ser “new” ou “used”, dependendo da condição do anúncio a ser enviado.



Publicação de automóveis

Agora você já está pronto para publicar seu primeiro item classificado.

Lembre de que, para isso, você vai precisar de um access_token. Se você tiver dúvidas sobre como obter seu token de acesso, retorne ao tutorial de autenticação. Também recomendamos usar usuários de teste para publicar artigos de teste. Se você não estiver familiarizado com eles, consulte a seção gerar usuários de teste aqui.

Além disso, recomendamos validar o JSON enviado antes de fazer a solicitação POST; Portanto, é melhor você conferir este tutorial de validação de artigo, que é fácil e rápido. Você pode criar um JSON para o seu veículo com base no exemplo abaixo, ou simplesmente enviá-lo, e você estará publicando um produto de amostra no 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/items
Nota:
Para publicar o item com vídeo do Youtube, você deve usar o campo video_id na publicação informando o string correspondente ao id do recurso multimídia e um identificador do provedor ou plataforma relacionada ao recurso. Assim, por exemplo: “video_id”:“gqkEN9poKM;youtube”.

Observe que o exemplo acima só funciona no MLB (Brasil). Caso você esteja trabalhando em qualquer outro país, deverá substituir os valores de category_id, currency_id e talvez listing_type_id. Ao realizar o POST acima, a API do Mercado Livre irá te enviar o JSON de retorno com as informações do item criado. Um dos campos retornados é o permalink, que contém o link para a página de detalhes do anúncio recém-criado.

{
    "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.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
}


Anúncios duplicados

Cada publicação deve ser incluída uma única vez. O Mercado Livre possui mecanismos para identificar possíveis anúncios duplicados. Fique atento para não enviar publicações duplicadas. Caso uma publicação seja considerada duplicada, ela será incluída via API, mas ficará no status “under review”.



Itens penalizados

Itens penalizados precisam de atenção por parte do vendedor para que voltem a ter uma boa exposição ou, em casos mais graves, não sejam pausados. Para identificar estes itens para domínios de Veículos e Imóveis, disponibilizamos 2 tags com os seguintes motivos de penalização:


  • misplaced_personal_data : Item penalizado por dados pessoais em campos não indicados.
  • moderation_penalty : item penalizado. Neste caso, por se tratar de uma tag genérica, é necessário buscar o motivo da moderação no recurso /infractions.

Para listar os itens nessas condições é possível utilizar o seguinte GET:

Chamada:

curl --location --request GET 'https://api.mercadolibre.com/users/$USER_ID/items/search?tags=$TAG' \
--header 'Authorization: Bearer $ACCESS_TOKEN'

Exemplo:

curl --location --request GET 'https://api.mercadolibre.com/users/705332753/items/search?tags=misplaced_personal_data' \
--header 'Authorization: Bearer $ACCESS_TOKEN'

Resposta:

{

   "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"
       }
   ]
}
}


Marca, modelo e versão

Marca e modelo são atributos obrigatórios saiba mais sobre categorias e atributos), mas versão é um atributo denominado “TRIM”. Este atributo também é obrigatório e deve ser enviado com os outros atributos na matriz "atributos". Este é um campo de texto aberto e o integrador deve enviar a versão como tipo de texto. No exemplo acima, TRIM = XRS.


Lojas Oficiais para Veículos e Imóveis

Consulte a documentação Lojas Oficiais para Veículos e Imóveis.



Publicar na categoria Motos transacionais

Nota:
Publicar motos transacionais nos sites México, Argentina, Colômbia, Brasil e Uruguai só será permitido para vendedores autorizados.

Os category_id de Motos transacionais são: MLM455863, MLA455863, MCO455863, MLB455863 y MLU455863 respectivamente de acordo com o site. Caso o vendedor não seja um vendedor autorizado, você receberá o erro: moderations.seller_id.not_authorized - Seller is not authorized for this brand and category. Caso o cliente não esteja autorizado, o cliente deve entrar em contato com o executivo comercial do Mercado Livre que lhe foi designado.



Configurar pacote para usuários teste

Para adicionar um pacote para publicações de teste, carregue os dados do seu usuário de teste no formulário.


Próxima: Sincronização de publicações