Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Localizar Inmuebles
Introducción: Potenciando la búsqueda y publicación de inmuebles con nuestra API
Explorar Países
Este es el punto de partida para usar la API. Te da la lista de países donde opera MercadoLibre y donde puedes buscar inmuebles. Úsalo para crear apps que funcionen en varios países, permitiendo a los usuarios elegir el país que les interesa antes de buscar propiedades.
La respuesta que obtienes es una lista de objetos JSON, cada uno representa un país con la información que necesitas para seguir usando la API.
curl -X GET
-H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/classified_locations/countries
Ejemplo de Respuesta:
[
{
"id": "AR",
"name": "Argentina",
"locale": "es_AR",
"currency_id": "ARS"
},
{
"id": "BO",
"name": "Bolivia",
"locale": "es_BO",
"currency_id": "BOB"
},
{
"id": "BR",
"name": "Brasil",
"locale": "pt_BR",
"currency_id": "BRL"
},
{
"id": "CL",
"name": "Chile",
"locale": "es_CL",
"currency_id": "CLP"
},
{
"id": "CN",
"name": "China",
"locale": "zh_CN",
"currency_id": "CNY"
},
{
"id": "CO",
"name": "Colombia",
"locale": "es_CO",
"currency_id": "COP"
},
{
"id": "CR",
"name": "Costa Rica",
"locale": "es_CR",
"currency_id": "CRC"
},
{
"id": "CBT",
"name": "Cross Border Trade",
"locale": "es_AR",
"currency_id": "ARS"
},
{
"id": "EC",
"name": "Ecuador",
"locale": "es_EC",
"currency_id": "USD"
},
{
"id": "SV",
"name": "El Salvador",
"locale": "es_SV",
"currency_id": "USD"
},
{
"id": "GT",
"name": "Guatemala",
"locale": "es_GT",
"currency_id": "GTQ"
},
{
"id": "HN",
"name": "Honduras",
"locale": "es_HN",
"currency_id": "HNL"
},
{
"id": "MX",
"name": "Mexico",
"locale": "es_MX",
"currency_id": "MXN"
},
{
"id": "NI",
"name": "Nicaragua",
"locale": "es_NI",
"currency_id": "NIO"
},
{
"id": "PA",
"name": "Panamá",
"locale": "es_PA",
"currency_id": "USD"
},
{
"id": "PY",
"name": "Paraguay",
"locale": "es_PY",
"currency_id": "PYG"
},
{
"id": "PE",
"name": "Peru",
"locale": "es_PE",
"currency_id": "PEN"
},
{
"id": "PT",
"name": "Portugal",
"locale": "pt_PT",
"currency_id": "EUR"
},
{
"id": "PR",
"name": "Puerto Rico",
"locale": "es_PR",
"currency_id": "USD"
},
{
"id": "GB",
"name": "Reino Unido",
"locale": "en_GB",
"currency_id": "GBP"
},
{
"id": "DO",
"name": "República Dominicana",
"locale": "es_DO",
"currency_id": "DOP"
},
{
"id": "UY",
"name": "Uruguay",
"locale": "es_UY",
"currency_id": "UYU"
},
{
"id": "VE",
"name": "Venezuela",
"locale": "es_VE",
"currency_id": "VES"
},
{
"id": "COL",
"name": "newCOL",
"locale": "es_COL",
"currency_id": "COLS"
}
]
Estructura de respuesta esperada
El resultado esperado es un arreglo de países con la siguiente estructura:
| Parámetro | Tipo | Opcional | Descripción |
|---|---|---|---|
| id | String | No | Identificador único de 2 o 3 caracteres |
| name | String | No | Nombre del País |
| locale | String | No | Locale determinado para el país |
| currency_id | String | No | Identificador de moneda principal del país |
Explorar información del País
Después de obtener la lista de países, puedes explorar los detalles de cada uno. Esto te permitirá conocer información específica sobre sus estados, ciudades y otros aspectos relevantes.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/classified_locations/countries/$COUNTRY_ID
Parámetros
Id del País: El parámetro COUNTRY_ID permite filtrar por país. Admite el uso del identificador (ID) del país, en formato de 2 o 3 caracteres, como se detalla en la estructura previa.
Ejemplo de llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/classified_locations/countries/AR
Respuesta:
{
"id": "AR",
"name": "Argentina",
"locale": "es_AR",
"currency_id": "ARS",
"decimal_separator": ",",
"thousands_separator": ".",
"time_zone": "GMT-03:00",
"time_zone_name": "",
"geo_information": {
"location": {
"latitude": -38.416096,
"longitude": -63.616673
}
},
"states": [
{ "id": "TUxBUEJSQWwyMzA1", "name": "Brasil" },
{ "id": "TUxBUENPU2ExMmFkMw", "name": "Bs.As. Costa Atlántica" },
{ "id": "TUxBUEdSQWU4ZDkz", "name": "Bs.As. G.B.A. Norte" },
{ "id": "TUxBUEdSQWVmNTVm", "name": "Bs.As. G.B.A. Oeste" },
{ "id": "TUxBUEdSQXJlMDNm", "name": "Bs.As. G.B.A. Sur" },
{ "id": "QnVlbm9zIEFpcmVz", "name": "Buenos Aires" },
{ "id": "TUxBUFpPTmFpbnRl", "name": "Buenos Aires Interior" },
{ "id": "TUxBUENBUGw3M2E1", "name": "Capital Federal" },
{ "id": "TUxBUENBVGFiY2Fm", "name": "Catamarca" },
{ "id": "TUxBUENIQW8xMTNhOA", "name": "Chaco" },
{ "id": "Y2hpbGU=", "name": "Chile" },
{ "id": "TUxBUENIVXQxNDM1MQ", "name": "Chubut" },
{ "id": "TUxBUENPUnM5MjI0", "name": "Corrientes" },
{ "id": "TUxBUENPUmFkZGIw", "name": "Córdoba" },
{ "id": "TUxBUEVOVHMzNTdm", "name": "Entre Ríos" },
{ "id": "TUxBUEZPUmE1OTk5", "name": "Formosa" },
{ "id": "TUxBUEpVSnk3YmUz", "name": "Jujuy" },
{ "id": "TUxBUExBWmE1OWMy", "name": "La Pampa" },
{ "id": "TUxBUExBWmEyNzY0", "name": "La Rioja" },
{ "id": "TUxBUE1FTmE5OWQ4", "name": "Mendoza" },
{ "id": "TUxBUE1JU3MzNjIx", "name": "Misiones" },
{ "id": "TUxBUE5FVW4xMzMzNQ", "name": "Neuquén" },
{ "id": "UHJvdmlua2lhdmVvIGRlIEJ1ZW5vcyBBaXJl", "name": "Província de Buenos Aires" },
{ "id": "TUxBUFJFUDQyMjQ4Ng", "name": "República Dominicana" },
{ "id": "TUxBUFLNT29iZmZm", "name": "Río Negro" },
{ "id": "TUxBUFNBTGFjMTJi", "name": "Salta" },
{ "id": "TUxBUFNBTm5lYjU4", "name": "San Juan" },
{ "id": "TUxBUFNBTnM0ZTcz", "name": "San Luis" },
{ "id": "TUxBUFNBTno3ZmY5", "name": "Santa Cruz" },
{ "id": "TUxBUFNBTmU5Nzk2", "name": "Santa Fe" },
{ "id": "TUxBUFNBTm9lOTlk", "name": "Santiago del Estero" },
{ "id": "TUxBUFRJRVoxM2M5YQ", "name": "Tierra del Fuego" },
{ "id": "TUxBUFRVQ244NmM3", "name": "Tucumán" },
{ "id": "TUxBUFVTQWl1cXdlMg", "name": "USA" },
{ "id": "TUxBUFVSVXllZDVl", "name": "Uruguay" }
]
}
Estructura de respuesta esperada
El resultado esperado es una entidad país con la siguiente estructura:
| Parámetro | Tipo | Opcional | Descripción |
|---|---|---|---|
| id | string | No | Identificador único de 2 o 3 caracteres |
| name | string | No | Nombre del País |
| locale | string | No | Locale determinado para el país |
| currency_id | string | No | Identificador de moneda principal del país |
| decimal_separator | string | No | Carácter designado como separador de decimales en el currency |
| thousands_separator | string | No | Carácter designado como separador de miles en el currency |
| time_zone | string | No | Time Zone local al país |
| time_zone_name | string | Sí | Nombre de ese time zone |
| geo_information.location.latitude | float | No | Latitud del país |
| geo_information.location.longitude | float | No | Longitud del país |
| states | array | No | Arreglo con listado de estados, cada uno identificados por un id y name |
Manejo de Errores
País no encontrado:
{
"message": "Country not found",
"error": "not_found",
"status": 404,
"cause": []
}
Explorar información de Estados
Tras obtener los identificadores de estado en las operaciones previas, se puede conseguir información adicional de cada uno de ellos (también conocidos como provincias o regiones en algunos países). Esta información ampliada incluirá datos como la geolocalización, las ciudades que corresponden a cada estado y otros detalles.
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/classified_locations/states/$STATE_ID
Parámetros:
Id del Estado: El parámetro STATE_ID permite filtrar por estado. Admite el uso del identificador (ID) del estado, en formato string o cadena de caracteres, como se detalla en la estructura previa.
Ejemplo de llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/classified_locations/states/TUxBUENPUmFkZGIw
Respuesta:
{
"id": "TUxBUENPUmFkZGIw",
"name": "Córdoba",
"country": { "id": "AR", "name": "Argentina" },
"geo_information": { "location": { "latitude": -32.2968402, "longitude": -63.580611 } },
"time_zone": "GMT-03:00",
"time_zone_name": "America/Cordoba",
"cities": [
{ "id": "TVhYQWNoaXJhc1RVeEJVRU5QVW1Ga1pHSXc", "name": "Achiras" },
{ "id": "TVhYQWx0YSBHcmFjaWFUVXhCVUVOUFVtRmtaR", "name": "Alta Gracia" },
{ "id": "TVhYQXJyb3lpdG9UVXhCVUVOUFVtRmtaR0l3", "name": "Arroyito" },
{ "id": "TVhYQmVycm90YXLDoW5UVXhCVUVOUFVtRmtaR", "name": "Berrotarán" },
{ "id": "TVhYQmlhbGV0IE1hc3PDqVRVeEJVRU5QVW1Ga", "name": "Bialet Massé" },
{ "id": "TUxBQ0NBTGMwYWZk", "name": "Calamuchita" },
{ "id": "TUxBQ0NPTDdlNmZl", "name": "Colón" },
{ "id": "TVhYQ29zcXXDrW5UVXhCVUVOUFVtRmtaR0l3", "name": "Cosquín" },
{ "id": "TVhYQ3J1eiBBbHRhVFV4QlVFTlBVbUZrWkdJd", "name": "Cruz Alta" },
{ "id": "TUxBQ0NSVWVjOGJh", "name": "Cruz del Eje" },
{ "id": "TUxBQ0NBUGNiZGQx", "name": "Córdoba" },
{ "id": "TVhYRnJleXJlVFV4QlVFTlBVbUZrWkdJdw", "name": "Freyre" },
{ "id": "TVhYR2VuZXJhbCBEZWhlemFUVXhCVUVOUFVtR", "name": "General Deheza" },
{ "id": "TUxBQ0dFTjMwYzFh", "name": "General Roca" },
{ "id": "TUxBQ0dFTmE2OGQ2", "name": "General San Martín" },
{ "id": "TUxBQ0lTQzJkZGM2", "name": "Ischilín" },
{ "id": "TVhYSmVzw7pzIE1hcsOtYVRVeEJVRU5QVW1Ga", "name": "Jesús María" },
{ "id": "TUxBQ0pVwTUyMmRh", "name": "Juárez Celman" },
{ "id": "TVhYTGEgQm9sc2FUVXhCVUVOUFVtRmtaR0l3", "name": "La Bolsa" },
{ "id": "TVhYTGEgQ2FsZXJhVFV4QlVFTlBVbUZrWkdJd", "name": "La Calera" },
{ "id": "TVhYTGEgQ2FybG90YVRVeEJVRU5QVW1Ga1pHS", "name": "La Carlota" },
{ "id": "TVhYTGEgRmFsZGFUVXhCVUVOUFVtRmtaR0l3", "name": "La Falda" },
{ "id": "TVhYTGEgUGFpc2FuaXRhVFV4QlVFTlBVbUZrW", "name": "La Paisanita" },
{ "id": "TVhYTGFndW5hIExhcmdhVFV4QlVFTlBVbUZrW", "name": "Laguna Larga" },
{ "id": "TVhYTG9zIEVzcGluaWxsb3NUVXhCVUVOUFVtR", "name": "Los Espinillos" },
{ "id": "TVhYTWFsYWd1ZcOxb1RVeEJVRU5QVW1Ga1pHS", "name": "Malagueño" },
{ "id": "TUxBQ01BUmU2ZjEx", "name": "Marcos Juárez" },
{ "id": "TVhYTWVuZGlvbGF6YVRVeEJVRU5QVW1Ga1pHS", "name": "Mendiolaza" },
{ "id": "TUxBQ01JTjI2ZDRi", "name": "Minas" },
{ "id": "TVhYT25jYXRpdm9UVXhCVUVOUFVtRmtaR0l3", "name": "Oncativo" },
{ "id": "TVhYT25nYW1pcmFUVXhCVUVOUFVtRmtaR0l3", "name": "Ongamira" },
{ "id": "TUxBQ1BPQ2RiODcy", "name": "Pocho" },
{ "id": "TVhYUG90cmVybyBkZSBHYXJheVRVeEJVRU5QV", "name": "Potrero de Garay" },
{ "id": "TUxBQ1BSRTljM2Mw", "name": "Presidente Roque Sáenz Peña" },
{ "id": "TVhYUHVlcnRvIGRlbCBBZ3VpbGFUVXhCVUVOU", "name": "Puerto del Aguila" },
{ "id": "TUxBQ1BVTjkyMmI4", "name": "Punilla" },
{ "id": "TVhYUsOtbyBDZWJhbGxvc1RVeEJVRU5QVW1Ga", "name": "Río Ceballos" },
{ "id": "TUxBQ1LNTzc4N2Fm", "name": "Río Cuarto" },
{ "id": "TUxBQ1LNT2E3Y2E5", "name": "Río Primero" },
{ "id": "TUxBQ1LNT2EzZjhm", "name": "Río Seco" },
{ "id": "TUxBQ1LNT2RiZTBj", "name": "Río Segundo" },
{ "id": "TUxBQ1NBTmIxNDY", "name": "San Alberto" },
{ "id": "TUxBQ1NBTjcyMDk5OA", "name": "San Francisco" },
{ "id": "TUxBQ1NBTjM3OTVl", "name": "San Javier" },
{ "id": "TUxBQ1NBTjk4MzY", "name": "San Justo" },
{ "id": "TUxBQ1NBTjlmZjVh", "name": "Santa María" },
{ "id": "TVhYU2FudGEgUm9zYSBkZSBDYWxhbXVjaGl0Y", "name": "Santa Rosa de Calamuchita" },
{ "id": "TUxBQ1NPQjVkNGVi", "name": "Sobremonte" },
{ "id": "TUxBQ1RFUmJmYmYy", "name": "Tercero Arriba" },
{ "id": "TUxBQ1RPVGIxNmYy", "name": "Totoral" },
{ "id": "TUxBQ1RVTDgxNTI5", "name": "Tulumba" },
{ "id": "TUxBQ1VOSTg2Yzhl", "name": "Unión" },
{ "id": "TVhYVmlsbGEgQWxsZW5kZVRVeEJVRU5QVW1Ga", "name": "Villa Allende" },
{ "id": "TVhYVmlsbGEgQ2FybG9zIFBhelTVeEJVRU5QV", "name": "Villa Carlos Paz" },
{ "id": "TVhYUGxvdHRpZXJUVXhCVUVOUFVtRmtaR0l3", "name": "Villa General Belgrano" },
{ "id": "TUxBQ1ZJTDE4NjE1Mg", "name": "Villa María" },
{ "id": "TVhYVmlsbGEgU2FudGEgUm9zYVRVeEJVRU5QV", "name": "Villa Santa Rosa" }
]
}
Estructura de respuesta esperada
El resultado esperado es una entidad Estado con la siguiente estructura:
| Parámetro | Tipo | Opcional | Descripción |
|---|---|---|---|
| id | string | No | Identificador único en formato cadena caracteres |
| name | string | No | Nombre del Estado |
| country.id | string | No | Identificador único de 2 o 3 caracteres |
| country.name | string | No | Nombre del País |
| geo_information.location.latitude | float | No | Latitud del estado |
| geo_information.location.longitude | float | No | Longitud del estado |
| time_zone | string | No | Time Zone local al estado |
| time_zone_name | string | No | Nombre de ese time zone |
| cities | array | No | Arreglo con listado de ciudades, cada una identificadas por un id y name |
Manejo de Errores
Estado no encontrado:
{
"message": "State not found",
"error": "not_found",
"status": 404,
"cause": []
}
Explorar información de Ciudades
Después de obtener los identificadores de ciudades en las operaciones previas, se puede conseguir información adicional de cada una de ellas. Esta información ampliada incluirá la geolocalización, los barrios o comunas que la componen y otros detalles. Es importante aclarar que estas ciudades pueden representar regiones menores donde se incluyan no solo barrios o comunas sino también pueblos enmarcados en la región.
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/classified_locations/cities/$CITY_ID
Parámetros:
Id del Ciudad: El parámetro CITY_ID permite filtrar por ciudad. Admite el uso del identificador (ID) de la ciudad, en formato string o cadena de caracteres, como se detalla en la estructura previa.
Ejemplo de llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/classified_locations/cities/TUxBQ1LNTzc4N2Fm
Respuesta:
{
"id": "TUxBQ1LNTzc4N2Fm",
"name": "Río Cuarto",
"state": { "id": "TUxBUENPUmFkZGIw", "name": "Córdoba" },
"country": { "id": "AR", "name": "Argentina" },
"neighborhoods": [
{ "id": "TUxBQkFERTc1Njc1OA", "name": "Adelia María" },
{ "id": "TUxBQkFMQzUxMTMxNg", "name": "Alcira" },
{ "id": "TUxBQkFMUDQ0Nzk5MA", "name": "Alpa Corral" },
{ "id": "TUxBQkJFUjUxNzQyMg", "name": "Berrotarán" },
{ "id": "TUxBQkJVTDUzODIyMA", "name": "Bulnes" },
{ "id": "TUxBQkNIQTYxMTY3MQ", "name": "Chaján" },
{about:blank#blocked
"id": "TUxBQkNIVTQ2OTM5NA",
"name": "Chucul"
},
{ "id": "TUxBQkNPUjg0MTg2NQ", "name": "Coronel Baigorria" },
{ "id": "TUxBQkNPUjYwMjM4OQ", "name": "Coronel Moldes" },
{ "id": "TUxBQkVMRTc3MDY5MQ", "name": "Elena" },
{ "id": "TUxBQkxBQzU2NTY4OQ", "name": "La Carolina" },
{ "id": "TUxBQkxBQzk2NzMzNg", "name": "La Cautiva" },
{ "id": "TUxBQkxBRzU0OTAyNg", "name": "La Gilda" },
{ "id": "TUxBQkxBUzkyODY4MQ", "name": "Las Acequias" },
{ "id": "TUxBQkxBUzU1NzY0NQ", "name": "Las Albahacas" },
{ "id": "TUxBQkxBUzU4OTkzMQ", "name": "Las Higueras" },
{ "id": "TUxBQkxBUzU0MjIyOA", "name": "Las Peñas" },
{ "id": "TUxBQkxBUzIzMTA1NQ", "name": "Las Vertientes" },
{ "id": "TUxBQk1BTDI2MTYwNA", "name": "Malena" },
{ "id": "TUxBQk1PTjIzNjExOQ", "name": "Monte de los Gauchos" },
{ "id": "TUxBQlBBUzg5NDM5Ng", "name": "Paso del Durazno" },
{ "id": "TUxBQlLNTzM2NDg2OA", "name": "Río Cuarto" },
{ "id": "TUxBQlNBTTkxNzExOQ", "name": "Sampacho" },
{ "id": "TUxBQlNBTjE3MDY1Mw", "name": "San Basilio" },
{ "id": "TUxBQlNBTjQxNzg4Mg", "name": "Santa Catalina" },
{ "id": "TUxBQlNVQzkzMDI3Ng", "name": "Suco" },
{ "id": "TUxBQlRPUzczNjQyMQ", "name": "Tosquitas" },
{ "id": "TUxBQlZJQzY2MDY1NA", "name": "Vicuña Mackenna" },
{ "id": "TUxBQlZJTDU3NTIxNQ", "name": "Villa El Chacay" },
{ "id": "TUxBQlZJTDMwNDk5OQ", "name": "Villa Santa Eugenia" },
{ "id": "TUxBQldBUzkyMDA1Mw", "name": "Washington" }
],
"geo_information": { "location": { "latitude": -33.3475232, "longitude": -64.5266446 } }
}
Estructura de respuesta esperada
El resultado esperado es una entidad Ciudad con la siguiente estructura:
| Parámetro | Tipo | Opcional | Descripción |
|---|---|---|---|
| id | string | No | Identificador único en formato cadena caracteres |
| name | string | No | Nombre de la Ciudad |
| state.id | string | No | Identificador único en formato cadena caracteres para el estado |
| state.name | string | No | Nombre del Estado |
| country.id | string | No | Identificador único de 2 o 3 caracteres |
| country.name | string | No | Nombre del País |
| geo_information.location.latitude | float | No | Latitud de la Ciudad |
| geo_information.location.longitude | float | No | Longitud de la Ciudad |
| neighborhoods | array | No | Arreglo con listado de barrios, cada una identificadas por un id y name |
Manejo de Errores
Ciudad no encontrada:
{
"message": "City not found",
"error": "not_found",
"status": 404,
"cause": []
}
Explorar información de Barrios
Tras obtener los ID de los barrios en las operaciones previas, se puede conseguir información adicional de cada uno. Esta información incluirá la geolocalización, los sub barrios o comunas que lo componen y otros detalles. Cabe aclarar que estos barrios también pueden representar comunas menores o pueblos.
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/classified_locations/neighborhoods/$NEIGHBORHOOD_ID
Parámetros:
Id del Estado: El parámetro NEIGHBORHOOD_ID permite filtrar por barrio. Admite el uso del identificador (ID) del barrio, en formato string o cadena de carácteres, como se detalla en la estructura previa.
Ejemplo de llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/classified_locations/neighborhoods/TUxBQlLNTzM2NDg2OA
Respuesta:
{
"id": "TUxBQlLNTzM2NDg2OA",
"name": "Río Cuarto",
"city": { "id": "TUxBQ1LNTzc4N2Fm", "name": "Río Cuarto" },
"state": { "id": "TUxBUENPUmFkZGIw", "name": "Córdoba" },
"country": { "id": "AR", "name": "Argentina" },
"geo_information": { "location": { "latitude": -33.123158, "longitude": -64.34934 } },
"subneighborhoods": []
}
Estructura de respuesta esperada
El resultado esperado es una entidad Barrio con la siguiente estructura:
| Parámetro | Tipo | Opcional | Descripción |
|---|---|---|---|
| id | string | No | Identificador único en formato cadena caracteres para el Barrio |
| name | string | No | Nombre del Barrio |
| city.id | string | No | Identificador único en formato cadena caracteres para la ciudad |
| city.name | string | No | Nombre de la Ciudad |
| state.id | string | No | Identificador único en formato cadena caracteres para el estado |
| state.name | string | No | Nombre del Estado |
| country.id | string | No | Identificador único de 2 o 3 caracteres |
| country.name | string | No | Nombre del País |
| geo_information.location.latitude | float | No | Latitud de la Ciudad |
| geo_information.location.longitude | float | No | Longitud de la Ciudad |
| subneighborhoods | array | No | Arreglo con listado de sub barrios, cada uno identificado por un id y name |
Manejo de Errores
Barrio no encontrado:
{
"message": "Neighborhood not found",
"error": "not_found",
"status": 404,
"cause": []
}
Busca Inmuebles por Ubicación
Una vez que hayas seleccionado la ubicación deseada para tu inmueble, podrás utilizar este recurso para buscar artículos por su ubicación geográfica. Para ello, deberás especificar un rango de latitud y longitud que delimite el área donde quieres buscar.
Recuerda que la precisión de tu búsqueda dependerá en gran medida del rango de latitud y longitud que proporciones: Un rango más amplio te mostrará más resultados, pero menos precisos, mientras que un rango más estrecho te dará resultados más relevantes para una zona específica.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$COUNTRY_ID/search?item_location=lat:$LATITUDE1_LATITUDE2,lon:$LONGITUDE1_LONGITUDE2&category=$CATEGORY_ID
Parámetros:
- Id del País: COUNTRY_ID permite filtrar por país. Formato string.
- Latitud: LATITUDE1_LATITUDE2 permite filtrar por latitud.
- Longitud: LONGITUDE1_LONGITUDE2 permite filtrar por longitud.
- Id de Categoría: CATEGORY_ID permite filtrar por categoría del inmueble.
Ejemplo de llamada:
En el siguiente ejemplo se están buscando los inmuebles de la categoría MLA1459 en Argentina, limitando este resultado, para los valores indicados de latitud y longitud.
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/search?item_location=lat:-37.987148_-30.987148,lon:-57.5483864_-50.5483864&category=MLA1459&limit=1
Respuesta:
{
"site_id": "MLA",
"country_default_time_zone": "GMT-03:00",
"paging": { "total": 66065, "primary_results": 1000, "offset": 0, "limit": 1 },
"results": [ {...} ],
"sort": { "id": "relevance", "name": "Más relevantes" },
"available_sorts": [
{ "id": "price_asc", "name": "Menor precio" },
{ "id": "price_desc", "name": "Mayor precio" }
],
"filters": [
{
"id": "category",
"name": "Categorías",
"type": "text",
"values": [
{
"id": "MLA1459",
"name": "Inmuebles",
"path_from_root": [ { "id": "MLA1459", "name": "Inmuebles" } ]
}
]
},
{
"id": "item_location",
"name": "Ubicación",
"type": "text",
"values": [
{
"id": "lat:-37.987148_-30.987148,lon:-57.5483864_-50.5483864",
"name": "Área del mapa seleccionada"
}
]
}
],
"available_filters": [ {...} ],
"currency": { "id": "ARS", "symbol": "$" },
"available_currencies": {
"currencies": [ { "id": "USD", "symbol": "US$" } ],
"conversions": { "ars_usd": 0.00093589, "usd_ars": 1068.5 }
},
"pdp_tracking": { "group": false, "product_info": [] },
"user_context": null,
"ranking_introspection": {}
}
Ocultar la dirección exacta de la propiedad.
La decisión de mostrar o no la ubicación exacta de una propiedad en un anuncio publicado recae en el gestor del inmueble. Esta medida se toma principalmente por razones de seguridad y privacidad. Sin embargo, incluso si la ubicación exacta no se revela, la publicación siempre incluirá la localización y el número de la propiedad.
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/address_line_by_reference
Parámetros:
Id del Item: El parámetro ITEM_ID permite filtrar por ítem o anuncio.
Revertir Ocultamiento
Para revertir el ocultamiento de la dirección exacta, puedes realizar un delete del tag.
curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/address_line_by_reference
Siguientes Pasos
Lecturas Recomendadas
Actualizaciones de versión
Esta sección proporciona información sobre las actualizaciones de la API, incluyendo:
Historial de cambios
| Fecha | Versión | Descripción |
|---|---|---|
| 05/11/2025 | 1.0 | Publicación Inicial |