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
Publicar Imóveis
Esta seção detalha como utilizar a API do Mercado Livre para publicar anúncios de imóveis. Ao integrar nossa API, você poderá automatizar a publicação de imóveis, simplificando a gestão de grandes catálogos e a integração com sistemas de administração imobiliária.
Preparação para a Publicação
Lembre-se de que você precisará de um access_token para realizar a publicação.
-
Obtenção do
access_token: Se tiver dúvidas sobre como obter seuaccess_token, consulte o guia de Autenticação e Autorização. -
Validação do JSON:
Recomendamos validar o JSON que você envia antes de fazer a solicitação
POST. Para isso, consulte o tutorial de validação de anúncios. - Criação do JSON: Você pode criar um JSON para seu imóvel com base no exemplo fornecido em Publique seu imóvel. Alternativamente, é possível enviar o JSON diretamente para publicar um produto de teste no site.
Pronto! Continue para a próxima etapa >
Publique seu imóvel
Para publicar seu imóvel, envie uma solicitação POST para o endpoint /items. Certifique-se de incluir todas as informações obrigatórias, que podem ser consultadas nas guias de Atributos, Localizar imóveis e Qualidade das publicações. Essas informações o ajudarão a preparar uma publicação correta e completa.
Exemplo de chamada:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' "Content-Type: application/json" -d '{
"title": "Título do imóvel",
"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": "Nome do contato",
"other_info": "Informações adicionais de contato",
"area_code": "011",
"phone": "4444-5555",
"area_code2": "",
"phone2": "",
"email": "contato@suaempresa.com",
"webmail": ""
},
"location": {
"address_line": "Endereço do imóvel 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²"
}
],
"video_id": "gqkEN9poKM;matterport",
"description": {
"plain_text": "Esta é a descrição do imóvel.\n"
}
}'
https://api.mercadolibre.com/items
Exemplo de 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.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": []
}
Parâmetros de resposta
| Parâmetro | Tipo | Descrição |
|---|---|---|
| id | String | Identificador único do item publicado (ex.: "MLA839018613"). |
| site_id | String | Identificador do site onde o item foi publicado (ex.: "MLA"). |
| title | String | Título da publicação. |
| subtitle | String | Subtítulo do item (pode ser null). |
| seller_id | Integer | Identificador do vendedor. |
| category_id | String | Identificador da categoria selecionada (ex.: "MLA401686"). |
| official_store_id | Integer | Identificador da loja oficial. |
| price | Integer | Preço do item publicado. |
| currency_id | String | Identificador da moeda (ex.: "ARS"). |
| available_quantity | Integer | Quantidade disponível do item (para imóveis será sempre 1). |
| sold_quantity | Integer | Quantidade vendida. |
| buying_mode | String | Modo de compra (ex.: "classified"). |
| listing_type_id | String | Tipo de publicação de acordo com o pacote contratado. |
| start_time | String | Data de início da publicação. |
| end_time | String | Data de finalização da publicação. |
| status | String | Status da publicação (ex.: "active"). |
| permalink | String | Link público da publicação. |
| thumbnail | String | URL da imagem principal do item. |
| pictures | Array | Lista de imagens do item. |
| attributes | Array | Atributos da publicação (ex.: quartos, banheiros, área). |
| seller_contact | Object | Dados de contato do vendedor. |
| location | Object | Informações de localização do imóvel. |
| geolocation | Object | Latitude e longitude. |
| date_created | String | Data de criação. |
| last_updated | String | Última data de atualização. |
| channels | Array | Canais de publicação (ex.: "marketplace"). |
Publicar imóveis no Portal Imobiliário (Chile)
No Chile (MLC), para que o item seja corretamente carregado tanto no Mercado Livre quanto no Portal Imobiliário, é necessário incluir no corpo da requisição o atributo CMG_SITE. Isso adicionará o campo listing_source: portalinmobiliario, tornando a publicação visível em ambos os portais.
Para incluí-lo, execute a seguinte chamada:
{
"id": "CMG_SITE",
"name": "Site de origem",
"value_id": null,
"value_name": "POI",
"value_struct": null,
"attribute_group_id": "OTHERS",
"attribute_group_name": "Outros"
}
Leituras recomendadas
- Publicações de lojas oficiais
- Atualize seu imóvel
- Ciclo de vida das publicações
- Qualidade das publicações
- Leads
Atualizações de versão
Esta seção fornece informações sobre as atualizações da API, incluindo:
Histórico de mudanças
| Data | Versão | Descrição |
|---|---|---|
| 06/11/2025 | 1.0 | Publicação inicial |