Inicio Rápido

Empezá con la Bamwor API en 5 minutos. Registrá tu API key gratis, autenticá con curl, JavaScript o Python, y consultá países y ciudades.

1

Obtené tu API key

Registrate para una API key gratis enviando un pedido POST:

Registrá tu API key gratis

Te enviaremos un código de verificación a tu email.

Ya tenés una key? Recuperala

2

Hacé tu primer pedido

Usá tu API key para obtener datos de un país:

curl -H "X-API-Key: bw_live_your_key" \
  https://bamwor.com/api/v1/countries/japan

También podés usar el header Authorization: Bearer en vez de X-API-Key. Los pedidos anónimos (sin key) están limitados a 100/día.

JavaScript / Node.js

const res = await fetch('https://bamwor.com/api/v1/countries/japan', {
  headers: { 'X-API-Key': 'bw_live_your_key' }
});
const { data } = await res.json();
console.log(data.names.en, data.stats.population);

Python

import requests

r = requests.get(
    'https://bamwor.com/api/v1/countries/japan',
    headers={'X-API-Key': 'bw_live_your_key'}
)
data = r.json()['data']
print(data['names']['en'], data['stats']['population'])
3

Explorá la API

Probá estos endpoints:

🌍
/api/v1/countries?sort=population

Países ordenados por población

🏙️
/api/v1/countries/brazil/cities?sort=population

Ciudades de Brasil por población

🔍
/api/v1/search?q=tokyo&type=city

Buscar ciudades llamadas Tokyo

📊
/api/v1/rankings/population

Ranking mundial de población

📍
/api/v1/cities/3435910/nearby?radius=100

Ciudades cerca de Buenos Aires

Solución de problemas

Recibo 401 INVALID_API_KEY

Asegurate de enviar la key en el header X-API-Key o como Authorization: Bearer. Las keys empiezan con bw_live_. Si te acabás de registrar, esperá unos segundos e intentá de nuevo.

Recibo 429 RATE_LIMIT_EXCEEDED

Superaste el límite de tu plan. El plan gratis permite 30 pedidos/min y 1.000/día. Revisá X-RateLimit-Remaining en los headers de respuesta. Pasate a Pro para más capacidad.

La respuesta es lenta

Los primeros pedidos a un endpoint pueden ser más lentos mientras la caché se llena. Las siguientes llamadas usan caché y responden en menos de 50ms. Si persiste, verificá la latencia de tu red a bamwor.com.

¿Cómo busco en español o portugués?

El endpoint /search busca automáticamente en los 4 idiomas. Buscá en tu idioma preferido: /api/v1/search?q=Alemania encontrará Germany.