Data API · v1 · stable

A REST API for African statistics.

A versioned REST surface with consistent response schemas and source metadata. Use African economic and demographic data in dashboards, models, or RAG pipelines.

Try free - no card Full endpoint reference

10,000 free API calls / day · OpenAPI spec · source-aware JSON

Base URL https://api.africadb.com

curl -H "Authorization: Bearer $ADB_TOKEN" \
  "https://api.africadb.com/api/v1/observations/latest/NY.GDP.PCAP.CD/KE"

Response

# Click "Try it" to run this request through the signed browser session.
# Direct API clients must send a user access token or API key.

The browser can obtain a restricted read-only session. Direct API clients must authenticate.

Every observation response cited

Responses carry publisher, period, retrieval, and pipeline provenance. Managed-ingestion records add an immutable run ID and transform hash.

Built on the publishers you trust

World Bank, IMF, WHO, AfDB, UNESCO, DHS Program, central banks - same data, one consistent schema.

Generous free tier

10,000 API calls per day on the Researcher plan. Higher limits and bulk endpoints unlock on Analyst+.

Quick start

Three steps and you've got Kenya's GDP series. Set ADB_TOKEN to a user access token or API key for direct requests.

1
Pick an indicator
Browse the indicators page or call /api/v1/indicators.

Make the request

curl -H "Authorization: Bearer $ADB_TOKEN" \
  "https://api.africadb.com/api/v1/observations/timeseries/NY.GDP.MKTP.CD/KE?start_year=2010"

Read the response

All endpoints return JSON. Time-series payloads look like this:

{
  "indicator_id": "NY.GDP.MKTP.CD",
  "country_code": "KE",
  "data": [
    { "year": 2020, "value": 100380000000, "unit": "USD" },
    { "year": 2021, "value": 110350000000, "unit": "USD" },
    { "year": 2022, "value": 113420000000, "unit": "USD" }
  ],
  "attribution": {
    "source": "World Bank",
    "license": "CC BY 4.0",
    "url": "https://africadb.com"
  }
}

Authentication

Direct API requests require a bearer token. Sign in and create an API key from your dashboard. The web application uses a separate, origin-bound read-only browser session.

Authorization: Bearer adb_pro_k3y_xxxxx

Keys are scoped to your account; revoke them at any time from the dashboard.

Endpoint reference

Click any row to expand, view code samples, and run a live request.

Core Data

Indicators, countries, observations, and time series.

Analytics & Risk

Computed rankings, scorecards, sovereign risk grades.

Trade Blocs

Aggregates across EAC, ECOWAS, SADC, COMESA, IGAD, AU.

Reports & Search

Pre-built intelligence reports and natural-language search.

Exports & Bulk

Download data as CSV / JSON / XLSX. Analyst plan required for bulk endpoints.

Live & News

Latest available forex, commodities, ticker, news, and sentiment feeds.

Rate limits

Free

10k / day

Bulk export: -

Pro

50k / day

Bulk export: ✓

Team

200k / day

Bulk export: ✓

Enterprise

Unlimited

Bulk export: ✓ + SLA