Countries Info API
FreemiumEvery country's capital, population, area, currency, calling code, languages, continent and neighbours — by code, name or currency.
Documentation
Every country's capital, population, area, currency, calling code, languages, continent and neighbours.
What you get
- All 252 countries and territories with ISO 2- and 3-letter codes
- Capital, population, area, continent, currency, calling code, languages, internet TLD and postal-code format
- Look up by code, search by name, find all countries using a currency, list land neighbours
Great for checkout and address forms, phone inputs, travel apps, dashboards and data enrichment.
Quick start
Subscribe to a plan (the Basic plan is free), then call the API at https://countries-info.p.apihiver.com with your key in the X-API-Key header:
curl "https://countries-info.p.apihiver.com/v1/countries?continent=AS" \
-H "X-API-Key: YOUR_API_KEY"Endpoints
| Method | Path | What it does |
|---|---|---|
GET | /v1/countries | All countries (filter by continent) |
GET | /v1/countries/{code} | One country by ISO alpha-2, alpha-3 or numeric code |
GET | /v1/search | Find countries by name or capital |
GET | /v1/currency/{currency_code} | Countries that use a currency |
GET | /v1/countries/{code}/neighbours | Countries sharing a land border |
Open the Endpoints tab to see every parameter, example request and example response, and to try the API live.
Errors
Every error is JSON with the same shape:
{"error": {"code": "INVALID_INPUT", "message": "q: Field required"}}| HTTP | Code | Meaning |
|---|---|---|
| 400 | INVALID_INPUT | A parameter is missing or has the wrong format — the message says which |
| 401 | UNAUTHORIZED | Missing or invalid X-API-Key |
| 404 | NOT_FOUND | Nothing matched the code, id or name you sent |
| 429 | — | Plan quota or rate limit reached (see the X-RateLimit-* headers) |
| 502 / 503 / 504 | — | A data source or the API server is temporarily unavailable — retry after a few seconds |
Data & privacy
Data comes from GeoNames country data (CC BY 4.0), refreshed automatically.
Countries Info API FAQ
- Is the Countries Info API free?
- Yes. The Basic plan is free and includes 500 requests per month — no card needed. Paid plans start at ₹299 per month for 10,000 requests.
- How much does the Countries Info API cost?
- Basic: free for 500 requests; Pro: ₹299/month for 10,000 requests; Ultra: ₹999/month for 50,000 requests; Mega: ₹2,499/month for 2,00,000 requests. Billing is monthly and you can cancel any time.
- How do I use the Countries Info API?
- Subscribe to a plan on APIHiver, create an API key in the Console, then send requests to https://countries-info.p.apihiver.com with your key in the X-API-Key header. You can also try every endpoint in the browser playground first.
- What endpoints does the Countries Info API have?
- It has 5 endpoints: All countries (filter by continent) (GET /v1/countries); One country by ISO alpha-2, alpha-3 or numeric code (GET /v1/countries/{code}); Find countries by name or capital (GET /v1/search); Countries that use a currency (GET /v1/currency/{currency_code}); Countries sharing a land border (GET /v1/countries/{code}/neighbours).
- What are the Countries Info API rate limits?
- Basic: 2 requests per second; Pro: 5 requests per second; Ultra: 10 requests per second; Mega: 20 requests per second. Monthly quotas depend on the plan; every response includes X-RateLimit headers showing what's left.
- Can I use one API key for the Countries Info API and other APIs?
- Yes. One APIHiver key works for every API you subscribe to, so you don't need a separate account or key per provider.
Related APIs
Data Tools API
DataBy APIHiver · Updated 1w ago
Convert CSV ⇄ JSON, generate realistic fake test data (including Indian names and addresses), and create UUIDs in bulk.
Universities API
EducationBy APIHiver · Updated 1w ago
Search universities in 200+ countries, look up a university by web domain, and verify student email addresses.
Public Holidays API
TravelBy APIHiver · Updated 1w ago
Public holidays for 150+ countries — including Indian states — plus 'is it a holiday?', upcoming holidays and working-day counts.
English Dictionary API
EducationBy APIHiver · Updated 1w ago
English definitions, synonyms, antonyms, rhymes, 'words that mean…' and autocomplete — fast and fully offline.
Wikipedia Search API
SearchBy APIHiver · Updated 1w ago
Search Wikipedia in 300+ languages, get article summaries with images, 'on this day' events, random articles and autocomplete.
Tech News API
NewsBy APIHiver · Updated 1w ago
Top, new and best tech stories from Hacker News, full-text news search, story details with comments, and Ask/Show HN.
Endpoints
5 endpoints — full list is in the sidebar on larger screens.