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 15/03/2023

Localiza vehículos


Para publicar un inmueble, vehículo o servicio, deberás determinar de forma obligatoria la ciudad aunque también le podrás añadir de forma opcional estado y también barrio. Para hacerlo, lo mejor es familiarizarte con el recurso classified_locations.


Al publicar un artículo, solo debes enviar el ID de ubicación de la hoja. Es decir, enviar solo el ID del Barrio es suficiente para que nuestra API complete con los ID de Estado y Ciudad correspondientes. Si la ciudad elegida no tiene ningún barrio, entonces solo deberás enviar el ID de la Ciudad. Es obligatorio enviar el ID del barrio o el ID de la Ciudad. Si envías solo el ID del Estado, nuestra API no te permitirá publicar(de todos modos, nunca debes enviar el ID del Estado porque se completará automáticamente según el ID del Barrio o el ID de la Ciudad ingresados). Este recurso te permitirá explorar las posibles ubicaciones por país, estado, ciudad y barrio.



Explorar todos los países

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/classified_locations/countries
Respuesta:

[
  {
  "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"
  }
]

Explorar información del país

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/classified_locations/countries/{Country_Id}
Ejemplo:

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",
  "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"
  }
  ]
}

Explorar información de estados

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/classified_locations/states/{State_id}
Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/classified_locations/states/TUxBUENBUGw3M2E1
Respuesta:

{
  "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"
    }
  ]
}

Explorar información de la ciudad

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/classified_locations/cities/{City_id}
Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/classified_locations/cities/TUxBQ0NBUGZlZG1sYQ
Respuesta:

{
  "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": "TUxBQlZJTDI1ODla",
    "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"
  }
  ]
}

Explorar información de barrios

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/classified_locations/neighborhoods/{Neighborhood_Id}
Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/classified_locations/neighborhoods/TUxBQkNBQjM4MDda
Respuesta:

{
  "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": [
  ]
}

Siguiente: Gestiona paquetes.