Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade
Última atualização em 21/07/2025

Localização de veículos

Ao publicar um imóvel, veículo ou serviço, é necessário identificar a localização. Deve-se estabelecer o ID da cidade e, opcionalmente, estado e bairro. Para este propósito, utilize o recurso classified_locations.

Parametrização de localização

Na solicitação de publicação, envie apenas o ID correspondente ao bairro ou cidade.

  • Se você enviar o ID do bairro, a API completa automaticamente o estado e a cidade relacionados.
  • Se a cidade não tiver bairros, envie o ID da cidade.
  • Não envie diretamente o ID do estado (se fizer isso, a API rejeita a publicação), pois esse dado é determinado a partir do bairro ou cidade.


Explorar todos os países

Consulte a lista completa dos países habilitados. Chamada:

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

Resposta:

 [
  {
    "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 informações do país

Consulte detalhes de um país específico, como nome, moedas e estados (províncias ou regiões). Chamada:

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

Resposta:

{
    "id": "AR",
    "name": "Argentina",
    "locale": "es_AR",
    "site": "MLA",
    "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"
        }
    ]
}

Explorar informações do estado

Visualize dados de um estado e suas cidades associadas.

Chamada:

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

Exemplo:

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

Resposta:

{
    "id": "TUxBUENBUGw3M2E1",
    "name": "Capital Federal",
    "country": {
        "id": "AR",
        "name": "Argentina"
    },
    "site": "MLA",
    "geo_information": {
        "location": {
            "latitude": -34.6143048,
            "longitude": -58.4401655
        }
    },
    "time_zone": "GMT-03:00",
    "time_zone_name": "America/Buenos_Aires",
    "cities": [
        {
            "id": "TUxBQ0NBUGZlZG1sYQ",
            "name": "Capital Federal"
        }
    ]
}

Explorar informações sobre uma cidade

Veja detalhes sobre uma cidade, seus bairros e dados geográficos.

Chamada:

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

Exemplo:

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

Resposta:

{
    "id": "TUxBQ0NBUGZlZG1sYQ",
    "name": "Capital Federal",
    "site": "MLA",
    "state": {
        "id": "TUxBUENBUGw3M2E1",
        "name": "Capital Federal"
    },
    "country": {
        "id": "AR",
        "name": "Argentina"
    },
    "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": "TVhYUGFycXVlIENlbnRlbmFyaW9UVXhCUTBOQ",
            "name": "Parque Centenario"
        },
        {
            "id": "TUxBQlBBUjUyOTZa",
            "name": "Parque Chacabuco"
        },
        {
            "id": "TVhYUGFycXVlIENoYXNUVXhCUTBOQlVHWmxaR",
            "name": "Parque Chas"
        },
        {
            "id": "TUxBQlBBUjYwMzZa",
            "name": "Parque Patricios"
        },
        {
            "id": "TUxBQlBBVDI0ODFa",
            "name": "Paternal"
        },
        {
            "id": "TUxBQlBVRTQ5NjBa",
            "name": "Puerto Madero"
        },
        {
            "id": "TVhYUHVlcnRvIFJldGlyb1RVeEJRME5CVUdab",
            "name": "Puerto Retiro"
        },
        {
            "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": "Versalles"
        },
        {
            "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"
        }
    ],
    "geo_information": {
        "location": {
            "latitude": -34.6084175,
            "longitude": -58.3731613
        }
    }
}

Explorar informações do bairro

Veja os detalhes de um bairro específico. Inclui país, estado, cidade e coordenadas.

Chamada:

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

Exemplo:

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

Resposta:

{
    "id": "TUxBQkNBQjM4MDda",
    "name": "Caballito",
    "site": "MLA",
    "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": []
}

Seguinte: Gerenciamento pacotes.