Documentação do Mercado Livre
Confira todas as informações necessárias sobre as APIs Mercado Livre.
Documentação do
Publicação de imóveis
Consultar imóvel
Você só precisa conhecer o item_id associado a tal item e, como ele é público, pode ser obtido na página do item. O itemd_id é 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/MLA839018613Resposta:
{
"id": "MLA839018613",
"site_id": "MLA",
"title": "Property Title",
"subtitle": null,
"seller_id": 526655030,
"category_id": "MLA401686",
"official_store_id": null,
"price": 100000,
"base_price": 100000,
"original_price": null,
"currency_id": "ARS",
"initial_quantity": 1,
"available_quantity": 1,
"sold_quantity": 0,
"sale_terms": [],
"buying_mode": "classified",
"listing_type_id": "silver",
"start_time": "2020-02-13T19:29:01.000Z",
"stop_time": "2020-05-14T04:00:00.000Z",
"condition": "not_specified",
"permalink": "https://departamento.mercadolibre.com.ar/MLA-839018613-property-title-_JM",
"thumbnail": "http://mla-s2-p.mlstatic.com/910707-MLA40763776324_022020-I.jpg",
"secure_thumbnail": "https://mla-s2-p.mlstatic.com/910707-MLA40763776324_022020-I.jpg",
"pictures": [
{
"id": "910707-MLA40763776324_022020",
"url": "http://mla-s2-p.mlstatic.com/910707-MLA40763776324_022020-O.jpg",
"secure_url": "https://mla-s2-p.mlstatic.com/910707-MLA40763776324_022020-O.jpg",
"size": "500x438",
"max_size": "548x481",
"quality": ""
}
],
"video_id": "gqkEN9poKM;matterport",
"descriptions": [
{
"id": "MLA839018613-2516619253"
}
],
"accepts_mercadopago": false,
"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": {
"city": {
"id": "TUxBQlNBQTM3Mzda",
"name": "Saavedra"
},
"state": {
"id": "AR-C",
"name": "Capital Federal"
},
"country": {
"id": "AR",
"name": "Argentina"
},
"search_location": {
"neighborhood": {
"id": "TUxBQlNBQTM3Mzda",
"name": "Saavedra"
},
"city": {
"id": "TUxBQ0NBUGZlZG1sYQ",
"name": "Capital Federal"
},
"state": {
"id": "TUxBUENBUGw3M2E1",
"name": "Capital Federal"
}
},
"latitude": -34.556595,
"longitude": -58.48787,
"id": 1087750186
},
"seller_contact": {
"contact": "",
"other_info": "",
"country_code": "",
"area_code": "",
"phone": "",
"country_code2": "",
"area_code2": "",
"phone2": "",
"email": "",
"webpage": ""
},
"location": {
"address_line": "My property address NEW 111",
"zip_code": "5000",
"neighborhood": {
"id": "TUxBQlBBTDI1MTVa",
"name": "Palermo"
},
"city": {
"id": "TUxBQ0NBUGZlZG1sYQ",
"name": "Capital Federal"
},
"state": {
"id": "TUxBUENBUGw3M2E1",
"name": "Capital Federal"
},
"country": {
"id": "AR",
"name": "Argentina"
},
"latitude": -34.5780655,
"longitude": -58.4265317
},
"geolocation": {
"latitude": -34.5780655,
"longitude": -58.4265317
},
"coverage_areas": [],
"attributes": [
{
"id": "BEDROOMS",
"name": "Dormitorios",
"value_id": null,
"value_name": "4",
"value_struct": null,
"values": [
{
"id": null,
"name": "4",
"struct": null
}
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "COVERED_AREA",
"name": "Superficie cubierta",
"value_id": null,
"value_name": "30 m²",
"value_struct": {
"number": 30,
"unit": "m²"
},
"values": [
{
"id": null,
"name": "30 m²",
"struct": {
"number": 30,
"unit": "m²"
}
}
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "FULL_BATHROOMS",
"name": "Baños",
"value_id": null,
"value_name": "1",
"value_struct": null,
"values": [
{
"id": null,
"name": "1",
"struct": null
}
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "PARKING_LOTS",
"name": "Cocheras",
"value_id": null,
"value_name": "1",
"value_struct": null,
"values": [
{
"id": null,
"name": "1",
"struct": null
}
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "ROOMS",
"name": "Ambientes",
"value_id": null,
"value_name": "2",
"value_struct": null,
"values": [
{
"id": null,
"name": "2",
"struct": null
}
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "TOTAL_AREA",
"name": "Superficie total",
"value_id": null,
"value_name": "40 m²",
"value_struct": {
"number": 40,
"unit": "m²"
},
"values": [
{
"id": null,
"name": "40 m²",
"struct": {
"number": 40,
"unit": "m²"
}
}
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "OPERATION",
"name": "Operación",
"value_id": "242075",
"value_name": "Venta",
"value_struct": null,
"values": [
{
"id": "242075",
"name": "Venta",
"struct": null
}
],
"attribute_group_id": "MAIN",
"attribute_group_name": "Principales"
},
{
"id": "OPERATION_SUBTYPE",
"name": "Subtipo de operación",
"value_id": "244562",
"value_name": "Propiedad individual",
"value_struct": null,
"values": [
{
"id": "244562",
"name": "Propiedad individual",
"struct": null
}
],
"attribute_group_id": "MAIN",
"attribute_group_name": "Principales"
},
{
"id": "PROPERTY_TYPE",
"name": "Inmueble",
"value_id": "242062",
"value_name": "Departamento",
"value_struct": null,
"values": [
{
"id": "242062",
"name": "Departamento",
"struct": null
}
],
"attribute_group_id": "MAIN",
"attribute_group_name": "Principales"
}
],
"warnings": [],
"listing_source": "",
"variations": [],
"status": "active",
"sub_status": [],
"tags": [
"test_item"
],
"warranty": null,
"catalog_product_id": null,
"domain_id": "MLA-INDIVIDUAL_APARTMENTS_FOR_SALE",
"parent_item_id": null,
"differential_pricing": null,
"deal_ids": [],
"automatic_relist": false,
"date_created": "2020-02-13T19:29:01.000Z",
"last_updated": "2020-02-13T19:49:09.226Z",
"health": null,
"catalog_listing": false
}
Atributos
É necessário saber que, ao criar um JSON para seu anúncio, 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 anúncio será exibido e sua posição nos resultados da busca. Abaixo mencionamos os campos mais importantes que devem ser enviados. Lembre-se que além deles, devem também ser enviados os campos complementadores (atributos) no array de atributos. Para maiores informações, leia o guia de categorias e atributos.
Title
Evitar adjetivos e abreviações. O título correto deve ter o tipo de operação (aluguel/venda/aluguel de temporada) + tipo de propriedade (casa, apartamento, etc..) + ambientes + bairro. As palavras do título são muito importantes já que são elas que coincidem com a palavra buscada pelo usuário, então quanto maior esta coincidência, melhor ranking a publicação terá. Exemplo: Venda Apartamento 2 Quartos Morumbi.
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": "Excelente casa, con ubicación nororiente. Texto TEST.
"date_created": "2021-05-19T19:56:12.000Z",
"snapshot": {}
}
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. Exemplo:
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.
Acessa a este link, para saber como consultar os códigos de localizações do Mercado Livre.
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.
Exemplo:
seller_contact: {
contact: "Nome Contato Teste",
area_code: "11",
phone: "4444-5555",
area_code2: "21",
phone2: "1111-3333",
email: "contact-email@somedomain.com",
},
Imagens
Imagens de boa qualidade podem fazer com que seu imó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.
Para saber a quantidade de imagens que é possível publicar, é necessário consultar na categoria os campos max_pictures_per_item y max_pictures_per_item_var.Este é um atributo obrigatório de acordo com o grupo que pertence ao tipo de propriedade.
{
....
"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.
A quantidade de imagens mínimas tem um impacto na qualidade de uma publicação e esses valores são diferentes entre os 3 grupos de tipos de imóveis:
- Grupo 1: Casas / Apartamentos / Escritórios / Cemitérios (12 fotos).
- Grupo 2: Lojas comerciais/ Fazendas / sitios /Terrenos / Vinícolas / Lotamentos (6 fotos).
- Grupo 3: Estacionamentos (4 fotos).
Categorias e Atributos
Os vendedores deverão definir uma categoria ( exemplo: “Venta” (Vendas) e “Alquiler" (Aluguel) ) no site do Mercado Livre. Esse atributo é obrigatório e somente aceita IDs pré-estabelecidos. Para obter mais informações, leia o guia de Categorias e Atributos.
{
....
"category_id":"MLA12683",
...
}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.
Moedas
Este atributo é obrigatório. Você deve defini-lo usando um ID predefinido. Você encontrará os códigos de moeda disponíveis ligando para a categoria em que deseja publicar seu artigo. Veja exemplos do recurso Localização e moedas aqui.
Condomínio
O atributo MAINTENANCE_FEE é obrigatório. Você deve incluir o valor monetário de gasto común mensal na moeda correspondente do país (cada moeda possui um ID predefinido).
Aceita pets
O atributo IS_SUITABLE_FOR_PETS é obrigatório e deve ser enviado. Os valores definidos para este atributo onde os animais devem ser definidos são Sim e Ñao para o caso correspondente juntamente com o ID predefinido.
Garagens
O atributo PARKING_LOTS é um valor numérico obrigatório. Este atributo deve definir o número de vagas de estacionamento disponíveis.
Depósito privativo
OO atributo WAREHOUSES é um valor numérico obrigatório. Este atributo refere-se ao número de espaços que são contabilizados como depósito privativo.
Banheiros
O atributo FULL_BATHROOMS é um valor numérico obrigatório. Este atributo refere-se ao número de banheiros completos disponíveis na propriedade.
Mobiliado
O atributo FURNISHED é obrigatório. Refere-se a se o imóvel está mobilado, sendo que os valores definidos para este atributo são Sim e Ñao junto com o respetivo ID.
Listing Type
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.
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”, “used” ou o "not_specified", dependendo da condição do anúncio.
Publicação de um imóvel
Agora você já está pronto para publicar seu primeiro imóvel. Lembre de que, para isso, você vai precisar de um access_token. Se tiver dúvidas sobre como obter seu token de acesso, consulte o tutorial Autenticação e Autorização. Além disso, recomendamos validar o JSON que estiver enviando antes de realizar a solicitação POST; por isso, é melhor consultar nosso tutorial de validação de anúncios. É fácil e rápido. Você pode criar um JSON para seu imóvel com base no exemplo abaixo, ou simplesmente enviá-lo, e você estará publicando um imóvel de exemplo no site:
Ejemplo:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d {
"title": "Property title",
"category_id": "MLA401686",
"price": 100000,
"currency_id": "ARS",
"available_quantity": 1,
"buying_mode": "classified",
"listing_type_id": "silver",
"condition": "not_specified",
"channels":
[
"marketplace"
],
"pictures": [
{
"source":"http://mla-d2-p.mlstatic.com/item-de-test-no-ofertar-543605-MLA25041518406_092016-O.jpg?square=false"
}
],
"seller_contact": {
"contact": "Contact name",
"other_info": "Additional contact info",
"area_code": "011",
"phone": "4444-5555",
"area_code2": "",
"phone2": "",
"email": "contact-email@somedomain.com",
"webmail": ""
},
"location": {
"address_line": "My property address 1234",
"zip_code": "01234567",
"neighborhood": {
"id": "TUxBQlBBUzgyNjBa"
},
"latitude": -34.48755,
"longitude": -58.56987
},
"attributes": [
{
"id": "ROOMS",
"value_name": "2"
},
{
"id": "FULL_BATHROOMS",
"value_name": "1"
},
{
"id": "PARKING_LOTS",
"value_name": "1"
},
{
"id": "BEDROOMS",
"value_name": "4"
},
{
"id": "COVERED_AREA",
"value_name": "30 m²"
},
{
"id": "TOTAL_AREA",
"value_name": "40 m²"
}
],
"description": {plain_text: "This is the real estate property description. \n"},
}
https://api.mercadolibre.com/itemsRespuesta:
{
"id": "MLA839018613",
"site_id": "MLA",
"title": "Property Title",
"subtitle": null,
"seller_id": 526655030,
"category_id": "MLA401686",
"official_store_id": null,
"price": 100000,
"base_price": 100000,
"original_price": null,
"inventory_id": null,
"currency_id": "ARS",
"initial_quantity": 1,
"available_quantity": 1,
"sold_quantity": 0,
"sale_terms": [],
"buying_mode": "classified",
"listing_type_id": "silver",
"start_time": "2020-02-13T19:29:01.499Z",
"stop_time": "2020-05-14T04:00:00.000Z",
"end_time": "2020-05-14T04:00:00.000Z",
"expiration_time": null,
"condition": "not_specified",
"permalink": "http://departamento.mercadolibre.com.ar/MLA-839018613-property-title-_JM",
"pictures": [
{
"id": "910707-MLA40763776324_022020",
"url": "http://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/O-ES.jpg",
"secure_url": "https://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/O-ES.jpg",
"size": "500x500",
"max_size": "500x500",
"quality": ""
}
],
"video_id": null,
"descriptions": [
{
"id": "MLA839018613-2516619253"
}
],
"accepts_mercadopago": false,
"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": 1087750186,
"comment": "Referencia: 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.5545188,
"longitude": -58.4915986,
"search_location": {
"neighborhood": {
"id": "TUxBQlNBQTM3Mzda",
"name": "Saavedra"
},
"city": {
"id": "TUxBQ0NBUGZlZG1sYQ",
"name": "Capital Federal"
},
"state": {
"id": "TUxBUENBUGw3M2E1",
"name": "Capital Federal"
}
}
},
"seller_contact": {
"contact": "Contact name",
"other_info": "Additional contact info",
"area_code": "011",
"phone": "4444-5555",
"area_code2": "",
"phone2": "",
"email": "contact-email@somedomain.com",
"webpage": "",
"country_code": "",
"country_code2": ""
},
"location": {
"address_line": "My property address 1234",
"zip_code": "01234567",
"neighborhood": {
"id": "TUxBQlBBUzgyNjBa",
"name": "Paso del Rey"
},
"city": {
"id": "TUxBQ01PUmViMTE3",
"name": "Moreno"
},
"state": {
"id": "TUxBUEdSQWVmNTVm",
"name": "Bs.as. G.b.a. Oeste"
},
"country": {
"id": "AR",
"name": "Argentina"
},
"latitude": -34.48755,
"longitude": -58.56987,
"open_hours": ""
},
"geolocation": {
"latitude": -34.48755,
"longitude": -58.56987
},
"coverage_areas": [],
"attributes": [
{
"id": "ROOMS",
"name": "Ambientes",
"value_id": null,
"value_name": "2",
"value_struct": null,
"values": [
{
"id": null,
"name": "2",
"struct": null
}
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "FULL_BATHROOMS",
"name": "Baños",
"value_id": null,
"value_name": "1",
"value_struct": null,
"values": [
{
"id": null,
"name": "1",
"struct": null
}
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "PARKING_LOTS",
"name": "Cocheras",
"value_id": null,
"value_name": "1",
"value_struct": null,
"values": [
{
"id": null,
"name": "1",
"struct": null
}
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "BEDROOMS",
"name": "Dormitorios",
"value_id": null,
"value_name": "4",
"value_struct": null,
"values": [
{
"id": null,
"name": "4",
"struct": null
}
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "COVERED_AREA",
"name": "Superficie cubierta",
"value_id": null,
"value_name": "30 m²",
"value_struct": {
"number": 30,
"unit": "m²"
},
"values": [
{
"id": null,
"name": "30 m²",
"struct": {
"number": 30,
"unit": "m²"
}
}
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "TOTAL_AREA",
"name": "Superficie total",
"value_id": null,
"value_name": "40 m²",
"value_struct": {
"number": 40,
"unit": "m²"
},
"values": [
{
"id": null,
"name": "40 m²",
"struct": {
"number": 40,
"unit": "m²"
}
}
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "PROPERTY_TYPE",
"name": "Inmueble",
"value_id": "242062",
"value_name": "Departamento",
"value_struct": null,
"values": [
{
"id": "242062",
"name": "Departamento",
"struct": null
}
],
"attribute_group_id": "MAIN",
"attribute_group_name": "Principales"
},
{
"id": "OPERATION",
"name": "Operación",
"value_id": "242075",
"value_name": "Venta",
"value_struct": null,
"values": [
{
"id": "242075",
"name": "Venta",
"struct": null
}
],
"attribute_group_id": "MAIN",
"attribute_group_name": "Principales"
},
{
"id": "OPERATION_SUBTYPE",
"name": "Subtipo de operación",
"value_id": "244562",
"value_name": "Propiedad individual",
"value_struct": null,
"values": [
{
"id": "244562",
"name": "Propiedad individual",
"struct": null
}
],
"attribute_group_id": "MAIN",
"attribute_group_name": "Principales"
}
],
"warnings": [],
"listing_source": "",
"variations": [],
"thumbnail": "http://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/I-ES.jpg",
"secure_thumbnail": "https://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/I-ES.jpg",
"status": "active",
"sub_status": [],
"tags": [
"test_item"
],
"warranty": null,
"catalog_product_id": null,
"domain_id": null,
"seller_custom_field": null,
"parent_item_id": null,
"differential_pricing": null,
"deal_ids": [],
"automatic_relist": false,
"date_created": "2020-02-13T19:29:01.823Z",
"last_updated": "2020-02-13T19:29:01.823Z",
"health": null,
"catalog_listing": false,
"item_relations": []
}
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 Vehículos e Inmuebles, 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"
}
]
}
}Vídeo, vídeo 360 e tour virtual
Para publicar um vídeo, vídeo 360 ou tour virtual por um imóvel, você deve usar o campo video_id na publicação, que é composto pelo string correspondente ao id do recurso multimídia e um identificador do provedor ou plataforma relacionada ao recurso. Assim, video_id=multimedia_resource_id;multimedia_provider_id suporta estes 2 tipos de recursos multimídia:
Youtube (apenas para vídeo), por exemplo: “video_id”;“gqkEN9poKM;youtube”
Matterport (apenas para tour virtual), por exemplo: “video_id”;“gqkEN9poKM;matterport”
Só é possível denunciar um tipo de conteúdo multimídia, ou seja, é necessário enviar o link do vídeo do YouTube ou uma url do Matterport.
Modificar a localização de imóveis
Para realizar alterações na publicação, deve ser enviado um PUT com os novos campos a serem alterados. No exemplo abaixo, é enviada uma nova localização:
ccurl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -d '{
"location": {
"address_line": "My property address NEW 111",
"zip_code": "5000",
"neighborhood":{
"id":"TUxBQlBBTDI1MTVa",
"name":"Palermo"
},
"city":{
"id":"TUxBQ0NBUGZlZG1sYQ",
"name":"Capital Federal"
}
}
}
}' https://api.mercadolibre.com/items/{item_id}Resposta:
{
"id": "MLA839018613",
"site_id": "MLA",
"title": "Property Title",
"subtitle": null,
"seller_id": 526655030,
"category_id": "MLA401686",
"official_store_id": null,
"price": 100000,
"base_price": 100000,
"original_price": null,
"inventory_id": null,
"currency_id": "ARS",
"initial_quantity": 1,
"available_quantity": 1,
"sold_quantity": 0,
"sale_terms": [],
"buying_mode": "classified",
"listing_type_id": "silver",
"start_time": "2020-02-13T19:29:01.000Z",
"stop_time": "2020-05-14T04:00:00.000Z",
"end_time": "2020-05-14T04:00:00.000Z",
"expiration_time": null,
"condition": "not_specified",
"permalink": "http://departamento.mercadolibre.com.ar/MLA-839018613-property-title-_JM",
"pictures": [
{
"id": "910707-MLA40763776324_022020",
"url": "http://mla-s1-p.mlstatic.com/910707-MLA40763776324_022020-O.jpg",
"secure_url": "https://mla-s1-p.mlstatic.com/910707-MLA40763776324_022020-O.jpg",
"size": "500x438",
"max_size": "548x481",
"quality": ""
}
],
"video_id": null,
"descriptions": [
{
"id": "MLA839018613-2516619253"
}
],
"accepts_mercadopago": false,
"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": 1087750186,
"comment": "Referencia: 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.5545188,
"longitude": -58.4915986,
"search_location": {
"neighborhood": {
"id": "TUxBQlNBQTM3Mzda",
"name": "Saavedra"
},
"city": {
"id": "TUxBQ0NBUGZlZG1sYQ",
"name": "Capital Federal"
},
"state": {
"id": "TUxBUENBUGw3M2E1",
"name": "Capital Federal"
}
}
},
"seller_contact": {
"contact": "Contact name",
"other_info": "Additional contact info",
"area_code": "011",
"phone": "4444-5555",
"area_code2": "",
"phone2": "",
"email": "contact-email@somedomain.com",
"webpage": "",
"country_code": "",
"country_code2": ""
},
"location": {
"address_line": "My property address NEW 111",
"zip_code": "5000",
"neighborhood": {
"id": "TUxBQlBBTDI1MTVa",
"name": "Palermo"
},
"city": {
"id": "TUxBQ0NBUGZlZG1sYQ",
"name": "Capital Federal"
},
"state": {
"id": "TUxBUENBUGw3M2E1",
"name": "Capital Federal"
},
"country": {
"id": "AR",
"name": "Argentina"
},
"latitude": -34.6315538,
"longitude": -58.7404704,
"open_hours": ""
},
"geolocation": {
"latitude": -34.6315538,
"longitude": -58.7404704
},
"coverage_areas": [],
"attributes": [
{
"id": "PARKING_LOTS",
"name": "Cocheras",
"value_id": null,
"value_name": "1",
"value_struct": null,
"values": [
{
"id": null,
"name": "1",
"struct": null
}
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "COVERED_AREA",
"name": "Superficie cubierta",
"value_id": null,
"value_name": "30 m²",
"value_struct": {
"unit": "m²",
"number": 30
},
"values": [
{
"id": null,
"name": "30 m²",
"struct": {
"unit": "m²",
"number": 30
}
}
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "TOTAL_AREA",
"name": "Superficie total",
"value_id": null,
"value_name": "40 m²",
"value_struct": {
"unit": "m²",
"number": 40
},
"values": [
{
"id": null,
"name": "40 m²",
"struct": {
"unit": "m²",
"number": 40
}
}
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "ROOMS",
"name": "Ambientes",
"value_id": null,
"value_name": "2",
"value_struct": null,
"values": [
{
"id": null,
"name": "2",
"struct": null
}
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "BEDROOMS",
"name": "Dormitorios",
"value_id": null,
"value_name": "4",
"value_struct": null,
"values": [
{
"id": null,
"name": "4",
"struct": null
}
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "FULL_BATHROOMS",
"name": "Baños",
"value_id": null,
"value_name": "1",
"value_struct": null,
"values": [
{
"id": null,
"name": "1",
"struct": null
}
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "OPERATION",
"name": "Operación",
"value_id": "242075",
"value_name": "Venta",
"value_struct": null,
"values": [
{
"id": "242075",
"name": "Venta",
"struct": null
}
],
"attribute_group_id": "MAIN",
"attribute_group_name": "Principales"
},
{
"id": "PROPERTY_TYPE",
"name": "Inmueble",
"value_id": "242062",
"value_name": "Departamento",
"value_struct": null,
"values": [
{
"id": "242062",
"name": "Departamento",
"struct": null
}
],
"attribute_group_id": "MAIN",
"attribute_group_name": "Principales"
},
{
"id": "OPERATION_SUBTYPE",
"name": "Subtipo de operación",
"value_id": "244562",
"value_name": "Propiedad individual",
"value_struct": null,
"values": [
{
"id": "244562",
"name": "Propiedad individual",
"struct": null
}
],
"attribute_group_id": "MAIN",
"attribute_group_name": "Principales"
}
],
"warnings": [],
"listing_source": "",
"variations": [],
"thumbnail": "http://mla-s1-p.mlstatic.com/910707-MLA40763776324_022020-I.jpg",
"secure_thumbnail": "https://mla-s1-p.mlstatic.com/910707-MLA40763776324_022020-I.jpg",
"status": "active",
"sub_status": [],
"tags": [
"test_item"
],
"warranty": null,
"catalog_product_id": null,
"domain_id": "MLA-INDIVIDUAL_APARTMENTS_FOR_SALE",
"seller_custom_field": null,
"parent_item_id": null,
"differential_pricing": null,
"deal_ids": [],
"automatic_relist": false,
"date_created": "2020-02-13T19:29:01.000Z",
"last_updated": "2020-02-13T19:48:23.890Z",
"health": null,
"catalog_listing": false,
"item_relations": []
}Lojas Oficiais para Veículos e Imóveis
O campo official_store_id é obrigatório para todas as publicações dos usuários que possuem uma Loja Oficial associada. Se o vendedor não tiver uma Loja Oficial associada, você poderá enviar o campo official_store_id como null. O objetivo deste campo é associar o item à Loja Oficial correspondente ao ID. Consulte a seguinte documentação nas Lojas Oficiais para saber mais. Se já tem uma Loja Oficial e não é mencionada, dará erro:
{"message"=>"Validation error", "error"=>"validation_error", "status"=>400, "cause"=>[{"department"=>"items", "cause_id"=>144, "type"=>"error", "code"=>"item.official_store_id.invalid", "references"=>["item.official_store_id", "item.seller_id"], "message"=>"Users type brand have to provide a official store id"}]}
Como saber se o seu vendedor tem uma Loja Oficial
Caso o vendedor tenha uma Loja Oficial, você pode obter o ID e mais detalhes da marca seguindo este guia.
Como adicionar o official_store_id
Ao publicar (POST) o item, você deve adicionar o ID da loja no campo official_store_id. No caso do update (PUT), você deve adicionar o campo official_store_id apenas se for necessário atualizar explicitamente.
Saiba mais como publicar um item
A publicação de um item em uma Loja Oficial é o mesmo que a publicação de qualquer outro item, exceto que você também deve adicionar o atributo official_store_id no JSON.
Exemplo:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
"title":"Item de Test -No Ofertar",
"category_id":"MLA401686",
"price":137000,
"official_store_id": 3121,
"currency_id":"USD",
"available_quantity":1,
"buying_mode":"classified",
"listing_type_id":"silver",
"condition":"new",
"description": "Item:, Depto 2 Amb Semipiso Con Balcón Terraza Al Frente!",
"video_id": "YOUTUBE_ID_HERE",
"pictures":[
{"source":"http://upload.wikimedia.org/wikipedia/commons/f/fd/ap.jpg"},
{"source":"http://en.wikipedia.org/wiki/File:Teashades.gif"}
]
}'
https://api.mercadolibre.com/itemsResposta:
{
"id": "MLA839018613",
"site_id": "MLA",
"title": "Property Title",
"subtitle": null,
"seller_id": 526655030,
"category_id": "MLA401686",
"official_store_id": 3121,
"price": 100000,
"base_price": 100000,
"original_price": null,
"inventory_id": null,
"currency_id": "ARS",
"initial_quantity": 1,
"available_quantity": 1,
"sold_quantity": 0,
"sale_terms": [],
"buying_mode": "classified",
"listing_type_id": "silver",
"start_time": "2020-02-13T19:29:01.499Z",
"stop_time": "2020-05-14T04:00:00.000Z",
"end_time": "2020-05-14T04:00:00.000Z",
"expiration_time": null,
"condition": "not_specified",
"permalink": "http://departamento.mercadolibre.com.ar/MLA-839018613-property-title-_JM",
"pictures": [
{
"id": "910707-MLA40763776324_022020",
"url": "http://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/O-ES.jpg",
"secure_url": "https://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/O-ES.jpg",
"size": "500x500",
"max_size": "500x500",
"quality": ""
}
],
"video_id": null,
"descriptions": [
{
"id": "MLA839018613-2516619253"
}
],
"accepts_mercadopago": false,
"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": 1087750186,
"comment": "Referencia: 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.5545188,
"longitude": -58.4915986,
"search_location": {
"neighborhood": {
"id": "TUxBQlNBQTM3Mzda",
"name": "Saavedra"
},
"city": {
"id": "TUxBQ0NBUGZlZG1sYQ",
"name": "Capital Federal"
},
"state": {
"id": "TUxBUENBUGw3M2E1",
"name": "Capital Federal"
}
}
},
"seller_contact": {
"contact": "Contact name",
"other_info": "Additional contact info",
"area_code": "011",
"phone": "4444-5555",
"area_code2": "",
"phone2": "",
"email": "contact-email@somedomain.com",
"webpage": "",
"country_code": "",
"country_code2": ""
},
"location": {
"address_line": "My property address 1234",
"zip_code": "01234567",
"neighborhood": {
"id": "TUxBQlBBUzgyNjBa",
"name": "Paso del Rey"
},
"city": {
"id": "TUxBQ01PUmViMTE3",
"name": "Moreno"
},
"state": {
"id": "TUxBUEdSQWVmNTVm",
"name": "Bs.as. G.b.a. Oeste"
},
"country": {
"id": "AR",
"name": "Argentina"
},
"latitude": -34.48755,
"longitude": -58.56987,
"open_hours": ""
},
"geolocation": {
"latitude": -34.48755,
"longitude": -58.56987
},
"coverage_areas": [],
"attributes": [
{
"id": "ROOMS",
"name": "Ambientes",
"value_id": null,
"value_name": "2",
"value_struct": null,
"values": [
{
"id": null,
"name": "2",
"struct": null
}
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "FULL_BATHROOMS",
"name": "Baños",
"value_id": null,
"value_name": "1",
"value_struct": null,
"values": [
{
"id": null,
"name": "1",
"struct": null
}
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "PARKING_LOTS",
"name": "Cocheras",
"value_id": null,
"value_name": "1",
"value_struct": null,
"values": [
{
"id": null,
"name": "1",
"struct": null
}
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "BEDROOMS",
"name": "Dormitorios",
"value_id": null,
"value_name": "4",
"value_struct": null,
"values": [
{
"id": null,
"name": "4",
"struct": null
}
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "COVERED_AREA",
"name": "Superficie cubierta",
"value_id": null,
"value_name": "30 m²",
"value_struct": {
"number": 30,
"unit": "m²"
},
"values": [
{
"id": null,
"name": "30 m²",
"struct": {
"number": 30,
"unit": "m²"
}
}
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "TOTAL_AREA",
"name": "Superficie total",
"value_id": null,
"value_name": "40 m²",
"value_struct": {
"number": 40,
"unit": "m²"
},
"values": [
{
"id": null,
"name": "40 m²",
"struct": {
"number": 40,
"unit": "m²"
}
}
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "PROPERTY_TYPE",
"name": "Inmueble",
"value_id": "242062",
"value_name": "Departamento",
"value_struct": null,
"values": [
{
"id": "242062",
"name": "Departamento",
"struct": null
}
],
"attribute_group_id": "MAIN",
"attribute_group_name": "Principales"
},
{
"id": "OPERATION",
"name": "Operación",
"value_id": "242075",
"value_name": "Venta",
"value_struct": null,
"values": [
{
"id": "242075",
"name": "Venta",
"struct": null
}
],
"attribute_group_id": "MAIN",
"attribute_group_name": "Principales"
},
{
"id": "OPERATION_SUBTYPE",
"name": "Subtipo de operación",
"value_id": "244562",
"value_name": "Propiedad individual",
"value_struct": null,
"values": [
{
"id": "244562",
"name": "Propiedad individual",
"struct": null
}
],
"attribute_group_id": "MAIN",
"attribute_group_name": "Principales"
}
],
"warnings": [],
"listing_source": "",
"variations": [],
"thumbnail": "http://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/I-ES.jpg",
"secure_thumbnail": "https://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/I-ES.jpg",
"status": "active",
"sub_status": [],
"tags": [
"test_item"
],
"warranty": null,
"catalog_product_id": null,
"domain_id": null,
"seller_custom_field": null,
"parent_item_id": null,
"differential_pricing": null,
"deal_ids": [],
"automatic_relist": false,
"date_created": "2020-02-13T19:29:01.823Z",
"last_updated": "2020-02-13T19:29:01.823Z",
"health": null,
"catalog_listing": false,
"item_relations": []
}Conheça os erros comuns ao postar em Lojas Oficiais
Abaixo, você pode ver o erro 400 recebido pelos usuários associados às lojas oficiais que não enviam o atributo.
Se você não enviar o official_store_id do item para uma loja multimarca oficial, receberá em resposta os possíveis IDs que você poderia enviar com seu usuário:
"message": "Validation error",
"error": "validation_error",
"status": 400,
"cause": [{
"code": "item.official_store_id.invalid",
"message": "Users type brand have to provide a official store id"Se você enviar um official_store_id inválido para uma loja multimarca oficial, receberá:
{
"message": "body.invalid_official_store_id",
"error": "The seller 148829068 is not allowed to use official_store_id 315 on site MLA.",
"status": 403,
"cause": []
}
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 suporte.
Proximo: Sincronização de publicações.