Publicação de imóveis

Toda vez que os usuários buscam imóveis para alugar ou comprar e se interessam por uma de suas publicações, podem entrar em contato com você imediatamente.

Conteúdos

→Consultar imóvel →Definição de atributos    ↳Title    ↳Description    ↳Localização    ↳Contatos do vendedor    ↳Imagens    ↳Categorias e atributos    ↳Price    ↳Moedas    ↳Listing type    ↳Available_quantity    ↳Condition →Publicação de um imóvel →Itens penalizados →Vídeo, vídeo 360 e tour virtual →Modificar a localização de imóveis →Lojas Oficiais para Veículos e Imóveis    ↳Como saber se o seu vendedor tem uma Loja Oficial    ↳Como adicionar o official_store_id    ↳Saiba mais como publicar um item    ↳Conheça os erros comuns ao postar em Lojas Oficiais →Configurar pacote para usuários teste

Nota:
Agregamos um novo substatus para publicações que superem a quantidade do pacote contratado pelo cliente, isso pode ocorrer ao executar um proceso massivo de publicação. Os anúncios passarão do status "not_yet_active" para “closed” com substatus "pack_quota_exceeded” no mesmo dia de sua criação.


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_ID

Exemplo:

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

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,
    "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.

Nota:
Ao realizar um POST deve ser especificado o channel ao qual está publicando, envie marketplace para não obter erros ao publicar um item de classificados, pode ver o campo no exemplo do POST.


Title

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

Carregar a descrição em um item

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

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


Nota:
A descrição do produto deve ser em texto sem formatação. Não informe contato como número de telefone, endereço ou site neste campo. Caso você envie, aceitaremos o anúncio, mas será penalizado ou moderado e não ficará bem posicionado nas buscas. Para consultar os anuncios moderados, utilize nosso guia de Gerenciamento de moderações.


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",
  },
Nota:
Quando há perguntas de compradores nos anúncios, o Mercado Livre as envia ao e-mail do vendedor, informando no campo seller_contact.email. Caso este campo que não esteja preenchido, o Mercado Livre utilizará o e-mail da conta do vendedor no site.
Para gerenciar perguntas por API utilize nosso guia Gerencie perguntas e respostas. Caso o campo “seller_contact” esteja como “not_allowed” a categoria não permite carregar informações ao respeito.
Os campos country_code2, area_code2, phone2 podem ser utilizados para que o vendedor receba contatos por WhatsApp.


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.

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


Categorias e Atributos

Os vendedores deverão definir uma categoria 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.

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/items

Respuesta:

{
    "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": []
}
Nota:
Para Mercado Libre México, itens imobiliários publicados a partir da API do Mercado Libre também serão exibidos automaticamente no site metroscubicos.com.


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.

Nota:
Esta funcionalidade está disponível para todos os sites, exceto propriedades publicadas em:
Mercado Livre Brasil: na categoria Empreendimentos imobiliários.
Mercado Libre Venezuela: Tu inmueble.
Mercado Libre México: Metros Cúbicos.


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/items

Resposta:

{
    "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 formulário.


Proximo: Sincronização de publicações.

ou registre-se para receber as últimas notícias sobre nossa API