API REST de Países e Cidades
Dados geográficos e demográficos de 261 países e milhões de cidades. Uma API, quatro idiomas.
A Bamwor API fornece acesso programático a dados geográficos e demográficos de 261 países e milhões de cidades do mundo. Integre estatísticas de países, dados de população, valores de PIB, coordenadas de cidades e busca geoespacial em suas aplicações. Todos os dados são obtidos do CIA World Factbook, GeoNames e outras fontes oficiais. Fontes de dados · Metodologia
curl -H "X-API-Key: bw_live_your_key_here" \
https://bamwor.com/api/v1/countries/argentina
{
"data": {
"iso_code": "AR",
"names": { "en": "Argentina", "es": "Argentina", ... },
"population": 46621847,
"area_sq_km": 2780400,
"stats": { "gdp_nominal": { "value": 641102, ... }, ... }
}
}Por que Bamwor API?
Diferente das APIs de países básicas, Bamwor oferece a mais completa api de paises e cidades do mundo disponível através de uma única API REST. Seja para estatísticas básicas, dados de cidades, ou perfis detalhados com conteúdo narrativo — Bamwor tem tudo:
- ✓261 países e territórios — mais do que qualquer outra API de países gratuita
- ✓13.4 milhões de cidades — com coordenadas, população, fuso horário e elevação
- ✓25+ estatísticas por país — incluindo PIB, população, área, IDH, expectativa de vida, alfabetização e 9 índices proprietários
- ✓9 índices analíticos próprios — (IBEE, IBFM, IBDI, IBED, IBSA, IBEU, IBCP, IBDA, IBCX) — exclusivos do Bamwor
- ✓Comparações de países — compare qualquer par de países lado a lado em todas as métricas
- ✓Rankings — países classificados por qualquer métrica
- ✓Multilíngue — suporte completo para inglês, espanhol, italiano e português
- ✓Servidor MCP — conecte agentes de IA (Claude, Cursor, Windsurf) diretamente a dados do mundo
- ✓Perfis de países com conteúdo narrativo — governo, economia, demografia, forças armadas, infraestrutura para cada país. Plano Premium. Teste grátis com Colômbia, Itália, Austrália
Bamwor é a evolução natural de fontes de dados de países tradicionais como o CIA World Factbook e RestCountries. Uma API para tudo.
Compare Bamwor: Bamwor vs RestCountries | Bamwor vs GeoNames
Comece em 30 Segundos
1. Obtenha sua API key grátis em bamwor.com/developers/quickstart. 2. Faça sua primeira requisição:
// Get country data
const response = await fetch(
'https://bamwor.com/api/v1/countries/japan',
{ headers: { 'X-API-Key': 'your_api_key' } }
);
const japan = await response.json();
console.log(japan.name, japan.population);import requests
headers = {"X-API-Key": "your_api_key"}
response = requests.get(
"https://bamwor.com/api/v1/countries/japan",
headers=headers
)
japan = response.json()
print(japan["name"], japan["population"])O que você pode construir
Perfis de Países
População, PIB, área, IDH, expectativa de vida e mais de 20 estatísticas para cada país e território.
Base de Cidades
Milhões de cidades com coordenadas, população, elevação, fuso horário e lugares próximos via PostGIS.
Rankings
Países classificados por população, área, PIB, densidade, IDH e mais. Filtro por região.
Busca
Busca de texto completo em países e cidades em 4 idiomas com relevância baseada em população.
Multilíngue
Todos os nomes e slugs em inglês, espanhol, português e italiano. i18n integrado.
Lugares Próximos
Encontre cidades dentro de um raio usando consultas geoespaciais PostGIS. Distância em quilômetros.
Endpoints da API
| Method | Endpoint | Descrição |
|---|---|---|
| GET | /api/v1/countries | Listar todos os países (paginado) |
| GET | /api/v1/countries/:slug | Detalhe do país com estatísticas |
| GET | /api/v1/countries/:slug/cities | Cidades de um país (paginado) |
| GET | /api/v1/cities/:id | Detalhe da cidade por ID |
| GET | /api/v1/cities/:id/nearby | Cidades próximas (busca por raio) |
| GET | /api/v1/search?q=... | Buscar países e cidades |
| GET | /api/v1/rankings | Métricas de ranking disponíveis |
| GET | /api/v1/rankings/:slug | Ranking de países por métrica |