Documentação do Mercado Livre
Confira todas as informações necessárias sobre as APIs Mercado Livre.
Documentação do
Última atualização em 21/07/2026
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_IDExemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLB4277151191Resposta:
{
"id": "MLB4277151191",
"site_id": "MLB",
"title": "Anuncio Teste Carro",
"family_name": null,
"seller_id": 1944040506,
"category_id": "MLB1744",
"user_product_id": "MLBU3517669871",
"official_store_id": null,
"price": 150000,
"base_price": 150000,
"original_price": null,
"inventory_id": null,
"currency_id": "BRL",
"initial_quantity": 1,
"available_quantity": 1,
"sold_quantity": 0,
"sale_terms": [
{
"id": "WITH_FINANCING_OPTIONS",
"name": "Com opções de financiamento",
"value_id": "242085",
"value_name": "Sim",
"value_struct": null,
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "IS_FINANCEABLE",
"name": "É financiável",
"value_id": "242084",
"value_name": "Não",
"value_struct": null,
"values": [
{
"id": "242084",
"name": "Não",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "IS_FINANCEABLE_VEHICLE_RISK_PROFILE",
"name": "É o perfil de risco veicular financiável",
"value_id": "242084",
"value_name": "Não",
"value_struct": null,
"values": [
{
"id": "242084",
"name": "Não",
"struct": null
}
],
"value_type": "boolean"
}
],
"buying_mode": "classified",
"listing_type_id": "silver",
"start_time": "2025-10-28T15:18:33.656Z",
"stop_time": "2026-10-28T04:00:00.000Z",
"end_time": "2026-10-28T04:00:00.000Z",
"expiration_time": "2026-01-16T15:18:33.821Z",
"condition": "used",
"permalink": "https://carro.mercadolivre.com.br/MLB-4277151191-anuncio-teste-carro-nao-comprar-3-_JM",
"thumbnail_id": "859393-MLB92379478091_092025",
"thumbnail": "http://http2.mlstatic.com/D_859393-MLB92379478091_092025-I.jpg",
"pictures": [
{
"id": "859393-MLB92379478091_092025",
"url": "http://http2.mlstatic.com/D_859393-MLB92379478091_092025-O.jpg",
"secure_url": "https://http2.mlstatic.com/D_859393-MLB92379478091_092025-O.jpg",
"size": "500x375",
"max_size": "1200x900",
"quality": ""
}
],
"video_id": "sJLCxVgshzY",
"descriptions": [],
"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": {
"id": 0
},
"seller_contact": {
"contact": "",
"other_info": "",
"country_code": "",
"area_code": "",
"phone": "",
"country_code2": "",
"area_code2": "",
"phone2": "",
"email": "",
"webpage": ""
},
"location": {
"address_line": "Avenida Juruce, 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": -23.6091774,
"longitude": -46.6618734
},
"geolocation": {
"latitude": -23.6091774,
"longitude": -46.6618734
},
"coverage_areas": [],
"attributes": [
{
"id": "HAS_POWER_DOOR_LOCKS",
"name": "Travas elétricas de portas",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "ITEM_CONDITION",
"name": "Condição do item",
"value_id": "2230581",
"value_name": "Usado",
"values": [
{
"id": "2230581",
"name": "Usado",
"struct": null
}
],
"value_type": "list"
},
{
"id": "SELLER_PACKAGE_HEIGHT",
"name": "Altura da embalagem do vendor",
"value_id": null,
"value_name": "21 cm",
"values": [
{
"id": null,
"name": "21 cm",
"struct": {
"number": 21,
"unit": "cm"
}
}
],
"value_type": "number_unit"
},
{
"id": "SELLER_PACKAGE_LENGTH",
"name": "Comprimento da embalagem do vendor",
"value_id": null,
"value_name": "6 cm",
"values": [
{
"id": null,
"name": "6 cm",
"struct": {
"number": 6,
"unit": "cm"
}
}
],
"value_type": "number_unit"
},
{
"id": "SELLER_PACKAGE_TYPE",
"name": "Tipo da embalagem do vendor",
"value_id": "47115156",
"value_name": "Com embalagem adicional",
"values": [
{
"id": "47115156",
"name": "Com embalagem adicional",
"struct": null
}
],
"value_type": "string"
},
{
"id": "SELLER_PACKAGE_WEIGHT",
"name": "Peso da embalagem do vendor",
"value_id": null,
"value_name": "179 g",
"values": [
{
"id": null,
"name": "179 g",
"struct": {
"number": 179,
"unit": "g"
}
}
],
"value_type": "number_unit"
},
{
"id": "SELLER_PACKAGE_WIDTH",
"name": "Largura da embalagem do vendor",
"value_id": null,
"value_name": "15 cm",
"values": [
{
"id": null,
"name": "15 cm",
"struct": {
"number": 15,
"unit": "cm"
}
}
],
"value_type": "number_unit"
},
{
"id": "CONTACT_SCHEDULE",
"name": "Horário de contato",
"value_id": null,
"value_name": "Me procurar à tarde",
"values": [
{
"id": null,
"name": "Me procurar à tarde",
"struct": null
}
],
"value_type": "string"
},
{
"id": "ENGINE",
"name": "Motor",
"value_id": "2164443",
"value_name": "1.6",
"values": [
{
"id": "2164443",
"name": "1.6",
"struct": null
}
],
"value_type": "string"
},
{
"id": "SINGLE_OWNER",
"name": "Único dono",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "STEERING",
"name": "Direção",
"value_id": "405719",
"value_name": "Elétrica",
"values": [
{
"id": "405719",
"name": "Elétrica",
"struct": null
}
],
"value_type": "list"
},
{
"id": "TRANSMISSION",
"name": "Transmissão",
"value_id": "370876",
"value_name": "Automática",
"values": [
{
"id": "370876",
"name": "Automática",
"struct": null
}
],
"value_type": "list"
},
{
"id": "VEHICLE_BODY_TYPE",
"name": "Tipo de carroceria",
"value_id": "452753",
"value_name": "Minivan",
"values": [
{
"id": "452753",
"name": "Minivan",
"struct": null
}
],
"value_type": "list"
},
{
"id": "HAS_AIR_CONDITIONING",
"name": "Ar-condicionado",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_COASTERS",
"name": "Porta copos",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_ELECTRIC_MIRRORS",
"name": "Controle elétrico para os retrovisores",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_HEIGHT_ADJUSTABLE_DRIVER_SEAT",
"name": "Banco motorista com regulagem de altura",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_LEATHER_UPHOLSTERY",
"name": "Bancos em couro",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_LIGHT_ON_REMINDER",
"name": "Alarme de luzes acesas",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_ONBOARD_COMPUTER",
"name": "Computador de bordo",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_PARKING_SENSOR",
"name": "Sensor de estacionamento",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_POWER_WINDOWS",
"name": "Vidros elétricos",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_RAIN_SENSOR",
"name": "Sensor de chuva",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_REAR_FOLDING_SEAT",
"name": "Banco traseiro retrátil",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_SLIDING_ROOF",
"name": "Teto solar elétrico retrátil",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "DISTANCE_BETWEEN_AXES",
"name": "Distância entre eixos",
"value_id": null,
"value_name": "2570 mm",
"values": [
{
"id": null,
"name": "2570 mm",
"struct": {
"number": 2570,
"unit": "mm"
}
}
],
"value_type": "number_unit"
},
{
"id": "ENGINE_DISPLACEMENT",
"name": "Cilindrada",
"value_id": "969897",
"value_name": "1600 cc",
"values": [
{
"id": "969897",
"name": "1600 cc",
"struct": {
"number": 1600,
"unit": "cc"
}
}
],
"value_type": "number_unit"
},
{
"id": "FUEL_CAPACITY",
"name": "Tanque de combustível",
"value_id": null,
"value_name": "54 L",
"values": [
{
"id": null,
"name": "54 L",
"struct": {
"number": 54,
"unit": "L"
}
}
],
"value_type": "number_unit"
},
{
"id": "GEAR_NUMBER",
"name": "Número de velocidades",
"value_id": "458574",
"value_name": "6",
"values": [
{
"id": "458574",
"name": "6",
"struct": null
}
],
"value_type": "number"
},
{
"id": "HAS_PAINTED_FRONT_BUMPER",
"name": "Para-choque dianteiro com friso na cor do veículo",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_PAINTED_REAR_BUMPER",
"name": "Para-choque traseiro com friso na cor do veículo",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_POWER_FRONT_WINDOWS",
"name": "Vidros elétricos dianteiros",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_POWER_REAR_WINDOWS",
"name": "Vidros elétricos traseiros",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HEIGHT",
"name": "Altura",
"value_id": null,
"value_name": "1625 mm",
"values": [
{
"id": null,
"name": "1625 mm",
"struct": {
"number": 1625,
"unit": "mm"
}
}
],
"value_type": "number_unit"
},
{
"id": "LENGTH",
"name": "Comprimento",
"value_id": null,
"value_name": "4140 mm",
"values": [
{
"id": null,
"name": "4140 mm",
"struct": {
"number": 4140,
"unit": "mm"
}
}
],
"value_type": "number_unit"
},
{
"id": "LICENSE_PLATE",
"name": "Placa",
"value_id": null,
"value_name": "EWP5306",
"values": [
{
"id": null,
"name": "EWP5306",
"struct": null
}
],
"value_type": "string"
},
{
"id": "PASSENGER_CAPACITY",
"name": "Quantidade de pessoas",
"value_id": null,
"value_name": "8",
"values": [
{
"id": null,
"name": "8",
"struct": null
}
],
"value_type": "number"
},
{
"id": "POWER",
"name": "Potência",
"value_id": "458986",
"value_name": "126 hp",
"values": [
{
"id": "458986",
"name": "126 hp",
"struct": {
"number": 126,
"unit": "hp"
}
}
],
"value_type": "number_unit"
},
{
"id": "SHORT_VERSION",
"name": "Versões",
"value_id": "1051889",
"value_name": "Ex",
"values": [
{
"id": "1051889",
"name": "Ex",
"struct": null
}
],
"value_type": "string"
},
{
"id": "VALVES_PER_CYLINDER",
"name": "Válvulas por cilindro",
"value_id": "970236",
"value_name": "4",
"values": [
{
"id": "970236",
"name": "4",
"struct": null
}
],
"value_type": "number"
},
{
"id": "WIDTH",
"name": "Largura",
"value_id": null,
"value_name": "1800 mm",
"values": [
{
"id": null,
"name": "1800 mm",
"struct": {
"number": 1800,
"unit": "mm"
}
}
],
"value_type": "number_unit"
},
{
"id": "HAS_WINDSCREEN_WIPER",
"name": "Limpador traseiro",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "BRAND",
"name": "Marca",
"value_id": "374002",
"value_name": "Kia",
"values": [
{
"id": "374002",
"name": "Kia",
"struct": null
}
],
"value_type": "string"
},
{
"id": "DOORS",
"name": "Portas",
"value_id": null,
"value_name": "4",
"values": [
{
"id": null,
"name": "4",
"struct": null
}
],
"value_type": "number"
},
{
"id": "FUEL_TYPE",
"name": "Tipo de combustível",
"value_id": "64364",
"value_name": "Gasolina",
"values": [
{
"id": "64364",
"name": "Gasolina",
"struct": null
}
],
"value_type": "list"
},
{
"id": "KILOMETERS",
"name": "Quilômetros",
"value_id": null,
"value_name": "92000 km",
"values": [
{
"id": null,
"name": "92000 km",
"struct": {
"number": 92000,
"unit": "km"
}
}
],
"value_type": "number_unit"
},
{
"id": "MODEL",
"name": "Modelo",
"value_id": "235012",
"value_name": "Soul",
"values": [
{
"id": "235012",
"name": "Soul",
"struct": null
}
],
"value_type": "string"
},
{
"id": "TRIM",
"name": "Versão",
"value_id": null,
"value_name": "XRS",
"values": [
{
"id": null,
"name": "XRS",
"struct": null
}
],
"value_type": "string"
},
{
"id": "VEHICLE_TYPE",
"name": "Tipo de veículo",
"value_id": "398351",
"value_name": "Carros e caminhonetes",
"values": [
{
"id": "398351",
"name": "Carros e caminhonetes",
"struct": null
}
],
"value_type": "string"
},
{
"id": "VEHICLE_YEAR",
"name": "Ano",
"value_id": "436707",
"value_name": "2012",
"values": [
{
"id": "436707",
"name": "2012",
"struct": null
}
],
"value_type": "number"
},
{
"id": "COLOR",
"name": "Cor",
"value_id": "52049",
"value_name": "Preto",
"values": [
{
"id": "52049",
"name": "Preto",
"struct": null
}
],
"value_type": "string"
},
{
"id": "CURRENCY",
"name": "Moeda",
"value_id": "10837729",
"value_name": "r$",
"values": [
{
"id": "10837729",
"name": "r$",
"struct": null
}
],
"value_type": "string"
},
{
"id": "FIPE_BRAND",
"name": "Marca FIPE",
"value_id": "8072705",
"value_name": "kia motors",
"values": [
{
"id": "8072705",
"name": "kia motors",
"struct": null
}
],
"value_type": "string"
},
{
"id": "FIPE_CODE",
"name": "Código FIPE",
"value_id": "7771393",
"value_name": "018071-8",
"values": [
{
"id": "7771393",
"name": "018071-8",
"struct": null
}
],
"value_type": "string"
},
{
"id": "FIPE_MODEL",
"name": "Modelo FIPE",
"value_id": "8590942",
"value_name": "soul 1.6/ 1.6 16v flex mec.",
"values": [
{
"id": "8590942",
"name": "soul 1.6/ 1.6 16v flex mec.",
"struct": null
}
],
"value_type": "string"
},
{
"id": "FIPE_PRICE",
"name": "Preço FIPE",
"value_id": "55985369",
"value_name": "r$ 40.012,00",
"values": [
{
"id": "55985369",
"name": "r$ 40.012,00",
"struct": null
}
],
"value_type": "string"
},
{
"id": "IS_OFFERED_BY_BRAND",
"name": "É oferecido pela marca",
"value_id": "242084",
"value_name": "Não",
"values": [
{
"id": "242084",
"name": "Não",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "LICENSE_PLATE_LAST_DIGIT",
"name": "Último dígito da placa",
"value_id": null,
"value_name": "6",
"values": [
{
"id": null,
"name": "6",
"struct": null
}
],
"value_type": "number"
},
{
"id": "LICENSE_PLATE_PARITY",
"name": "Paridade da placa",
"value_id": "6832186",
"value_name": "Par",
"values": [
{
"id": "6832186",
"name": "Par",
"struct": null
}
],
"value_type": "list"
},
{
"id": "MARKET",
"name": "Mercado",
"value_id": "2419035",
"value_name": "BR",
"values": [
{
"id": "2419035",
"name": "BR",
"struct": null
}
],
"value_type": "string"
},
{
"id": "MILEAGE_WARRANTY",
"name": "Garantia em quilometros",
"value_id": "17711152",
"value_name": "80000",
"values": [
{
"id": "17711152",
"name": "80000",
"struct": null
}
],
"value_type": "number"
},
{
"id": "MOLICAR_CODE",
"name": "Código Molicar",
"value_id": "13800937",
"value_name": "02702525-1",
"values": [
{
"id": "13800937",
"name": "02702525-1",
"struct": null
}
],
"value_type": "string"
},
{
"id": "PRICE_USED",
"name": "Preço usado",
"value_id": "55985370",
"value_name": "40012",
"values": [
{
"id": "55985370",
"name": "40012",
"struct": null
}
],
"value_type": "string"
},
{
"id": "VERIFICATION_TYPE",
"name": "Tipo de verificação",
"value_id": "10882048",
"value_name": "De veículo",
"values": [
{
"id": "10882048",
"name": "De veículo",
"struct": null
}
],
"value_type": "string"
},
{
"id": "YEAR_WARRANTY",
"name": "Garantia em anos",
"value_id": "17526370",
"value_name": "5",
"values": [
{
"id": "17526370",
"name": "5",
"struct": null
}
],
"value_type": "number"
},
{
"id": "ARMORED",
"name": "Blindado",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_ABS_BRAKES",
"name": "Freios ABS",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_ALARM",
"name": "Alarme",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_ALLOY_WHEELS",
"name": "Rodas de liga leve",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_FOG_LIGHT",
"name": "Faróis anti-nevoeiro",
"value_id": "242084",
"value_name": "Não",
"values": [
{
"id": "242084",
"name": "Não",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_PASSENGER_AIRBAG",
"name": "Airbag para motorista e passageiro",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_REAR_FOGLIGHTS",
"name": "Faróis de neblina traseiros",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "TRACTION_CONTROL",
"name": "Controle de tração",
"value_id": "493979",
"value_name": "Dianteira",
"values": [
{
"id": "493979",
"name": "Dianteira",
"struct": null
}
],
"value_type": "list"
},
{
"id": "HAS_AMFM_RADIO",
"name": "AM/FM",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_AUXILIARY_PORT",
"name": "Entrada auxiliar",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_MP3_PLAYER",
"name": "Leitor de MP3",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_STEERING_WHEEL_CONTROL",
"name": "Controle remoto para rádio no volante",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_USB",
"name": "Entrada USB",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
}
],
"warnings": [],
"listing_source": "",
"variations": [],
"status": "active",
"sub_status": [
"pack_quota_assigned"
],
"tags": [
"test_item"
],
"warranty": null,
"catalog_product_id": "MLB7859304",
"domain_id": "MLB-CARS_AND_VANS",
"seller_custom_field": null,
"parent_item_id": null,
"differential_pricing": null,
"deal_ids": [],
"automatic_relist": false,
"date_created": "2025-10-28T15:18:33.914Z",
"last_updated": "2025-11-04T15:19:18.904Z",
"health": 0.16,
"catalog_listing": false,
"item_relations": [],
"channels": [
"marketplace"
]
}
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.
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 e à Argentina:
- A placa deve corresponder ao veículo publicado (marca, modelo, ano e versão).
- A placa não deve estar repetida em outra publicação.
- O número permitido de caracteres é 7 (sem hífen) ou 8 caracteres (com hífen).
Formatos para o Brasil:
- AAAnnnn: formato antigo, máximo de 7 caracteres, letras e números sem separação por hífen.
- AAA-nnnn: formato antigo, máximo de 8 caracteres, letras e números separados por hífen.
- AAAnAnn: formato Mercosul.
Formatos para a Argentina:
- AA-nnn-nn: formato atual, 7 caracteres no total, com letras e números separados por hífen.
Formatos para o Chile:
- AAAAnn ou AAnnnn:: formato atual, 6 caracteres no total, com letras e números.
Certifique-se de que a placa esteja correta e em conformidade com os formatos estabelecidos para garantir a verificação adequada do veículo.
Chassi
O campo "VIN_LAST_DIGITS". é essencial para a verificação do veículo, juntamente com a placa. Para garantir que as informações do veículo sejam validadas corretamente, é necessário preencher este campo com os últimos 6 dígitos do chassi. Embora essa informação permaneça oculta no anúncio, ela é crucial para a validação do item. A correta inserção dos últimos dígitos contribui para a integridade dos dados e a confiança no processo de compra e venda de veículos na plataforma. Certifique-se de incluir essa informação ao publicar um veículo para garantir que todas as verificações necessárias sejam realizadas.
Description
Conheça como carregar a descrição em um item.
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/descriptionExemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'https://api.mercadolibre.com/items/MLC614111912/descriptionResposta:
{
"text": "",
"plain_text": "Texto TEST".
"date_created": "2021-08-20T22:58:02.000Z",
"snapshot": {}
}
Imagens
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:
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.
Opções de Financiamento
Disponibilidade de Financiamento
O envio do campo WITH_FINANCING_OPTIONS possibilita ao vendedor indicar em suas publicações a disposição para negociar condições alternativas de pagamento (financiamento) com o comprador. Ao ativar esta opção, enviando o atributo, o anúncio exibirá a etiqueta de financiamento "Com facilidades de pagamento".
Para incluir o atributo de financiamento em sua publicação, você deve enviar o campo sale_terms como um array na chamada à API /items. Este atributo é do tipo booleano, onde o value_id define se o produto é financiável ou não.
| Parâmetro | Opcional | Valores |
|---|---|---|
| id | Não | WITH_FINANCING_OPTIONS |
| value_id | Não | 242085 (Sim = financiável) / 242084 (Não = não financiável) |
| value_name | Não | Sim / Não |
"sale_terms": [
{
"id": "WITH_FINANCING_OPTIONS",
"value_id": "242085",
"value_name": "Sim"
}
],Exemplo de chamada:
curl -L -X POST 'https://api.mercadolibre.com/items' \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"title": "Anuncio Prueba Auto - No Comprar 3",
"description": "Veículo em ótimo estado",
"channels": [
"marketplace"
],
"pictures": [
{
"id": "859393-MLB92379478091_092025"
}
],
"video_id": "sJLCxVgshzY",
"category_id": "MLA1744",
"price": 18000000,
"currency_id": "ARS",
"listing_type_id": "silver",
"available_quantity": 1,
"location": {
"address_line": "Solís 2222",
"zip_code": "",
"neighborhood": {
"id": "TUxBQk9MSTgzODNa",
"name": "Olivos"
},
"city": {
"id": "TUxBQ1ZJQ2E3MTQz",
"name": "Vicente López"
},
"state": {
"id": "TUxBUEdSQWU4ZDkz",
"name": "Bs.as. G.b.a. Norte"
},
"country": {
"id": "AR",
"name": "Argentina"
},
"open_hours": "",
"latitude": -34.5101161,
"longitude": -58.4765109
},
"sale_terms": [
{
"id": "WITH_FINANCING_OPTIONS",
"value_id": "242085",
"value_name": "Si"
}
],
"attributes": [
{
"id": "BRAND",
"value_name": "Citroën"
},
{
"id": "MODEL",
"value_name": "C4 Picasso"
},
{
"id": "VEHICLE_YEAR",
"value_name": "2015"
},
{
"id": "DOORS",
"value_name": "2"
},
{
"id": "KILOMETERS",
"value_name": "92000km"
},
{
"id": "FUEL_TYPE",
"value_name": "Diésel"
},
{
"id": "COLOR",
"value_name": "Rojo"
},
{
"id": "STEERING",
"value_name": "Hidráulica"
},
{
"id": "TRANSMISSION",
"value_name": "Manual"
},
{
"id": "TRACTION_CONTROL",
"value_name": "Delantera"
},
{
"id": "HAS_ABS_BRAKES",
"value_name": "Sí"
},
{
"id": "HAS_AIR_CONDITIONING",
"value_name": "Sí"
},
{
"id": "HAS_ALARM",
"value_name": "Sí"
},
{
"id": "HAS_ALLOY_WHEELS",
"value_name": "Sí"
},
{
"id": "HAS_AMFM_RADIO",
"value_name": "Sí"
},
{
"id": "HAS_AUXILIARY_PORT",
"value_name": "Sí"
},
{
"id": "ITEM_CONDITION",
"value_name": "Usado"
},
{
"id": "PASSENGER_CAPACITY",
"value_name": "7"
},
{
"id": "TRIM",
"value_name": "1.6 Origine Hdi 115cv"
},
{
"id": "SINGLE_OWNER",
"value_name": "Sí"
},
{
"id": "HAS_WINDSCREEN_WIPER",
"value_name": "Sí"
},
{
"id": "HAS_USB",
"value_name": "Sí"
},
{
"id": "HAS_STEERING_WHEEL_CONTROL",
"value_name": "Sí"
},
{
"id": "HAS_POWER_DOOR_LOCKS",
"value_name": "Sí"
},
{
"id": "HAS_POWER_WINDOWS",
"value_name": "Sí"
},
{
"id": "HAS_RAIN_SENSOR",
"value_name": "Sí"
},
{
"id": "HAS_REAR_FOGLIGHTS",
"value_name": "Si"
},
{
"id": "HAS_HEIGHT_ADJUSTABLE_DRIVER_SEAT",
"value_name": "Sí"
},
{
"id": "HAS_SLIDING_ROOF",
"value_name": "Sí"
},
{
"id": "HAS_LEATHER_UPHOLSTERY",
"value_name": "Sí"
},
{
"id": "HAS_LIGHT_ON_REMINDER",
"value_name": "Sí"
},
{
"id": "HAS_MP3_PLAYER",
"value_name": "Sí"
},
{
"id": "HAS_ONBOARD_COMPUTER",
"value_name": "Sí"
},
{
"id": "HAS_PARKING_SENSOR",
"value_name": "Sí"
},
{
"id": "HAS_PASSENGER_AIRBAG",
"value_name": "Sí"
},
{
"id": "VEHICLE_BODY_TYPE",
"value_name": "Monovolumen"
},
{
"id": "HEIGHT",
"value_name": "1644 mm"
},
{
"id": "WIDTH",
"value_name": "2000 mm"
},
{
"id": "DISTANCE_BETWEEN_AXES",
"value_name": "3735 mm"
},
{
"id": "FUEL_CAPACITY",
"value_name": "55 L"
},
{
"id": "LENGTH",
"value_name": "4597 mm"
},
{
"id": "VALVES_PER_CYLINDER",
"value_name": "2"
},
{
"id": "GEAR_NUMBER",
"value_name": "6"
}
]
}'
Resposta:
{
"id": "MLA2506681148",
"site_id": "MLA",
"title": "Anuncio Prueba Auto - No Comprar 3",
"seller_id": 2197811890,
"category_id": "MLA1744",
"user_product_id": "MLAU3525042708",
"official_store_id": null,
"price": 18000000,
"base_price": 18000000,
"original_price": null,
"inventory_id": null,
"currency_id": "ARS",
"initial_quantity": 1,
"available_quantity": 1,
"sold_quantity": 0,
"sale_terms": [
{
"id": "WITH_FINANCING_OPTIONS",
"name": "Con opciones de financiamiento",
"value_id": "242085",
"value_name": "Sí",
"value_struct": null,
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"value_type": "boolean"
}
],
"buying_mode": "classified",
"listing_type_id": "silver",
"start_time": "2025-10-28T17:02:05.138Z",
"stop_time": "2025-11-27T04:00:00.000Z",
"end_time": "2025-11-27T04:00:00.000Z",
"expiration_time": "2026-01-16T17:02:05.225Z",
"condition": "used",
"permalink": "http://auto.mercadolibre.com.ar/MLA-2506681148-anuncio-teste-carro-nao-comprar-3-_JM",
"pictures": [
{
"id": "859393-MLB92379478091_092025",
"url": "http://mlb-s1-p.mlstatic.com/859393-MLB92379478091_092025-O.jpg",
"secure_url": "https://mlb-s1-p.mlstatic.com/859393-MLB92379478091_092025-O.jpg",
"size": "500x375",
"max_size": "1200x900",
"quality": ""
}
],
"video_id": "sJLCxVgshzY",
"descriptions": [],
"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": 0
},
"seller_contact": {
"contact": "",
"other_info": "",
"area_code": "",
"phone": "",
"area_code2": "",
"phone2": "",
"email": "",
"webpage": "",
"country_code": "",
"country_code2": ""
},
"location": {
"address_line": "Solís 2222",
"zip_code": "",
"neighborhood": {
"id": "TUxBQk9MSTgzODNa",
"name": "Olivos"
},
"city": {
"id": "TUxBQ1ZJQ2E3MTQz",
"name": "Vicente López"
},
"state": {
"id": "TUxBUEdSQWU4ZDkz",
"name": "Bs.As. G.B.A. Norte"
},
"country": {
"id": "AR",
"name": "Argentina"
},
"latitude": -34.5101161,
"longitude": -58.4765109,
"open_hours": ""
},
"geolocation": {
"latitude": -34.5101161,
"longitude": -58.4765109
},
"coverage_areas": [],
"attributes": [
{
"id": "BRAND",
"name": "Marca",
"value_id": "389169",
"value_name": "Citroën",
"values": [
{
"id": "389169",
"name": "Citroën",
"struct": null
}
],
"value_type": "string"
},
{
"id": "MODEL",
"name": "Modelo",
"value_id": "389410",
"value_name": "C4 Picasso",
"values": [
{
"id": "389410",
"name": "C4 Picasso",
"struct": null
}
],
"value_type": "string"
},
{
"id": "VEHICLE_YEAR",
"name": "Año",
"value_id": null,
"value_name": "2015",
"values": [
{
"id": null,
"name": "2015",
"struct": null
}
],
"value_type": "number"
},
{
"id": "DOORS",
"name": "Puertas",
"value_id": null,
"value_name": "2",
"values": [
{
"id": null,
"name": "2",
"struct": null
}
],
"value_type": "number"
},
{
"id": "KILOMETERS",
"name": "Kilómetros",
"value_id": null,
"value_name": "92000 km",
"values": [
{
"id": null,
"name": "92000 km",
"struct": {
"number": 92000,
"unit": "km"
}
}
],
"value_type": "number_unit"
},
{
"id": "FUEL_TYPE",
"name": "Tipo de combustible",
"value_id": "60406",
"value_name": "Diésel",
"values": [
{
"id": "60406",
"name": "Diésel",
"struct": null
}
],
"value_type": "list"
},
{
"id": "COLOR",
"name": "Color",
"value_id": "51993",
"value_name": "Rojo",
"values": [
{
"id": "51993",
"name": "Rojo",
"struct": null
}
],
"value_type": "string"
},
{
"id": "STEERING",
"name": "Dirección",
"value_id": "370874",
"value_name": "Hidráulica",
"values": [
{
"id": "370874",
"name": "Hidráulica",
"struct": null
}
],
"value_type": "list"
},
{
"id": "TRANSMISSION",
"name": "Transmisión",
"value_id": "370877",
"value_name": "Manual",
"values": [
{
"id": "370877",
"name": "Manual",
"struct": null
}
],
"value_type": "list"
},
{
"id": "TRACTION_CONTROL",
"name": "Control de tracción",
"value_id": "493979",
"value_name": "Delantera",
"values": [
{
"id": "493979",
"name": "Delantera",
"struct": null
}
],
"value_type": "list"
},
{
"id": "HAS_ABS_BRAKES",
"name": "Frenos ABS",
"value_id": "242085",
"value_name": "Sí",
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_AIR_CONDITIONING",
"name": "Aire acondicionado",
"value_id": "242085",
"value_name": "Sí",
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_ALARM",
"name": "Alarma",
"value_id": "242085",
"value_name": "Sí",
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_ALLOY_WHEELS",
"name": "Llantas de aleación",
"value_id": "242085",
"value_name": "Sí",
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_AMFM_RADIO",
"name": "AM/FM",
"value_id": "242085",
"value_name": "Sí",
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_AUXILIARY_PORT",
"name": "Entrada auxiliar",
"value_id": "242085",
"value_name": "Sí",
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "ITEM_CONDITION",
"name": "Condición del ítem",
"value_id": "2230581",
"value_name": "Usado",
"values": [
{
"id": "2230581",
"name": "Usado",
"struct": null
}
],
"value_type": "list"
},
{
"id": "PASSENGER_CAPACITY",
"name": "Capacidad de personas",
"value_id": null,
"value_name": "7",
"values": [
{
"id": null,
"name": "7",
"struct": null
}
],
"value_type": "number"
},
{
"id": "TRIM",
"name": "Versión",
"value_id": null,
"value_name": "1.6 Origine Hdi 115cv",
"values": [
{
"id": null,
"name": "1.6 Origine Hdi 115cv",
"struct": null
}
],
"value_type": "string"
},
{
"id": "SINGLE_OWNER",
"name": "Único dueño",
"value_id": "242085",
"value_name": "Sí",
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_WINDSCREEN_WIPER",
"name": "Limpia/lava luneta",
"value_id": "242085",
"value_name": "Sí",
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_USB",
"name": "Entrada USB",
"value_id": "242085",
"value_name": "Sí",
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_STEERING_WHEEL_CONTROL",
"name": "Comando remoto para radio en el volante",
"value_id": "242085",
"value_name": "Sí",
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_POWER_DOOR_LOCKS",
"name": "Cierre centralizado de puertas",
"value_id": null,
"value_name": "Sí",
"values": [
{
"id": null,
"name": "Sí",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_POWER_WINDOWS",
"name": "Cristales eléctricos",
"value_id": "242085",
"value_name": "Sí",
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_RAIN_SENSOR",
"name": "Sensor de lluvia",
"value_id": "242085",
"value_name": "Sí",
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_REAR_FOGLIGHTS",
"name": "Faros antinieblas traseros",
"value_id": "242085",
"value_name": "Sí",
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_HEIGHT_ADJUSTABLE_DRIVER_SEAT",
"name": "Asiento conductor regulable en altura",
"value_id": "242085",
"value_name": "Sí",
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_SLIDING_ROOF",
"name": "Techo solar eléctrico retráctil",
"value_id": "242085",
"value_name": "Sí",
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_LEATHER_UPHOLSTERY",
"name": "Tapizado de cuero",
"value_id": "242085",
"value_name": "Sí",
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_LIGHT_ON_REMINDER",
"name": "Alarma de luces encendidas",
"value_id": "242085",
"value_name": "Sí",
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_MP3_PLAYER",
"name": "Reproductor de MP3",
"value_id": "242085",
"value_name": "Sí",
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_ONBOARD_COMPUTER",
"name": "Computadora de abordo",
"value_id": "242085",
"value_name": "Sí",
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_PARKING_SENSOR",
"name": "Sensor de estacionamiento",
"value_id": "242085",
"value_name": "Sí",
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_PASSENGER_AIRBAG",
"name": "Airbag para conductor y pasajero",
"value_id": "242085",
"value_name": "Sí",
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "VEHICLE_BODY_TYPE",
"name": "Tipo de carrocería",
"value_id": "452752",
"value_name": "Monovolumen",
"values": [
{
"id": "452752",
"name": "Monovolumen",
"struct": null
}
],
"value_type": "list"
},
{
"id": "HEIGHT",
"name": "Altura",
"value_id": null,
"value_name": "1644 mm",
"values": [
{
"id": null,
"name": "1644 mm",
"struct": {
"number": 1644,
"unit": "mm"
}
}
],
"value_type": "number_unit"
},
{
"id": "WIDTH",
"name": "Ancho",
"value_id": null,
"value_name": "2000 mm",
"values": [
{
"id": null,
"name": "2000 mm",
"struct": {
"number": 2000,
"unit": "mm"
}
}
],
"value_type": "number_unit"
},
{
"id": "DISTANCE_BETWEEN_AXES",
"name": "Distancia entre ejes",
"value_id": null,
"value_name": "3735 mm",
"values": [
{
"id": null,
"name": "3735 mm",
"struct": {
"number": 3735,
"unit": "mm"
}
}
],
"value_type": "number_unit"
},
{
"id": "FUEL_CAPACITY",
"name": "Capacidad del tanque",
"value_id": null,
"value_name": "55 L",
"values": [
{
"id": null,
"name": "55 L",
"struct": {
"number": 55,
"unit": "L"
}
}
],
"value_type": "number_unit"
},
{
"id": "LENGTH",
"name": "Largo",
"value_id": null,
"value_name": "4597 mm",
"values": [
{
"id": null,
"name": "4597 mm",
"struct": {
"number": 4597,
"unit": "mm"
}
}
],
"value_type": "number_unit"
},
{
"id": "VALVES_PER_CYLINDER",
"name": "Válvulas por cilindro",
"value_id": null,
"value_name": "2",
"values": [
{
"id": null,
"name": "2",
"struct": null
}
],
"value_type": "number"
},
{
"id": "GEAR_NUMBER",
"name": "Numero de velocidades",
"value_id": null,
"value_name": "6",
"values": [
{
"id": null,
"name": "6",
"struct": null
}
],
"value_type": "number"
},
{
"id": "VEHICLE_TYPE",
"name": "Tipo de vehículo",
"value_id": "398351",
"value_name": "Autos y camionetas",
"values": [
{
"id": "398351",
"name": "Autos y camionetas",
"struct": null
}
],
"value_type": "string"
}
],
"warnings": [],
"listing_source": "",
"variations": [],
"thumbnail_id": "859393-MLB92379478091_092025",
"thumbnail": "http://mla-s1-p.mlstatic.com/859393-MLB92379478091_092025-I.jpg",
"status": "payment_required",
"sub_status": [],
"tags": [
"test_item"
],
"warranty": null,
"catalog_product_id": null,
"domain_id": "MLA-CARS_AND_VANS",
"seller_custom_field": null,
"parent_item_id": null,
"differential_pricing": null,
"deal_ids": [],
"automatic_relist": false,
"date_created": "2025-10-28T17:02:05.385Z",
"last_updated": "2025-10-28T17:02:05.385Z",
"health": null,
"catalog_listing": false,
"item_relations": [],
"channels": [
"marketplace"
]
}
Financiamento com entrada
O atributo INITIAL_PAYMENT_AMOUNT permite ao vendedor informar o valor inicial (entrada) que o comprador deve pagar ao fechar a operação. Este campo é uma excelente forma de dar transparência à negociação. Ao ativar esta opção, enviando o atributo, o anúncio exibirá o valor da entrada.
Para incluir o atributo de valor da entrada em sua publicação, você deve enviar o campo sale_terms como um array na chamada à API /items, onde o value_name informa o valor da entrada para o produto.
| Parâmetro | Opcional | Valores |
|---|---|---|
| id | Não | INITIAL_PAYMENT_AMOUNT |
| value_name | Não | Valor numérico da entrada acompanhado da unidade monetária da moeda (ex.: 6000000 ARS) |
| value_struct.unit | Sim | Unidade monetária correspondente. Ex.: ARS |
O valor informado no campo "value_name" deve corresponder à mesma moeda (currency_id) que o item. Caso o valor de "INITIAL_PAYMENT_AMOUNT" seja enviado em uma moeda diferente, o sistema realizará automaticamente a conversão para a moeda do item.
"sale_terms": [
{
"id": "WITH_FINANCING_OPTIONS",
"value_id": "242085",
"value_name": "Si"
},
{
"id": "INITIAL_PAYMENT_AMOUNT",
"value_name": "8000000 ARS",
"value_struct": {
"unit": "ARS"
}
}
]Exemplo de chamada:
curl -L -X POST 'https://api.mercadolibre.com/items' \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"title": "Anúncio Teste Carro - Não Comprar 4",
"description": "Veículo em excelente estado",
"channels": [
"marketplace"
],
"pictures": [
{
"id": "859393-MLB92379478091_092025"
}
],
"video_id": "sJLCxVgshzY",
"category_id": "MLA1744",
"price": 25000000,
"currency_id": "ARS",
"listing_type_id": "silver",
"available_quantity": 1,
"location": {
"address_line": "Solís 2222",
"zip_code": "",
"neighborhood": {
"id": "TUxBQk9MSTgzODNa",
"name": "Olivos"
},
"city": {
"id": "TUxBQ1ZJQ2E3MTQz",
"name": "Vicente López"
},
"state": {
"id": "TUxBUEdSQWU4ZDkz",
"name": "Bs.as. G.b.a. Norte"
},
"country": {
"id": "AR",
"name": "Argentina"
},
"open_hours": "",
"latitude": -34.5101161,
"longitude": -58.4765109
},
"sale_terms": [
{
"id": "WITH_FINANCING_OPTIONS",
"value_id": "242085",
"value_name": "Sim"
},
{
"id": "INITIAL_PAYMENT_AMOUNT",
"value_name": "8000000 ARS",
"value_struct": {
"unit": "ARS"
}
}
],
"attributes": [
{
"id": "BRAND",
"value_name": "Citroën"
},
{
"id": "MODEL",
"value_name": "C4 Picasso"
},
{
"id": "VEHICLE_YEAR",
"value_name": "2015"
},
{
"id": "DOORS",
"value_name": "2"
},
{
"id": "KILOMETERS",
"value_name": "92000km"
},
{
"id": "FUEL_TYPE",
"value_name": "Diesel"
},
{
"id": "COLOR",
"value_name": "Vermelho"
},
{
"id": "STEERING",
"value_name": "Hidráulica"
},
{
"id": "TRANSMISSION",
"value_name": "Manual"
},
{
"id": "TRACTION_CONTROL",
"value_name": "Dianteira"
},
{
"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": "Usado"
},
{
"id": "PASSENGER_CAPACITY",
"value_name": "7"
},
{
"id": "TRIM",
"value_name": "1.6 Origine Hdi 115cv"
},
{
"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": "VEHICLE_BODY_TYPE",
"value_name": "Monovolume"
},
{
"id": "HEIGHT",
"value_name": "1644 mm"
},
{
"id": "WIDTH",
"value_name": "2000 mm"
},
{
"id": "DISTANCE_BETWEEN_AXES",
"value_name": "3735 mm"
},
{
"id": "FUEL_CAPACITY",
"value_name": "55 L"
},
{
"id": "LENGTH",
"value_name": "4597 mm"
},
{
"id": "VALVES_PER_CYLINDER",
"value_name": "2"
},
{
"id": "GEAR_NUMBER",
"value_name": "6"
}
]
}'
Resposta:
{
"id": "MLA1680239363",
"site_id": "MLA",
"title": "Anúncio Teste Carro - Não Comprar 4",
"seller_id": 1697535834,
"category_id": "MLA1744",
"user_product_id": "MLAU3811250684",
"official_store_id": null,
"price": 25000000,
"base_price": 25000000,
"original_price": null,
"inventory_id": null,
"currency_id": "ARS",
"initial_quantity": 1,
"available_quantity": 1,
"sold_quantity": 0,
"sale_terms": [
{
"id": "WITH_FINANCING_OPTIONS",
"name": "Com opções de financiamento",
"value_id": "242085",
"value_name": "Sim",
"value_struct": null,
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "INITIAL_PAYMENT_AMOUNT",
"name": "Valor da entrada",
"value_id": null,
"value_name": "8000000 ARS",
"value_struct": {
"number": 8000000,
"unit": "ARS"
},
"values": [
{
"id": null,
"name": "8000000 ARS",
"struct": {
"number": 8000000,
"unit": "ARS"
}
}
],
"value_type": "number_unit"
}
],
"buying_mode": "classified",
"listing_type_id": "silver",
"start_time": "2026-02-23T13:11:25.146Z",
"stop_time": "2026-03-25T04:00:00.000Z",
"end_time": "2026-03-25T04:00:00.000Z",
"expiration_time": "2026-05-14T13:11:25.281Z",
"condition": "used",
"permalink": "http://auto.mercadolibre.com.ar/MLA-1680239363-anuncio-prueba-auto-no-comprar-4-_JM",
"pictures": [
{
"id": "859393-MLB92379478091_092025",
"url": "http://mlb-s1-p.mlstatic.com/859393-MLB92379478091_092025-O.jpg",
"secure_url": "https://mlb-s1-p.mlstatic.com/859393-MLB92379478091_092025-O.jpg",
"size": "500x375",
"max_size": "1200x900",
"quality": ""
}
],
"video_id": "sJLCxVgshzY",
"descriptions": [],
"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": 1359885413,
"comment": "Referência: The Testing Cavern",
"address_line": "Testing Street 1450",
"zip_code": "1430",
"city": {
"id": "TUxBQlNBQTM3Mzda",
"name": "Saavedra"
},
"state": {
"id": "AR-C",
"name": "Capital Federal"
},
"country": {
"id": "AR",
"name": "Argentina"
},
"latitude": -34.5601594,
"longitude": -58.4715658,
"search_location": {
"neighborhood": {
"id": "TUxBQlNBQTM3Mzda",
"name": "Saavedra"
},
"city": {
"id": "TUxBQ0NBUGZlZG1sYQ",
"name": "Capital Federal"
},
"state": {
"id": "TUxBUENBUGw3M2E1",
"name": "Capital Federal"
}
}
},
"seller_contact": {
"contact": "",
"other_info": "",
"area_code": "",
"phone": "",
"area_code2": "",
"phone2": "",
"email": "",
"webpage": "",
"country_code": "",
"country_code2": ""
},
"location": {
"address_line": "Solís 2222",
"zip_code": "",
"neighborhood": {
"id": "TUxBQk9MSTgzODNa",
"name": "Olivos"
},
"city": {
"id": "TUxBQ1ZJQ2E3MTQz",
"name": "Vicente López"
},
"state": {
"id": "TUxBUEdSQWU4ZDkz",
"name": "Bs.As. G.B.A. Norte"
},
"country": {
"id": "AR",
"name": "Argentina"
},
"latitude": -34.5101161,
"longitude": -58.4765109,
"open_hours": ""
},
"geolocation": {
"latitude": -34.5101161,
"longitude": -58.4765109
},
"coverage_areas": [],
"attributes": [
{
"id": "BRAND",
"name": "Marca",
"value_id": "389169",
"value_name": "Citroën",
"values": [
{
"id": "389169",
"name": "Citroën",
"struct": null
}
],
"value_type": "string"
},
{
"id": "MODEL",
"name": "Modelo",
"value_id": "389410",
"value_name": "C4 Picasso",
"values": [
{
"id": "389410",
"name": "C4 Picasso",
"struct": null
}
],
"value_type": "string"
},
{
"id": "VEHICLE_YEAR",
"name": "Ano",
"value_id": null,
"value_name": "2015",
"values": [
{
"id": null,
"name": "2015",
"struct": null
}
],
"value_type": "number"
},
{
"id": "DOORS",
"name": "Portas",
"value_id": null,
"value_name": "2",
"values": [
{
"id": null,
"name": "2",
"struct": null
}
],
"value_type": "number"
},
{
"id": "KILOMETERS",
"name": "Quilômetros",
"value_id": null,
"value_name": "92000 km",
"values": [
{
"id": null,
"name": "92000 km",
"struct": {
"number": 92000,
"unit": "km"
}
}
],
"value_type": "number_unit"
},
{
"id": "FUEL_TYPE",
"name": "Tipo de combustível",
"value_id": "60406",
"value_name": "Diesel",
"values": [
{
"id": "60406",
"name": "Diesel",
"struct": null
}
],
"value_type": "list"
},
{
"id": "COLOR",
"name": "Cor",
"value_id": "51993",
"value_name": "Vermelho",
"values": [
{
"id": "51993",
"name": "Vermelho",
"struct": null
}
],
"value_type": "string"
},
{
"id": "STEERING",
"name": "Direção",
"value_id": "370874",
"value_name": "Hidráulica",
"values": [
{
"id": "370874",
"name": "Hidráulica",
"struct": null
}
],
"value_type": "list"
},
{
"id": "TRANSMISSION",
"name": "Transmissão",
"value_id": "370877",
"value_name": "Manual",
"values": [
{
"id": "370877",
"name": "Manual",
"struct": null
}
],
"value_type": "list"
},
{
"id": "TRACTION_CONTROL",
"name": "Controle de tração",
"value_id": "493979",
"value_name": "Dianteira",
"values": [
{
"id": "493979",
"name": "Dianteira",
"struct": null
}
],
"value_type": "list"
},
{
"id": "HAS_ABS_BRAKES",
"name": "Freios ABS",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_AIR_CONDITIONING",
"name": "Ar-condicionado",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_ALARM",
"name": "Alarme",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_ALLOY_WHEELS",
"name": "Rodas de liga leve",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_AMFM_RADIO",
"name": "AM/FM",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_AUXILIARY_PORT",
"name": "Entrada auxiliar",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "ITEM_CONDITION",
"name": "Condição do item",
"value_id": "2230581",
"value_name": "Usado",
"values": [
{
"id": "2230581",
"name": "Usado",
"struct": null
}
],
"value_type": "list"
},
{
"id": "PASSENGER_CAPACITY",
"name": "Capacidade de pessoas",
"value_id": null,
"value_name": "7",
"values": [
{
"id": null,
"name": "7",
"struct": null
}
],
"value_type": "number"
},
{
"id": "TRIM",
"name": "Versão",
"value_id": null,
"value_name": "1.6 Origine Hdi 115cv",
"values": [
{
"id": null,
"name": "1.6 Origine Hdi 115cv",
"struct": null
}
],
"value_type": "string"
},
{
"id": "SINGLE_OWNER",
"name": "Único dono",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_WINDSCREEN_WIPER",
"name": "Limpador/lavador de vidro traseiro",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_USB",
"name": "Entrada USB",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_STEERING_WHEEL_CONTROL",
"name": "Comandos no volante para o rádio",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_POWER_DOOR_LOCKS",
"name": "Travas elétricas de portas",
"value_id": null,
"value_name": "Sim",
"values": [
{
"id": null,
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_POWER_WINDOWS",
"name": "Vidros elétricos",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_RAIN_SENSOR",
"name": "Sensor de chuva",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_REAR_FOGLIGHTS",
"name": "Faróis de neblina traseiros",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_HEIGHT_ADJUSTABLE_DRIVER_SEAT",
"name": "Banco do motorista com ajuste de altura",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_SLIDING_ROOF",
"name": "Teto solar elétrico retrátil",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_LEATHER_UPHOLSTERY",
"name": "Bancos de couro",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_LIGHT_ON_REMINDER",
"name": "Alerta de luzes acesas",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_MP3_PLAYER",
"name": "Reprodutor de MP3",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_ONBOARD_COMPUTER",
"name": "Computador de bordo",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_PARKING_SENSOR",
"name": "Sensor de estacionamento",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "HAS_PASSENGER_AIRBAG",
"name": "Airbag para motorista e passageiro",
"value_id": "242085",
"value_name": "Sim",
"values": [
{
"id": "242085",
"name": "Sim",
"struct": null
}
],
"value_type": "boolean"
},
{
"id": "VEHICLE_BODY_TYPE",
"name": "Tipo de carroceria",
"value_id": "452752",
"value_name": "Monovolume",
"values": [
{
"id": "452752",
"name": "Monovolume",
"struct": null
}
],
"value_type": "list"
},
{
"id": "HEIGHT",
"name": "Altura",
"value_id": null,
"value_name": "1644 mm",
"values": [
{
"id": null,
"name": "1644 mm",
"struct": {
"number": 1644,
"unit": "mm"
}
}
],
"value_type": "number_unit"
},
{
"id": "WIDTH",
"name": "Largura",
"value_id": null,
"value_name": "2000 mm",
"values": [
{
"id": null,
"name": "2000 mm",
"struct": {
"number": 2000,
"unit": "mm"
}
}
],
"value_type": "number_unit"
},
{
"id": "DISTANCE_BETWEEN_AXES",
"name": "Distância entre eixos",
"value_id": null,
"value_name": "3735 mm",
"values": [
{
"id": null,
"name": "3735 mm",
"struct": {
"number": 3735,
"unit": "mm"
}
}
],
"value_type": "number_unit"
},
{
"id": "FUEL_CAPACITY",
"name": "Capacidade do tanque",
"value_id": null,
"value_name": "55 L",
"values": [
{
"id": null,
"name": "55 L",
"struct": {
"number": 55,
"unit": "L"
}
}
],
"value_type": "number_unit"
},
{
"id": "LENGTH",
"name": "Comprimento",
"value_id": null,
"value_name": "4597 mm",
"values": [
{
"id": null,
"name": "4597 mm",
"struct": {
"number": 4597,
"unit": "mm"
}
}
],
"value_type": "number_unit"
},
{
"id": "VALVES_PER_CYLINDER",
"name": "Válvulas por cilindro",
"value_id": null,
"value_name": "2",
"values": [
{
"id": null,
"name": "2",
"struct": null
}
],
"value_type": "number"
},
{
"id": "GEAR_NUMBER",
"name": "Número de velocidades",
"value_id": null,
"value_name": "6",
"values": [
{
"id": null,
"name": "6",
"struct": null
}
],
"value_type": "number"
},
{
"id": "VEHICLE_TYPE",
"name": "Tipo de veículo",
"value_id": "398351",
"value_name": "Carros e caminhonetes",
"values": [
{
"id": "398351",
"name": "Carros e caminhonetes",
"struct": null
}
],
"value_type": "string"
}
],
"warnings": [],
"listing_source": "",
"variations": [],
"thumbnail_id": "859393-MLB92379478091_092025",
"thumbnail": "http://mla-s1-p.mlstatic.com/859393-MLB92379478091_092025-I.jpg",
"status": "active",
"sub_status": [],
"tags": [
"test_item",
"immediate_payment"
],
"warranty": null,
"catalog_product_id": null,
"domain_id": "MLA-CARS_AND_VANS",
"seller_custom_field": null,
"parent_item_id": null,
"differential_pricing": null,
"deal_ids": [],
"automatic_relist": false,
"date_created": "2026-02-23T13:11:25.432Z",
"last_updated": "2026-02-23T13:11:25.432Z",
"health": null,
"catalog_listing": false,
"item_relations": [],
"channels": [
"marketplace"
]
}
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",
},
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/itemsObserve 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
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