Access infrastructure project data programmatically. RESTful JSON endpoints for developers, researchers, and data integrators.
All API endpoints require a valid key. There are no public/unauthenticated endpoints. Pass your key in every request using one of these methods:
Keys follow the format aid_ followed by 64 hex characters. To create a key:
register for a free account,
then go to My Profile → API Keys to generate one instantly.
All keys share the same limit. Limits reset at the top of each clock hour.
Every response includes rate-limit headers so you can self-throttle:
All endpoints return JSON. Responses include standard HTTP status codes.
Retrieve infrastructure projects filtered by country name.
| Name | Type | Description |
|---|---|---|
| country | string required | Country name (e.g. "Kenya", "Nigeria") |
| limit | integer | Max results (1-100, default 50) |
Get aggregated infrastructure statistics for a specific country including project count, total investment, and sector breakdown.
| Name | Type | Description |
|---|---|---|
| country | string required | Country name |
Aggregated statistics for a region (e.g. ECOWAS, SADC, EAC).
| Name | Type | Description |
|---|---|---|
| region | string required | Region name (e.g. "ECOWAS", "SADC") |
Full-text search across all projects with optional filters.
| Name | Type | Description |
|---|---|---|
| q | string required | Search query |
| sector | string | Filter by sector |
| country | string | Filter by country |
| limit | integer | Max results (default 20) |
Use natural language to search the database. Powered by AI to understand complex queries like "transport projects in West Africa over $1B".
This endpoint requires authentication. Responses may take 2-5 seconds due to AI processing.
Get autocomplete suggestions as the user types. Returns matching project names, countries, and sectors.
| Name | Type | Description |
|---|---|---|
| q | string required | Partial search text (min 2 chars) |
Retrieve project geographic data including lat/lng coordinates, location geometry, sector, corridor, programme — ideal for GIS mapping and spatial analysis.
| Name | Type | Description |
|---|---|---|
| country | string | Filter by country name |
| sector | string | Filter by sector name (e.g. "Transport", "Energy") |
| programme | string | Filter by programme name |
| corridor | string | Filter by corridor/reference plan name |
| has_coords | string | Set to "1" to return only projects with lat/lng |
| geometry | string | Set to "1" to include full location_map geometry (can be large) |
| limit | integer | Max results (1-500, default 200) |
| offset | integer | Pagination offset (default 0) |
Use has_coords=1 when building a map to exclude projects without coordinates. Add geometry=1 only if you need the full route/polygon data (responses can be several MB).
Quick-start examples for common languages.
For API issues, feature requests, or partnership inquiries, contact us at [email protected] or visit the About page.