Economy

Economy In Africa API

Economic data is exposed through the shared indicator and data endpoints.

Use:

• GET /v1/indicators?category=economy
• GET /v1/data?category=economy
• GET /v1/countries/{country_code}/signals
• GET /v1/indicators/{metric_key}/rankings

Useful Metrics

• gdp_current_usd
• gdp_per_capita_usd
• inflation_cpi_pct
• inflation_cpi_latest_yoy_pct
• policy_rate_pct
• treasury_bill_91d_rate_pct
• overnight_interbank_rate_pct
• official_exchange_rate_latest_lcu_per_usd
• petrol_price_local_per_liter
• diesel_price_local_per_liter
• kerosene_price_local_per_liter
• maize_retail_price_local_per_kg
• maize_wholesale_price_local_per_kg
• foreign_reserves_import_cover_latest_months
• unemployment_pct
• unemployment_rate_latest_pct
• youth_unemployment_pct
• merchandise_exports_latest_usd_mn
• merchandise_imports_latest_usd_mn
• trade_balance_usd
• current_account_balance_pct_gdp

Use the *_latest_* metrics for the latest available releases. Check frequency and as_of_period to distinguish their reporting periods from the annual series.

Selected official central-bank releases appear in the country signals response where available.

The commodity_benchmarks block returned by /v1/countries/{country_code}/signals contains global reference prices.

Local prices in /signals include location and source details. Kenya fuel prices use location_name: Nairobi. South Africa fuel prices use the official DMRE Gauteng reference zone and carry fuel-grade and scope details in context.

Kenya maize prices use the World Bank Kenya market feed with location_name: Market Average. Retain these labels when displaying or comparing prices.

Example Query

curl "https://api.africa-api.com/v1/data?country_codes=ng,ke,za&metric_key=gdp_current_usd&year=2024" \
  -H "Authorization: Bearer $AFRICA_API_KEY"

curl "https://api.africa-api.com/v1/countries/ke/signals" \
  -H "Authorization: Bearer $AFRICA_API_KEY"