afdb.org APIafdb.org ↗
Access AfDB country profiles, projects, procurement notices, publications, and news via 8 structured endpoints. Filter by country, sector, region, and more.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/b9082722-a1d3-4f99-ad94-d83bb52f33bf/get_countries_list' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns a list of all African Development Bank member countries, organized by region. Each country includes its name, slug, region_slug, and URL.
No input parameters required.
{
"type": "object",
"fields": {
"regions": "object mapping region names (e.g. 'North Africa', 'West Africa', 'East Africa', 'Central Africa', 'Southern Africa', 'Non-Regional') to arrays of country objects with name, slug, region_slug, and url"
},
"sample": {
"data": {
"regions": {
"West Africa": [
{
"url": "https://www.afdb.org/en/countries/west-africa/nigeria",
"name": "Nigeria",
"slug": "nigeria",
"region_slug": "west-africa"
}
],
"North Africa": [
{
"url": "https://www.afdb.org/en/countries/north-africa/algeria",
"name": "Algeria",
"slug": "algeria",
"region_slug": "north-africa"
}
]
}
},
"status": "success"
}
}About the afdb.org API
The AfDB API provides structured access to African Development Bank data across 8 endpoints, covering member country profiles, MapAfrica project records, procurement notices, publications, and news. The list_projects endpoint returns project-level financial data including total commitments and disbursements, filterable by country code, sector, region, and status. The get_country_overview endpoint returns economic outlook, key facts, and portfolio details for individual AfDB member countries.
Country and Project Data
The get_countries_list endpoint returns all AfDB member countries organized by region, with each record including a name, slug, region_slug, and url. These slugs feed directly into get_country_overview, which accepts a country_slug (required) and optional region_slug and returns fields including economic_outlook, strategy, key_facts, and portfolio. For project-level data, list_projects queries the MapAfrica database and returns an array of project objects with fields like iati_identifier, activity_status, total_commitments, and total_disbursements. The filterable field in that response lists valid values for country, sector, theme, status, region, year, and ADF cycle.
Project Details and Procurement
get_project_detail accepts a project identifier in AfDB format (e.g. P-Z1-DD0-015) or the full IATI identifier with a 46002- prefix, and returns a full record including afdb_identifier_ref, total_disbursements, and activity_status. list_procurement_notices returns paginated tender notices with title, url, date, and country, and accepts a keyword query parameter for filtering by subject or geography. Pagination for procurement, publications, and news uses a 0-based page parameter.
Publications, News, and Search
list_publications returns AfDB publication records with title, url, and date, searchable by keyword via the query parameter. list_news returns paginated news articles with title, url, date, and a summary field. The search_site endpoint performs a global search across the AfDB website and returns title, url, snippet, date, and type fields for each result, along with a total_info string indicating the total result count.
- Track active AfDB projects in a specific country using
list_projectsfiltered bycountry_codeandactivity_status. - Monitor procurement tender opportunities in the energy or water sector using
list_procurement_noticeswith a keywordquery. - Build a country-level economic dashboard using
get_country_overviewfields:economic_outlook,key_facts, andportfolio. - Aggregate AfDB publications on a topic like climate change by querying
list_publicationswith a keyword search. - Compare total commitments vs. disbursements across projects using financial fields from
list_projectsandget_project_detail. - Feed AfDB news summaries into a development finance newsletter using
list_newsresponse fieldstitle,date, andsummary. - Map regional development activity by iterating
get_countries_listregion groups and enriching each country with project data.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does the African Development Bank offer an official developer API?+
What does `get_project_detail` return beyond what `list_projects` includes?+
list_projects returns summary-level fields per project: id, iati_identifier, title, activity_status, total_commitments, and total_disbursements. get_project_detail returns the same core fields plus afdb_identifier_ref and is scoped to a single project by its AfDB or IATI identifier, making it suitable for detailed lookups rather than bulk enumeration.Can I filter projects by sector or theme?+
list_projects endpoint returns a filterable object in every response listing valid values for sectors, themes, status, region, year, and adfcycle alongside country codes. You pass country_code as an input parameter; other filter dimensions are documented through the filterable field so you can construct valid filter queries.Does the API return project documents or full publication PDFs?+
list_publications returns title, url, and date for each publication — the url points to the AfDB website page for that document. PDF content, embedded attachments, and full document text are not returned. The API covers project records, procurement notices, news articles, and publication metadata. You can fork it on Parse and revise to add an endpoint that fetches and parses the content at a given publication URL.Are non-African member countries included in the countries data?+
get_countries_list organizes countries by region including a 'Non-Regional' group, which covers AfDB non-regional member states (typically countries outside Africa that hold membership). Slugs and URLs are provided for these entries the same way as regional African members.