Search for vehicles

When you publish an article, you should only send the location ID of the page. That is, sending only the Neighborhood ID is enough for our API to complete with the corresponding State and City IDs. If the chosen city does not have any neighborhood, then you only need to submit the City ID. It is mandatory to send either the Neighborhood ID or the City ID. If you submit only the State ID, our API will not allow you to publish (however, you should never submit the State ID because it will be automatically completed according to the Neighborhood ID or City ID submitted). This resource will allow you to browse possible locations by country, state, city and neighborhood.

Search all countries

Example:

curl -X GET https://api.mercadolibre.com/classified_locations/countries

Response:

 [
  {
    "id": "AR",
    "name": "Argentina",
    "locale": "es_AR",
    "currency_id": "ARS"
  },
  {
    "id": "BR",
    "name": "Brasil",
    "locale": "pt_BR",
    "currency_id": "BRL"
  },
  {
    "id": "CO",
    "name": "Colombia",
    "locale": "es_CO",
    "currency_id": "COP"
  },
  {
    "id": "CR",
    "name": "Costa Rica",
    "locale": "es_CR",
    "currency_id": "CRC"
  },
  {
    "id": "CL",
    "name": "Chile",
    "locale": "es_CL",
    "currency_id": "CLP"
  },
  {
    "id": "EC",
    "name": "Ecuador",
    "locale": "es_EC",
    "currency_id": "USD"
  },
  {
    "id": "MX",
    "name": "Mexico",
    "locale": "es_MX",
    "currency_id": "MXN"
  },
  {
    "id": "PA",
    "name": "Panamá",
    "locale": "es_PA",
    "currency_id": "USD"
  },
  {
    "id": "PE",
    "name": "Peru",
    "locale": "es_PE",
    "currency_id": "PEN"
  },
    {
    "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": "VEF"
  }
]

Country information

Request::

curl -X GET https://api.mercadolibre.com/classified_locations/countries/$COUNTRY_ID

Example:

curl -X GET https://api.mercadolibre.com/classified_locations/countries/AR

Response:

{
  "id": "AR",
  "name": "Argentina",
  "locale": "es_AR",
  "currency_id": "ARS",
  "decimal_separator": ",",
  "thousands_separator": ".",
  "time_zone": "GMT-03:00",
  "geo_information": {
    "location": {
      "latitude": -38.416097,
      "longitude": -63.616672
    }
  },
  "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": "TUxBUFpPTmFpbnRl",
      "name": "Buenos Aires Interior"
    },
    {
      "id": "TUxBUENBUGw3M2E1",
      "name": "Capital Federal"
    },
    {
      "id": "TUxBUENBVGFiY2Fm",
      "name": "Catamarca"
    },
    {
      "id": "TUxBUENIQW8xMTNhOA",
      "name": "Chaco"
    },
    {
      "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": "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"
    }
  ]
}

State information

Request:

curl -X GET https://api.mercadolibre.com/classified_locations/states/$STATE_ID

Example:

curl -X GET https://api.mercadolibre.com/classified_locations/states/TUxBUENBUGw3M2E1

Response:

{
  "id": "TUxBUENBUGw3M2E1",
  "name": "Capital Federal",
  "country": {
    "id": "AR",
    "name": "Argentina"
  },
  "geo_information": {
    "location": {
      "latitude": -34.6143048,
      "longitude": -58.4401655
    }
  },
  "cities": [
    {
      "id": "TUxBQ0NBUGZlZG1sYQ",
      "name": "Capital Federal"
    }
  ]
}

City information

Request:

curl -X GET https://api.mercadolibre.com/classified_locations/cities/$CITY_ID

Example:

curl -X GET https://api.mercadolibre.com/classified_locations/cities/TUxBQ0NBUGZlZG1sYQ

Response:

{
  "id": "TUxBQ0NBUGZlZG1sYQ",
  "name": "Capital Federal",
  "state": {
    "id": "TUxBUENBUGw3M2E1",
    "name": "Capital Federal"
  },
  "country": {
    "id": "AR",
    "name": "Argentina"
  },
  "geo_information": {
    "location": {
      "latitude": -34.6084175,
      "longitude": -58.3731613
    }
  },
  "neighborhoods": [
    {
      "id": "TUxBQkFHUjk3NjJa",
      "name": "Agronomía"
    },
    {
      "id": "TUxBQkFMTTMwNTBa",
      "name": "Almagro"
    },
    {
      "id": "TUxBQkJBTDMxMDZa",
      "name": "Balvanera"
    },
    {
      "id": "TUxBQkJBUjM0MDha",
      "name": "Barracas"
    },
    {
      "id": "TUxBQkJBUjQwMDQ3MA",
      "name": "Barrio Norte"
    },
    {
      "id": "TUxBQkJFTDcyNTJa",
      "name": "Belgrano"
    },
    {
      "id": "TUxBQkJFTDkwNjNa",
      "name": "Belgrano Barrancas"
    },
    {
      "id": "TUxBQkJFTDk4MDRa",
      "name": "Belgrano C"
    },
    {
      "id": "TUxBQkJFTDU0ODda",
      "name": "Belgrano Chico"
    },
    {
      "id": "TUxBQkJFTDU5NzNa",
      "name": "Belgrano R"
    },
    {
      "id": "TUxBQkJPRTQ0OTRa",
      "name": "Boedo"
    },
    {
      "id": "TUxBQkJPVDQ2NTFa",
      "name": "Botánico"
    },
    {
      "id": "TUxBQkNBQjM4MDda",
      "name": "Caballito"
    },
    {
      "id": "TUxBQkNIQTM5NjBa",
      "name": "Chacarita"
    },
    {
      "id": "TUxBQkNPRzY5MTZa",
      "name": "Coghlan"
    },
    {
      "id": "TUxBQkNPTDI3NDNa",
      "name": "Colegiales"
    },
    {
      "id": "TUxBQkNPTjgyODY1Mg",
      "name": "Congreso"
    },
    {
      "id": "TUxBQkNPTjExMDBa",
      "name": "Constitución"
    },
    {
      "id": "TUxBQkZMTzMwNzRa",
      "name": "Flores"
    },
    {
      "id": "TUxBQkZMTzg5MjFa",
      "name": "Floresta"
    },
    {
      "id": "TUxBQkxBQjk1ODJa",
      "name": "La Boca"
    },
    {
      "id": "TUxBQkxBUzIxNTJa",
      "name": "Las Cañitas"
    },
    {
      "id": "TUxBQkxJTjEzNTha",
      "name": "Liniers"
    },
    {
      "id": "TUxBQk1BVDMwMDJa",
      "name": "Mataderos"
    },
    {
      "id": "TUxBQk1PTjUxOTJa",
      "name": "Monserrat"
    },
    {
      "id": "TUxBQk1PTjE2OTBa",
      "name": "Monte Castro"
    },
    {
      "id": "TUxBQk5VRTc3MTZa",
      "name": "Nueva Pompeya"
    },
    {
      "id": "TUxBQk7a0TcwOTRa",
      "name": "Núñez"
    },
    {
      "id": "TUxBQk9OQzM1Mjk5Ng",
      "name": "Once"
    },
    {
      "id": "TUxBQlBBTDI1MTVa",
      "name": "Palermo"
    },
    {
      "id": "TUxBQlBBTDg3OTha",
      "name": "Palermo Chico"
    },
    {
      "id": "TUxBQlBBTDg1NjJa",
      "name": "Palermo Hollywood"
    },
    {
      "id": "TUxBQlBBTDgwMjla",
      "name": "Palermo Nuevo"
    },
    {
      "id": "TUxBQlBBTDg3MDda",
      "name": "Palermo Soho"
    },
    {
      "id": "TUxBQlBBTDE5ODla",
      "name": "Palermo Viejo"
    },
    {
      "id": "TUxBQlBBUjQ1NDda",
      "name": "Parque Avellaneda"
    },
    {
      "id": "TUxBQlBBUjUyOTZa",
      "name": "Parque Chacabuco"
    },
    {
      "id": "TUxBQlBBUjYwMzZa",
      "name": "Parque Patricios"
    },
    {
      "id": "TUxBQlBBVDI0ODFa",
      "name": "Paternal"
    },
    {
      "id": "TUxBQlBVRTQ5NjBa",
      "name": "Puerto Madero"
    },
    {
      "id": "TUxBQlJFQzkyMTVa",
      "name": "Recoleta"
    },
    {
      "id": "TUxBQlJFVDgyMDVa",
      "name": "Retiro"
    },
    {
      "id": "TUxBQlNBQTM3Mzda",
      "name": "Saavedra"
    },
    {
      "id": "TUxBQlNBTjkwNTZa",
      "name": "San Cristóbal"
    },
    {
      "id": "TUxBQlNBTjgzMjRa",
      "name": "San Nicolás"
    },
    {
      "id": "TUxBQlNBTjgxMzNa",
      "name": "San Telmo"
    },
    {
      "id": "TUxBQlNBTjEyMjNa",
      "name": "Santa Rita"
    },
    {
      "id": "TUxBQlZFTDIwNDha",
      "name": "Velez Sarsfield"
    },
    {
      "id": "TUxBQlZFUjY3MDFa",
      "name": "Versailles"
    },
    {
      "id": "TUxBQlZJTDQyMjBa",
      "name": "Villa Crespo"
    },
    {
      "id": "TUxBQlZJTDYzNzZa",
      "name": "Villa Devoto"
    },
    {
      "id": "MLA1071",
    "name": "Villa Gral. Mitre"
    },
    {
      "id": "TUxBQlZJTDQ4MzBa",
      "name": "Villa Lugano"
    },
    {
      "id": "TUxBQlZJTDI3MDJa",
      "name": "Villa Luro"
    },
    {
      "id": "TUxBQlZJTDQyMjFa",
      "name": "Villa Ortúzar"
    },
    {
      "id": "TUxBQlZJTDE2MDBa",
      "name": "Villa Pueyrredón"
    },
    {
      "id": "TUxBQlZJTDM3Mzda",
      "name": "Villa Real"
    },
    {
      "id": "TUxBQlZJTDU5MTFa",
      "name": "Villa Riachuelo"
    },
    {
      "id": "TUxBQlZJTDM5MjZa",
      "name": "Villa Soldati"
    },
    {
      "id": "TUxBQlZJTDcwOTla",
      "name": "Villa Urquiza"
    },
    {
      "id": "TUxBQlZJTDc4MDda",
      "name": "Villa del Parque"
    }
  ]
}

Neighborhood information

Request:

curl -X GET https://api.mercadolibre.com/classified_locations/neighborhoods/$NEIGHBORHOOD_ID

Example:

 curl -X GET https://api.mercadolibre.com/classified_locations/neighborhoods/TUxBQkNBQjM4MDda

Response:

 {
  "id": "TUxBQkNBQjM4MDda",
  "name": "Caballito",
  "city": {
    "id": "TUxBQ0NBUGZlZG1sYQ",
    "name": "Capital Federal"
  },
  "state": {
    "id": "TUxBUENBUGw3M2E1",
    "name": "Capital Federal"
  },
  "country": {
    "id": "AR",
    "name": "Argentina"
  },
  "geo_information": {
    "location": {
      "latitude": -34.6166667,
      "longitude": -58.45
    }
  },
  "subneighborhoods": [
  ]
}

Next: Manage packages..