Quickstart

Get started with the Bamwor API in 5 minutes. Register your free API key, authenticate with curl, JavaScript or Python, and query countries and cities.

Register for a free API key by sending a POST request:

Use your API key to fetch country data:

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

You can also use the Authorization: Bearer header instead of X-API-Key. Anonymous requests (no key) are limited to 100/day.

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'])

Try these endpoints next:

Troubleshooting