API version 1
GET-only. Free preview without a key; full access with your subscriber token.Every list endpoint returns { data, meta, source }. meta.filters_applied echoes back what actually matched, meta.total/limit/offset paginate (max 500 per page). Add ?format=csv to any list endpoint for a UTF-8 BOM'd, Excel ready CSV instead of JSON. Filters and pagination still apply.
Access tiers. Anonymous calls get a free preview — up to 25 rows per request within the first 200 rows of any result (tariff endpoints: 10), JSON only, 120 requests/hour. A Brief subscription unlocks full pagination; Data adds licensed CSV export; API raises rate limits for programmatic feeds. Authenticate with the token from your access link: Authorization: Bearer <token> (or x-api-key). Exports are licensed to your organisation — redistribution or resale of the database is not permitted.
| Endpoint | Filters | Search (q=) | Date range field |
|---|---|---|---|
/api/v1/projects | country, region, technology, status, verification_status, min_capacity_mw / max_capacity_mw | q (name, sponsors, offtaker) | COD → FC → PPA signed |
/api/v1/projects/{project_id} | — | — | — |
/api/v1/deals | country, region, technology, deal_type, stage, confidence, lender, min_value_usd_m / max_value_usd_m | q (project, sponsors, lenders) | announce date |
/api/v1/deals/{deal_id} | — | — | — |
/api/v1/project-finance | verification_status, confidence, source_tier, analyst_review_status, min/max capex, min/max debt | — | as-of date |
/api/v1/policies | country, technology, level, confidence, min/max budget | q (name, institution, targets) | announced date |
/api/v1/entities | type, hq_country, africa_focus | q (name, aliases) | — |
/api/v1/entities/{entity_id} | — | — | — |
/api/v1/tariffs/retail | country_iso, category, confidence | — | effective_from |
/api/v1/tariffs/benchmarks | country_iso, technology, confidence | — | date |
/api/v1/indices | — | — | month |
/api/v1/snapshot | — (Data tier: full-database ZIP, licensed) | — | — |
/api/v1/feed | country, technology, type (API tier: RSS/JSON event stream) | q | — |
Examples
# free preview — no key curl "https://africaenergyintel.com/api/v1/projects?verification_status=verified&min_capacity_mw=100" # single record — no key curl "https://africaenergyintel.com/api/v1/deals/DEAL-20240102-001" # licensed CSV export — Data tier and above curl -H "Authorization: Bearer <your-token>" \ "https://africaenergyintel.com/api/v1/deals?country=KE&technology=geothermal&format=csv" -o kenya-geothermal.csv # full-database snapshot ZIP — Data tier and above curl -H "Authorization: Bearer <your-token>" \ "https://africaenergyintel.com/api/v1/snapshot" -o aei-snapshot.zip # live watchlist feed for an RSS reader — API tier https://africaenergyintel.com/api/v1/feed?country=KE&type=deal&api_key=<your-token>