Developer documentation
Structured data access is a Professional capability.Looking for product access or pricing? View plans
API version 1
GET only. Professional authentication required for structured records.Every list endpoint returns { data, meta, source }. meta.filters_applied echoes what matched, while meta.total, limit and offset paginate results up to 500 rows per page. Supported list endpoints can return licensed CSV with ?format=csv.
Access. The public website provides deliberately limited discovery previews. It does not expose a bulk JSON API because that would allow the paid databases to be reconstructed around the product paywall. Professional ($12/month or $120/year) unlocks the structured API, licensed exports, database snapshots and Agent / MCP integration layer. Team ($29/month or $290/year) adds organisation API keys and shared workspace controls. Authenticate with Authorization: Bearer <token> or x-api-key. Exports are licensed to the customer or organisation; redistribution or resale of the database is not permitted. Current billing terms live on Pricing.
| 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 | Professional: licensed database ZIP | — | — |
/api/v1/feed | country, technology, type | q | — |
Examples
# authenticated project search — Professional curl -H "Authorization: Bearer <your-token>" \ "https://africaenergyintel.com/api/v1/projects?verification_status=verified&min_capacity_mw=100" # authenticated single deal record — Professional curl -H "Authorization: Bearer <your-token>" \ "https://africaenergyintel.com/api/v1/deals/DEAL-20240102-001" # licensed CSV export — Professional curl -H "Authorization: Bearer <your-token>" \ "https://africaenergyintel.com/api/v1/deals?country=KE&technology=geothermal&format=csv" -o kenya-geothermal.csv # licensed database snapshot — Professional curl -H "Authorization: Bearer <your-token>" \ "https://africaenergyintel.com/api/v1/snapshot" -o aei-snapshot.zip # live event feed — Professional https://africaenergyintel.com/api/v1/feed?country=KE&type=deal&api_key=<your-token>