API RESTful Cidades do Brasil fornece dados atualizados de estados e cidades brasileiras. Permite consultar a lista completa de estados e obter as cidades de cada estado de forma simples e rápida. As respostas são retornadas em formato JSON, facilitando a integração com sites, sistemas e aplicativos que precisam de dados geográficos do Brasil. Ideal para formulários, cadastros e aplicações que exigem localização.
Faça uma chamada GET para a URL abaixo:
Requisição:
GET
Exemplo de resposta:
JSON
{
"error": false,
"api": {
"token": "{token}",
"limite": 0,
"utilizados": 0,
"restante": 0,
"gratis": 100,
"usogratis": 1
},
"estados": {
"AC": "Acre",
"AL": "Alagoas",
"AP": "Amapá",
"AM": "Amazonas",
...
},
"quantidade": 27
}
Resposta de erro:
JSON
{
"error": true,
"mensagem": "Sua conta atingiu o limite de requisições disponíveis",
"api": {
"token": "{token}",
"limite": 0,
"utilizados": 0,
"restante": 0,
"gratis": 100,
"usogratis": 100
}
}
Faça uma chamada GET para a URL abaixo:
Requisição:
GET
EXEMPLO
Resposta:
JSON
{
"error": false,
"api": {
"token": "{token}",
"limite": 0,
"utilizados": 0,
"restante": 0,
"gratis": 100,
"usogratis": 1
},
"uf": "SP",
"estado": "São Paulo",
"cidades": [
"TAQUARITUBA",
"TARABAI",
"BARRA BONITA",
"TATUI",
"TAUBATE",
"CASTILHO",
"CATANDUVA",
"CATIGUA",
...
],
"quantidade": 641
}
Resposta de erro:
JSON
{
"error": true,
"mensagem": "Sua conta atingiu o limite de requisições disponíveis",
"api": {
"token": "{token}",
"limite": 0,
"utilizados": 0,
"restante": 0,
"gratis": 100,
"usogratis": 100
}
}