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:

TaskEndpoint
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.

On this page