Use Cases
African Countries API
Choose Africa API endpoints for country lists, reference records, profiles, and country signals.
Use country endpoints to build a selector, fetch reference fields, or request a summary for one country. Choose the response your page needs:
| Task | Endpoint |
|---|---|
| List or filter countries | /v1/countries |
| Fetch a country's reference record | /v1/countries/{country_code} |
| Request a country profile | /v1/countries/{country_code}/profile |
| Inspect available country signals | /v1/countries/{country_code}/signals |
Country routes require an API key. Start with Quickstart if you have not set up authentication.
Example: List Countries In A Region
curl "https://api.africa-api.com/v1/countries" \
-G \
-d "region=west" \
-d "sort=name" \
-d "paginate=true" \
-d "per_page=10" \
-H "Authorization: Bearer $AFRICA_API_KEY"region=west filters the list to West Africa; pagination limits this response to ten records.
Example: Get A Country Profile
curl "https://api.africa-api.com/v1/countries/ke/profile" \
-H "Authorization: Bearer $AFRICA_API_KEY"The profile groups country information in one response. See Countries for its fields.
Example: Get Current Country Signals
curl "https://api.africa-api.com/v1/countries/ke/signals" \
-H "Authorization: Bearer $AFRICA_API_KEY"Signals group available observations from several topics. Fields and observation dates vary by country and source; check Coverage before building around a particular signal.
For a particular metric or a time series, use /v1/data with an explicit metric key and country filter.
African Countries API FAQ
How do I get a list of all African countries via API?
GET /v1/countries returns all 54 African countries as consistent reference records with ISO codes, capital, region, currencies, and languages. Use /v1/countries/{country_code} for the full detail object and /profile for a curated summary with indicator highlights.
Is there a free API for African country data?
The Free plan includes country records, profiles and signals within its request limits. Create a key in the dashboard; see Rate limits for quotas.
Can I get current data for one country in a single request?
GET /v1/countries/{country_code}/signals groups the available observations for that country. It can include macro indicators, FX, markets, trade, government, climate and disaster alerts. Check the observation dates and missing fields; sources do not all update at the same time.
Related Docs
Countries reference
Full reference for country list, detail, profile, and signals routes.
Signals reference
Country signal fields, dates and source information.
Geographies
Geography hierarchy records when you need regions and parent-child relationships.
Data API
Query explicit metrics and time series when country profiles are not enough.