Documentación Mercado Libre

Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
circulos azuis em degrade

Documentación

Última actualización 17/04/2023

Search for vehicles


To publish a property, vehicle or service, you must specify the city, but you can also optionally add state and neighborhood. To do this, it is best to know the classified_locations resource.


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