C

Countries Info API

Freemium

Every country's capital, population, area, currency, calling code, languages, continent and neighbours — by code, name or currency.

No reviews yet
0.0Popularity—Service Level—Latency
Datacountry datacalling codesiso country codescurrency by country

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

MethodPathWhat it does
GET/v1/countriesAll countries (filter by continent)
GET/v1/countries/{code}One country by ISO alpha-2, alpha-3 or numeric code
GET/v1/searchFind countries by name or capital
GET/v1/currency/{currency_code}Countries that use a currency
GET/v1/countries/{code}/neighboursCountries 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"}}
HTTPCodeMeaning
400INVALID_INPUTA parameter is missing or has the wrong format — the message says which
401UNAUTHORIZEDMissing or invalid X-API-Key
404NOT_FOUNDNothing 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.

Reviews

Loading reviews…

Log in to write a review.