# Africa API
> Query African country records, indicators, markets, trade and government data through one REST API. Coverage and reporting periods vary by dataset.

## Core URLs
- Website: https://africa-api.com/
- Documentation: https://africa-api.com/docs
- Full docs as plain text: https://africa-api.com/llms-full.txt
- API Base URL: https://api.africa-api.com
- OpenAPI Schema: https://api.africa-api.com/openapi.json
- MCP server: https://www.npmjs.com/package/africa-api-mcp (run with `npx -y africa-api-mcp`)
- Free API key: https://africa-api.com/dashboard
- Repository: https://github.com/africa-api/africa-api

## Data Explorer (free to browse, no key required)
- Browse 207 indicators with country rankings, sources and available history. Country and year coverage varies by metric: https://africa-api.com/data
- Per-country profiles of key indicators, e.g. https://africa-api.com/data/nigeria or https://africa-api.com/data/kenya
- Per-country per-indicator pages, e.g. https://africa-api.com/data/nigeria/inflation
- Currency converter: USD pairs, rate sources and available history: https://africa-api.com/convert
- Query indicator observations with an API key: https://api.africa-api.com/v1/data?metric_key=<key>&latest=true

### Indicator rankings (one page per metric)
### Economy
- [GDP by African country](https://africa-api.com/data/gdp): Gross domestic product in current US dollars.
- [GDP per Capita by African country](https://africa-api.com/data/gdp-per-capita): Gross domestic product divided by mid-year population, in current US dollars.
- [Inflation Rate by African country](https://africa-api.com/data/inflation): Latest year-on-year consumer price inflation.
- [Central Bank Policy Rate by African country](https://africa-api.com/data/central-bank-rate): The central bank's headline monetary policy rate.
- [Official Exchange Rate by African country](https://africa-api.com/data/exchange-rate): Official local currency units per US dollar.
- [Budget Balance by African country](https://africa-api.com/data/fiscal-balance): General government net lending (surplus) or borrowing (deficit) as a percentage of GDP.
- [Unemployment Rate by African country](https://africa-api.com/data/unemployment): Share of the labor force that is unemployed.
- [Public Debt by African country](https://africa-api.com/data/public-debt): General government gross debt as a percentage of GDP.
- [Trade Balance by African country](https://africa-api.com/data/trade-balance): Exports minus imports of goods and services, in current US dollars.
- [GDP Growth by African country](https://africa-api.com/data/gdp-growth): Annual percentage growth of GDP at constant prices.
- [GNI per Capita by African country](https://africa-api.com/data/gni-per-capita): Gross national income per capita, Atlas method, in current US dollars — the basis for World Bank income-group classification.
- [GNI per Capita (PPP) by African country](https://africa-api.com/data/gni-per-capita-ppp): Gross national income per capita at purchasing power parity, in international dollars.
- [GDP (PPP) by African country](https://africa-api.com/data/gdp-ppp): Gross domestic product at purchasing power parity, in current international dollars.
- [Agriculture (% of GDP) by African country](https://africa-api.com/data/agriculture-gdp-share): Value added by agriculture, forestry and fishing as a share of GDP.
- [Industry (% of GDP) by African country](https://africa-api.com/data/industry-gdp-share): Value added by industry, including construction, as a share of GDP.
- [Manufacturing (% of GDP) by African country](https://africa-api.com/data/manufacturing-gdp-share): Value added by manufacturing as a share of GDP.
- [Services (% of GDP) by African country](https://africa-api.com/data/services-gdp-share): Value added by services as a share of GDP.
- [Investment (% of GDP) by African country](https://africa-api.com/data/investment-gdp-share): Gross capital formation (investment in fixed assets and inventories) as a share of GDP.
- [Remittances Received by African country](https://africa-api.com/data/remittances): Personal remittances received, in current US dollars.
- [Remittances (% of GDP) by African country](https://africa-api.com/data/remittances-gdp-share): Personal remittances received as a share of GDP.
- [External Debt (% of GNI) by African country](https://africa-api.com/data/external-debt): Total external debt stocks as a share of gross national income.
- [Foreign Reserves by African country](https://africa-api.com/data/reserves): Total reserves including gold, in current US dollars.
- [Credit to Private Sector (% of GDP) by African country](https://africa-api.com/data/private-credit): Credit to the private sector by financial corporations as a share of GDP — a measure of financial depth.
- [Tax Revenue (% of GDP) by African country](https://africa-api.com/data/tax-revenue): Central government tax revenue as a share of GDP.
- [Labor Force Participation by African country](https://africa-api.com/data/labor-force-participation): Share of the population ages 15+ that is economically active (ILO modelled estimate).
- [Female Labor Force Participation by African country](https://africa-api.com/data/female-labor-force-participation): Share of women ages 15+ that is economically active (ILO modelled estimate).
- [Income Inequality (Gini) by African country](https://africa-api.com/data/income-inequality): Gini index of income inequality, where 0 is perfect equality and 100 is perfect inequality.
- [Extreme Poverty Rate by African country](https://africa-api.com/data/extreme-poverty): Share of the population living on less than $2.15 a day at 2017 international prices.
- [Account Ownership by African country](https://africa-api.com/data/financial-inclusion): Share of adults (15+) with an account at a bank or mobile-money provider (World Bank Global Findex).
- [Youth NEET Rate by African country](https://africa-api.com/data/youth-neet): Share of youth (15-24) not in employment, education or training.
- [Military Spending (% of GDP) by African country](https://africa-api.com/data/military-spending): Military expenditure as a share of GDP (SIPRI via World Bank).
- [Trade Openness (% of GDP) by African country](https://africa-api.com/data/trade-openness): Exports plus imports of goods and services as a share of GDP.
- [Inflation (GDP Deflator) by African country](https://africa-api.com/data/gdp-deflator): Annual growth of the GDP implicit deflator, a broad economy-wide measure of inflation.
- [Tourism Receipts by African country](https://africa-api.com/data/tourism-receipts): Receipts earned from international inbound visitors, in current US dollars.
- [Tourist Arrivals by African country](https://africa-api.com/data/tourist-arrivals): Number of international inbound tourists (overnight visitors).
- [Current Account Balance by African country](https://africa-api.com/data/current-account): Current account balance (trade, income and transfers) as a share of GDP.
- [Foreign Direct Investment by African country](https://africa-api.com/data/fdi): Net foreign direct investment inflows, in current US dollars.
- [FDI (% of GDP) by African country](https://africa-api.com/data/fdi-gdp-share): Net foreign direct investment inflows as a share of GDP.
- [Government Revenue (% of GDP) by African country](https://africa-api.com/data/government-revenue): General government revenue as a share of GDP.
- [Government Spending (% of GDP) by African country](https://africa-api.com/data/government-spending): General government total expenditure as a share of GDP.
- [Youth Unemployment Rate by African country](https://africa-api.com/data/youth-unemployment): Share of the labor force ages 15-24 that is unemployed (ILO modelled estimate).
- [Productive Capacity Index by African country](https://africa-api.com/data/productive-capacity): UNCTAD index of a country's productive capacities across human capital, energy, transport, ICT and institutions (0-100).
- [Natural Resource Rents by African country](https://africa-api.com/data/natural-resource-rents): Sum of oil, gas, coal, mineral and forest rents as a share of GDP — a measure of dependence on extractive resources.
- [Oil Rents (% of GDP) by African country](https://africa-api.com/data/oil-rents): Oil rents — the value of crude oil production at world prices less the cost of production — as a share of GDP.
- [Mineral Rents (% of GDP) by African country](https://africa-api.com/data/mineral-rents): Mineral rents — the value of production at world prices less the cost of production — as a share of GDP.
- [Natural Gas Rents (% of GDP) by African country](https://africa-api.com/data/natural-gas-rents): Natural gas rents — the value of production at world prices less the cost of production — as a share of GDP.
- [Foreign Aid (% of GNI) by African country](https://africa-api.com/data/foreign-aid): Net official development assistance received as a share of gross national income — a measure of aid dependence.
- [Foreign Aid per Capita by African country](https://africa-api.com/data/foreign-aid-per-capita): Net official development assistance received per person, in current US dollars.
- [Lending Interest Rate by African country](https://africa-api.com/data/lending-rate): Bank rate that usually meets the short- and medium-term financing needs of the private sector.
- [Real Interest Rate by African country](https://africa-api.com/data/real-interest-rate): Lending interest rate adjusted for inflation as measured by the GDP deflator.
- [Gross Savings (% of GDP) by African country](https://africa-api.com/data/gross-savings): Gross savings (gross national income less consumption plus net transfers) as a share of GDP.
- [Adjusted Net Income per Capita by African country](https://africa-api.com/data/adjusted-net-income-per-capita): Gross national income less depreciation of fixed capital and depletion of natural resources, per capita, in current US dollars.
- [Employment in Agriculture by African country](https://africa-api.com/data/employment-agriculture): Share of total employment in agriculture (ILO modelled estimate).
- [Employment in Industry by African country](https://africa-api.com/data/employment-industry): Share of total employment in industry (ILO modelled estimate).
- [Employment in Services by African country](https://africa-api.com/data/employment-services): Share of total employment in services (ILO modelled estimate).
- [Vulnerable Employment by African country](https://africa-api.com/data/vulnerable-employment): Contributing family workers and own-account workers as a share of total employment (ILO modelled estimate).
- [Household Consumption (% of GDP) by African country](https://africa-api.com/data/household-consumption): Household and non-profit final consumption expenditure as a share of GDP.
- [Income Share of Poorest 20% by African country](https://africa-api.com/data/income-share-poorest): Share of national income or consumption held by the poorest 20% of the population.
- [Bank Branches per 100,000 by African country](https://africa-api.com/data/bank-branches): Number of commercial bank branches per 100,000 adults.
- [ATMs per 100,000 by African country](https://africa-api.com/data/atms): Number of automated teller machines (ATMs) per 100,000 adults.
- [GDP per Capita Growth by African country](https://africa-api.com/data/gdp-per-capita-growth): Annual percentage growth of GDP per capita at constant prices.
- [Debt Service (% of GNI) by African country](https://africa-api.com/data/debt-service): Total external debt service (principal and interest) as a share of gross national income.
- [Poverty Rate ($3.65/day) by African country](https://africa-api.com/data/poverty-365): Share of the population living on less than $3.65 a day at 2017 international prices (lower-middle-income line).
- [Poverty Rate ($6.85/day) by African country](https://africa-api.com/data/poverty-685): Share of the population living on less than $6.85 a day at 2017 international prices (upper-middle-income line).
### Trade
- [Exports of Goods & Services by African country](https://africa-api.com/data/exports): Exports of goods and services, in current US dollars.
- [Imports of Goods & Services by African country](https://africa-api.com/data/imports): Imports of goods and services, in current US dollars.
- [Export Diversification Index by African country](https://africa-api.com/data/export-diversification): UNCTAD index of how far a country's export mix differs from the world structure (lower is more diversified).
- [Export Concentration Index by African country](https://africa-api.com/data/export-concentration): UNCTAD Herfindahl-Hirschmann index of how concentrated exports are in a few products (lower is less concentrated).
- [Liner Shipping Connectivity by African country](https://africa-api.com/data/shipping-connectivity): UNCTAD index of how well a country is connected to global container shipping networks (2004 maximum = 100).
- [Fuel Exports (% of Exports) by African country](https://africa-api.com/data/fuel-exports): Fuels (SITC section 3) as a share of total merchandise exports.
- [Manufactures Exports (% of Exports) by African country](https://africa-api.com/data/manufactures-exports): Manufactured goods (SITC sections 5-8 excluding 68) as a share of total merchandise exports.
- [Food Exports (% of Exports) by African country](https://africa-api.com/data/food-exports): Food (SITC sections 0, 1, 4 and division 22) as a share of total merchandise exports.
- [High-Tech Exports (% of Manufactured) by African country](https://africa-api.com/data/high-tech-exports): High-technology exports (products with high R&D intensity) as a share of manufactured exports.
- [Exports (% of GDP) by African country](https://africa-api.com/data/exports-gdp-share): Exports of goods and services as a share of GDP.
- [Imports (% of GDP) by African country](https://africa-api.com/data/imports-gdp-share): Imports of goods and services as a share of GDP.
### Development
- [Human Development Index by African country](https://africa-api.com/data/human-development-index): UNDP composite index of life expectancy, education and income on a 0-1 scale (higher is better).
- [Gender Inequality Index by African country](https://africa-api.com/data/gender-inequality): UNDP index of gender-based disadvantage across reproductive health, empowerment and the labour market on a 0-1 scale (higher is worse).
- [Inequality-adjusted HDI by African country](https://africa-api.com/data/inequality-adjusted-hdi): Human Development Index discounted for inequality across its dimensions, on a 0-1 scale (higher is better).
### Demographics
- [Population by African country](https://africa-api.com/data/population): Total mid-year population.
- [Population Growth by African country](https://africa-api.com/data/population-growth): Annual population growth rate.
- [Life Expectancy by African country](https://africa-api.com/data/life-expectancy): Life expectancy at birth, in years.
- [Median Age by African country](https://africa-api.com/data/median-age): Median age of the population, in years.
- [Fertility Rate by African country](https://africa-api.com/data/fertility-rate): Births per woman over a lifetime at current rates.
- [Rural Population by African country](https://africa-api.com/data/rural-population): Share of the population living in rural areas.
- [Population Under 15 by African country](https://africa-api.com/data/population-under-15): Share of the population aged 0 to 14 years.
- [Urban Population by African country](https://africa-api.com/data/urban-population): Share of the population living in urban areas.
- [Population Density by African country](https://africa-api.com/data/population-density): People per square kilometre of land area.
- [Birth Rate by African country](https://africa-api.com/data/birth-rate): Live births per 1,000 people per year.
- [Death Rate by African country](https://africa-api.com/data/death-rate): Deaths per 1,000 people per year.
- [Net Migration Rate by African country](https://africa-api.com/data/net-migration-rate): Net number of migrants per 1,000 people — positive for net immigration, negative for net emigration.
- [Life Expectancy (Female) by African country](https://africa-api.com/data/life-expectancy-female): Female life expectancy at birth, in years.
- [Life Expectancy (Male) by African country](https://africa-api.com/data/life-expectancy-male): Male life expectancy at birth, in years.
- [Urban Population Growth by African country](https://africa-api.com/data/urban-growth): Annual percentage growth of the urban population.
### Health
- [Infant Mortality by African country](https://africa-api.com/data/infant-mortality): Infant deaths before age one per 1,000 live births.
- [HIV Prevalence by African country](https://africa-api.com/data/hiv-prevalence): Share of people ages 15-49 living with HIV.
- [Health Spending (% of GDP) by African country](https://africa-api.com/data/health-spending): Current health expenditure as a share of GDP.
- [Physicians per 1,000 by African country](https://africa-api.com/data/physicians): Medical doctors (generalists and specialists) per 1,000 people.
- [UHC Service Coverage Index by African country](https://africa-api.com/data/universal-health-coverage): WHO Universal Health Coverage service coverage index (0-100), based on tracer interventions.
- [Road Traffic Deaths by African country](https://africa-api.com/data/road-traffic-deaths): Estimated road traffic deaths per 100,000 population (WHO).
- [Premature NCD Mortality by African country](https://africa-api.com/data/ncd-mortality): Probability of dying between ages 30 and 70 from cardiovascular disease, cancer, diabetes or chronic respiratory disease.
- [Out-of-Pocket Health Spending by African country](https://africa-api.com/data/out-of-pocket-health): Out-of-pocket expenditure as a share of current health expenditure (WHO).
- [Safely Managed Sanitation by African country](https://africa-api.com/data/safe-sanitation): Share of the population using safely managed sanitation services.
- [Maternal Mortality by African country](https://africa-api.com/data/maternal-mortality): Maternal deaths per 100,000 live births.
- [Under-Five Mortality by African country](https://africa-api.com/data/under-five-mortality): Deaths before age five per 1,000 live births.
- [Neonatal Mortality by African country](https://africa-api.com/data/neonatal-mortality): Deaths in the first 28 days of life per 1,000 live births.
- [Tuberculosis Incidence by African country](https://africa-api.com/data/tuberculosis): Estimated new and relapse tuberculosis cases per 100,000 people (WHO).
- [Measles Immunization by African country](https://africa-api.com/data/measles-immunization): Share of children ages 12-23 months immunized against measles.
- [DTP3 Immunization by African country](https://africa-api.com/data/dtp3-immunization): Share of children ages 12-23 months immunized with three doses of diphtheria-tetanus-pertussis vaccine.
- [Basic Drinking Water by African country](https://africa-api.com/data/drinking-water): Share of the population using at least basic drinking water services (WHO/UNICEF JMP).
- [Basic Sanitation by African country](https://africa-api.com/data/sanitation): Share of the population using at least basic sanitation services (WHO/UNICEF JMP).
- [Diabetes Prevalence by African country](https://africa-api.com/data/diabetes): Share of the population ages 20-79 with type 1 or type 2 diabetes.
- [Hospital Beds per 1,000 by African country](https://africa-api.com/data/hospital-beds): Hospital beds — inpatient beds in public, private, general and specialised hospitals — per 1,000 people.
- [Contraceptive Prevalence by African country](https://africa-api.com/data/contraceptive-prevalence): Share of women ages 15-49, married or in union, using any method of contraception.
- [Skilled Birth Attendance by African country](https://africa-api.com/data/skilled-birth-attendance): Share of live births attended by skilled health personnel (doctors, nurses or midwives).
- [Nurses & Midwives per 1,000 by African country](https://africa-api.com/data/nurses-midwives): Number of nurses and midwives per 1,000 people.
- [Adolescent Fertility Rate by African country](https://africa-api.com/data/adolescent-fertility): Births per 1,000 women ages 15-19.
- [Health Spending per Capita by African country](https://africa-api.com/data/health-spending-per-capita): Current health expenditure per person, in current US dollars.
- [NCD Share of Deaths by African country](https://africa-api.com/data/ncd-deaths): Share of total deaths caused by non-communicable diseases (cardiovascular, cancer, diabetes, chronic respiratory).
- [Smoking Prevalence by African country](https://africa-api.com/data/smoking): Share of adults who currently smoke any tobacco product (age-standardised).
- [Antenatal Care Coverage by African country](https://africa-api.com/data/antenatal-care): Share of women with a live birth who received antenatal care from a skilled provider at least once.
### Child Welfare
- [Child Stunting by African country](https://africa-api.com/data/child-stunting): Share of children under 5 who are stunted (low height-for-age), a marker of chronic undernutrition.
- [Child Wasting by African country](https://africa-api.com/data/child-wasting): Share of children under 5 who are wasted (low weight-for-height), a marker of acute undernutrition.
- [Birth Registration by African country](https://africa-api.com/data/birth-registration): Share of children under 5 whose births are registered with a civil authority (UNICEF).
- [Child Marriage by African country](https://africa-api.com/data/child-marriage): Share of women aged 20-24 who were first married or in union before age 18 (UNICEF).
- [Overweight Children by African country](https://africa-api.com/data/child-overweight): Share of children under 5 who are overweight (weight-for-height above two standard deviations).
### Education
- [Education Spending (% of GDP) by African country](https://africa-api.com/data/education-spending): Government expenditure on education as a share of GDP.
- [Tertiary Enrollment by African country](https://africa-api.com/data/tertiary-enrollment): Gross enrollment ratio in tertiary education, regardless of age.
- [Adult Literacy Rate by African country](https://africa-api.com/data/adult-literacy): Share of people ages 15 and over who can read and write.
- [Youth Literacy Rate by African country](https://africa-api.com/data/youth-literacy): Share of people ages 15-24 who can read and write.
- [Primary Completion Rate by African country](https://africa-api.com/data/primary-completion): Gross intake ratio to the last grade of primary education.
- [Lower Secondary Completion by African country](https://africa-api.com/data/lower-secondary-completion): Gross intake ratio to the last grade of lower secondary education.
- [Primary Net Enrollment by African country](https://africa-api.com/data/primary-net-enrollment): Share of primary-school-age children enrolled in primary education.
- [Lower Secondary Enrollment by African country](https://africa-api.com/data/lower-secondary-net-enrollment): Net enrollment rate in lower secondary education.
- [Upper Secondary Enrollment by African country](https://africa-api.com/data/upper-secondary-net-enrollment): Net enrollment rate in upper secondary education.
- [Upper Secondary Completion by African country](https://africa-api.com/data/upper-secondary-completion): Gross intake ratio to the last grade of upper secondary education.
- [Qualified Primary Teachers by African country](https://africa-api.com/data/qualified-primary-teachers): Share of primary-school teachers with the minimum required qualifications.
- [Secondary Enrollment by African country](https://africa-api.com/data/secondary-enrollment): Gross enrollment ratio in secondary education, regardless of age, as a share of the official secondary-age population.
### Food Security
- [Undernourishment by African country](https://africa-api.com/data/undernourishment): Share of the population whose food intake is insufficient for an active, healthy life.
- [Acute Food Insecurity by African country](https://africa-api.com/data/food-insecurity): People in IPC/CH Phase 3 (Crisis) or worse — acute food insecurity requiring urgent action — from FEWS NET's latest current-situation estimate.
### Agriculture
- [Agricultural Land (% of Land) by African country](https://africa-api.com/data/agricultural-land): Share of land area that is arable, under permanent crops, or under permanent pasture.
- [Food Production Index by African country](https://africa-api.com/data/food-production): Food production index (2014-2016 = 100) covering edible, nutritious crops and livestock.
- [Cassava Production by African country](https://africa-api.com/data/cassava): Annual cassava production, in tonnes (FAOSTAT).
- [Coffee Production by African country](https://africa-api.com/data/coffee): Annual green coffee production, in tonnes (FAOSTAT).
- [Cocoa Production by African country](https://africa-api.com/data/cocoa): Annual cocoa beans production, in tonnes (FAOSTAT).
- [Sorghum Production by African country](https://africa-api.com/data/sorghum): Annual sorghum production, in tonnes (FAOSTAT).
- [Millet Production by African country](https://africa-api.com/data/millet): Annual millet production, in tonnes (FAOSTAT).
- [Maize Production by African country](https://africa-api.com/data/maize): Annual maize production, in tonnes (FAOSTAT).
- [Rice Production by African country](https://africa-api.com/data/rice): Annual rice (paddy) production, in tonnes (FAOSTAT).
- [Wheat Production by African country](https://africa-api.com/data/wheat): Annual wheat production, in tonnes (FAOSTAT).
- [Maize Yield by African country](https://africa-api.com/data/maize-yield): Maize yield, in kilograms per hectare harvested (FAOSTAT).
- [Rice Yield by African country](https://africa-api.com/data/rice-yield): Rice yield, in kilograms per hectare harvested (FAOSTAT).
- [Wheat Yield by African country](https://africa-api.com/data/wheat-yield): Wheat yield, in kilograms per hectare harvested (FAOSTAT).
- [Cattle Stock by African country](https://africa-api.com/data/cattle): Number of live cattle (FAOSTAT).
### Governance
- [Homicide Rate by African country](https://africa-api.com/data/homicide-rate): Intentional homicides per 100,000 people (UNODC via World Bank).
- [Corruption Perceptions Index by African country](https://africa-api.com/data/corruption-perceptions-index): Transparency International's index of perceived public-sector corruption on a 0-100 scale (higher is cleaner).
- [Electoral Democracy Index by African country](https://africa-api.com/data/electoral-democracy): V-Dem electoral democracy (polyarchy) index on a 0-1 scale (higher is more democratic).
- [Liberal Democracy Index by African country](https://africa-api.com/data/liberal-democracy): V-Dem liberal democracy index — electoral democracy plus liberal checks and protections — on a 0-1 scale.
- [Political Corruption Index by African country](https://africa-api.com/data/political-corruption): V-Dem expert-coded index of political corruption across government on a 0-1 scale (higher is more corrupt).
- [Control of Corruption by African country](https://africa-api.com/data/control-of-corruption): World Bank Worldwide Governance Indicator for control of corruption, from −2.5 (weak) to 2.5 (strong).
- [Government Effectiveness by African country](https://africa-api.com/data/government-effectiveness): World Bank Worldwide Governance Indicator for government effectiveness, from −2.5 (weak) to 2.5 (strong).
- [Rule of Law by African country](https://africa-api.com/data/rule-of-law): World Bank Worldwide Governance Indicator for rule of law, from −2.5 (weak) to 2.5 (strong).
- [Political Stability by African country](https://africa-api.com/data/political-stability): World Bank Worldwide Governance Indicator for political stability and absence of violence, from −2.5 (weak) to 2.5 (strong).
- [Regulatory Quality by African country](https://africa-api.com/data/regulatory-quality): World Bank Worldwide Governance Indicator for regulatory quality, from −2.5 (weak) to 2.5 (strong).
- [Voice and Accountability by African country](https://africa-api.com/data/voice-and-accountability): World Bank Worldwide Governance Indicator for voice and accountability, from −2.5 (weak) to 2.5 (strong).
- [Organized Violence Deaths by African country](https://africa-api.com/data/organized-violence-deaths): UCDP best estimate of deaths from state-based conflict, non-state conflict, and one-sided violence within the country's borders.
- [State-Based Conflict Dyads by African country](https://africa-api.com/data/state-based-conflict-dyads): Number of active UCDP state-based conflict dyads within the country's borders.
- [Non-State Conflict Dyads by African country](https://africa-api.com/data/non-state-conflict-dyads): Number of active UCDP non-state conflict dyads within the country's borders.
- [One-Sided Violence Dyads by African country](https://africa-api.com/data/one-sided-violence-dyads): Number of active UCDP one-sided violence dyads within the country's borders.
### Humanitarian
- [Refugees Hosted by African country](https://africa-api.com/data/refugees-hosted): Number of refugees hosted in the country (UNHCR).
- [Internally Displaced People by African country](https://africa-api.com/data/internally-displaced): Number of people displaced within their own country (UNHCR).
- [Asylum Seekers Hosted by African country](https://africa-api.com/data/asylum-seekers): Number of asylum seekers hosted in the country (UNHCR).
- [Stateless People by African country](https://africa-api.com/data/stateless-people): Number of stateless people in the country (UNHCR).
### Technology
- [Internet Users by African country](https://africa-api.com/data/internet-users): Individuals using the internet as a share of population.
- [Mobile Subscriptions by African country](https://africa-api.com/data/mobile-subscriptions): Mobile cellular subscriptions per 100 people.
- [4G Coverage by African country](https://africa-api.com/data/4g-coverage): Share of the population covered by a 4G mobile network (ITU).
- [Fixed Broadband Subscriptions by African country](https://africa-api.com/data/fixed-broadband): Fixed broadband subscriptions per 100 people (ITU).
- [Mobile Data Price by African country](https://africa-api.com/data/mobile-data-price): Price of a 2GB mobile data basket as a share of monthly GNI per capita — lower is more affordable (ITU).
- [3G Coverage by African country](https://africa-api.com/data/3g-coverage): Share of the population covered by at least a 3G mobile network (ITU).
- [Fixed Broadband Price by African country](https://africa-api.com/data/fixed-broadband-price): Price of a fixed-broadband basket as a share of monthly GNI per capita — lower is more affordable (ITU).
- [Mobile Bundle Price by African country](https://africa-api.com/data/mobile-bundle-price): Price of a mobile voice-and-data basket as a share of monthly GNI per capita — lower is more affordable (ITU).
- [R&D Spending (% of GDP) by African country](https://africa-api.com/data/rd-spending): Gross domestic expenditure on research and development as a share of GDP.
### Infrastructure
- [Electricity Access by African country](https://africa-api.com/data/electricity-access): Share of the population with access to electricity.
- [Air Transport Passengers by African country](https://africa-api.com/data/air-passengers): Passengers carried by air transport registered in the country.
- [Slum Population by African country](https://africa-api.com/data/slum-population): Share of the urban population living in slums, informal settlements or inadequate housing.
### Energy
- [Renewable Energy Capacity by African country](https://africa-api.com/data/renewable-capacity): Total installed renewable electricity capacity, in megawatts (IRENA).
- [Solar Capacity by African country](https://africa-api.com/data/solar-capacity): Installed solar electricity capacity, in megawatts (IRENA).
- [Wind Capacity by African country](https://africa-api.com/data/wind-capacity): Installed wind electricity capacity, in megawatts (IRENA).
- [Hydropower Capacity by African country](https://africa-api.com/data/hydropower-capacity): Installed hydropower electricity capacity, in megawatts (IRENA).
- [Renewable Energy Share by African country](https://africa-api.com/data/renewable-energy-share): Renewable energy as a share of total final energy consumption.
- [Clean Cooking Access by African country](https://africa-api.com/data/clean-cooking): Share of the population with primary reliance on clean fuels and technologies for cooking.
- [Electricity Consumption per Capita by African country](https://africa-api.com/data/power-consumption): Electric power consumption per person, in kilowatt-hours.
- [Power Transmission Losses by African country](https://africa-api.com/data/transmission-losses): Electricity lost in transmission and distribution as a share of output.
- [Off-grid Renewable Capacity by African country](https://africa-api.com/data/offgrid-renewable-capacity): Installed off-grid renewable electricity capacity, in megawatts (IRENA).
- [Rural Electricity Access by African country](https://africa-api.com/data/rural-electricity): Share of the rural population with access to electricity.
- [Solar Share of Electricity by African country](https://africa-api.com/data/solar-electricity-share): Share of electricity generation that comes from solar (Ember via Our World in Data).
- [Wind Share of Electricity by African country](https://africa-api.com/data/wind-electricity-share): Share of electricity generation that comes from wind (Ember via Our World in Data).
- [Hydropower Share of Electricity by African country](https://africa-api.com/data/hydro-electricity-share): Share of electricity generation that comes from hydropower (Ember via Our World in Data).
- [Fossil Share of Electricity by African country](https://africa-api.com/data/fossil-electricity-share): Share of electricity generation from fossil fuels — coal, gas and oil (Ember via Our World in Data).
- [Electricity Demand by African country](https://africa-api.com/data/electricity-demand): Total electricity demand, in terawatt-hours (Ember via Our World in Data).
- [Electricity Carbon Intensity by African country](https://africa-api.com/data/grid-carbon-intensity): Carbon dioxide emitted per kilowatt-hour of electricity generated — a measure of how clean the grid is (Ember via Our World in Data).
- [Primary Energy per Capita by African country](https://africa-api.com/data/energy-per-capita): Primary energy consumption per person, in kilowatt-hours (Energy Institute / Ember via Our World in Data).
### Climate
- [CO2 Emissions per Capita by African country](https://africa-api.com/data/co2-emissions): Greenhouse gas emissions per person, in tonnes of CO2 equivalent.
- [Renewable Electricity Output by African country](https://africa-api.com/data/renewable-electricity): Electricity generated from renewable sources as a share of total output.
- [Forest Area by African country](https://africa-api.com/data/forest-area): Forest area as a share of total land area.
- [Protected Areas by African country](https://africa-api.com/data/protected-areas): Terrestrial and marine protected areas as a share of total territorial area.
- [Freshwater Withdrawals by African country](https://africa-api.com/data/freshwater-withdrawals): Annual freshwater withdrawals as a share of internal renewable water resources — a water-stress indicator.
- [PM2.5 Air Pollution by African country](https://africa-api.com/data/air-pollution): Population-weighted mean annual exposure to fine particulate matter (PM2.5), in micrograms per cubic metre.

## Prioritized Documentation
- [Africa API Documentation](https://africa-api.com/docs): API reference and examples for African country records, indicators, markets, trade, and government data.
- [Quickstart](https://africa-api.com/docs/quickstart): Create an API key and make your first authenticated request for African country data.
- [Countries](https://africa-api.com/docs/countries): Get reference records for 54 African countries, country profiles, and selected latest observations. Data coverage and reporting periods vary by metric and source.
- [Authentication](https://africa-api.com/docs/authentication): Authenticate Africa API requests with bearer tokens, create API keys in the dashboard, and understand which routes are public.
- [MCP Server](https://africa-api.com/docs/mcp): Configure the Africa API MCP server to query countries, indicators, markets, trade, elections, and policies from an AI client.
- [Errors](https://africa-api.com/docs/errors): HTTP status codes, validation failures, and common error shapes returned by Africa API.
- [Rate Limits](https://africa-api.com/docs/rate-limits): Per-plan request quotas, 429 behavior, and client patterns for retries, batching, and caching on the Africa API.
- [SDKs](https://africa-api.com/docs/sdks): HTTP client examples for calling Africa API from JavaScript, TypeScript, and Python.
- [DataAfrica API (api.dataafrica.io): Migration Guide](https://africa-api.com/docs/dataafrica-api): Map selected api.dataafrica.io queries to Africa API, check differences in metrics and geography, and review endpoint checks recorded in June 2026.
- [FAQ](https://africa-api.com/docs/faq): Product and integration questions for teams adopting Africa API.

## Full Documentation Index
- [African Countries API](https://africa-api.com/docs/african-countries-api): Choose Africa API endpoints for country lists, reference records, profiles, and country signals.
- [African Indicators and Time Series API](https://africa-api.com/docs/african-indicators-api): Discover African indicators, request observations and time series, and rank countries for a selected year.
- [African Market Data API](https://africa-api.com/docs/african-market-data-api): Query supported African exchanges, tickers, historical price observations, and source-specific FX rates.
- [Agriculture](https://africa-api.com/docs/agriculture): Access crop production, yields, irrigation, land use, and livestock data across African countries with historical series and latest values.
- [Central Banks](https://africa-api.com/docs/central-banks): Query the latest available central-bank policy rates, benchmark rates, and monthly inflation observations for supported countries and currency unions.
- [Climate](https://africa-api.com/docs/climate): Query annual climate and environment indicators alongside daily and rolling point-based estimates from NASA POWER.
- [Commodities](https://africa-api.com/docs/commodities): Use benchmark commodity prices from country signals to add current market context without leaving the API.
- [Coverage](https://africa-api.com/docs/coverage): Country and source coverage for historical indicators, country signals, markets, FX, trade, government, and transport.
- [Data](https://africa-api.com/docs/data): Query African indicators, latest values, and time series across countries, years, categories, and sources.
- [Demographics](https://africa-api.com/docs/demographics): Use indicators and data endpoints to work with population, age, fertility, and dependency metrics.
- [Disasters](https://africa-api.com/docs/disasters): Use GDACS disaster alerts in country signals to surface current flood, cyclone, wildfire, earthquake, and volcanic-risk context.
- [Economy](https://africa-api.com/docs/economy): Use indicators and data endpoints to work with GDP, inflation, unemployment, and other macro signals.
- [Elections](https://africa-api.com/docs/elections): Query African election events, country election overviews, and candidate-level results from Wikidata where available.
- [Energy](https://africa-api.com/docs/energy): Use indicators and data endpoints to work with electricity access, clean cooking, renewable energy, and longer-run power system efficiency.
- [Geographies](https://africa-api.com/docs/geographies): Traverse continent, region, country, and other geography records exposed by Africa API.
- [Geography](https://africa-api.com/docs/geography): Use countries and geographies endpoints to work with location hierarchy and spatial reference data.
- [Governance And Conflict](https://africa-api.com/docs/governance): Compare institutional quality and query versioned organized-violence estimates across African countries.
- [Government](https://africa-api.com/docs/government): Query African government overviews, current leaders, historical terms, cabinet records, and related country government data.
- [Health](https://africa-api.com/docs/health): Query African immunization, mortality, TB, child nutrition, and water and sanitation indicators from WHO and UNICEF. Available countries and years vary by metric.
- [Humanitarian](https://africa-api.com/docs/humanitarian): Use UNHCR displacement signals in country snapshots and latest-value queries for refugee, asylum seeker, IDP, and stateless-population context.
- [Indicators](https://africa-api.com/docs/indicators): Discover available metrics, inspect coverage, and request country rankings from Africa API.
- [Markets](https://africa-api.com/docs/markets): Query African exchanges, tickers, historical market data, and FX rates through Africa API.
- [Platform](https://africa-api.com/docs/platform): Inspect release identity, source freshness, and data quality when you need operational visibility.
- [Policies](https://africa-api.com/docs/policies): Query African laws, policy documents, and lifecycle events from Wikidata, with country overviews and timelines where records are available.
- [Power](https://africa-api.com/docs/power): Query the latest available grid-generation and outage observations for Nigeria and South Africa, alongside historical energy indicators.
- [Signals](https://africa-api.com/docs/signals): Query selected latest observations, exchange rates, commodity benchmarks, alerts, trade summaries, and government records for one country. Coverage and reporting periods vary by source.
- [Sources](https://africa-api.com/docs/sources): Inspect source metadata, licensing context, citations, and the latest successful refresh for a dataset.
- [Status](https://africa-api.com/docs/status): Check Africa API platform status, health, and release identity before making protected API calls.
- [Trade](https://africa-api.com/docs/trade): Use the dedicated trade domain for African trade overviews, partner data, product data, and trade flows, with aggregate trade metrics also available through shared data endpoints.
- [Transport](https://africa-api.com/docs/transport): Query historical transport and connectivity indicators, plus airport and port observations for South Africa and port observations for Kenya.
- [World Bank API vs Africa API: Which One for African Data?](https://africa-api.com/docs/world-bank-api-vs-africa-api): Compare World Bank API and Africa API queries, geographic coverage, source selection, authentication, and refresh information.

## Crawl Notes
- Canonical pages are served on africa-api.com.
- Start at /docs, then follow internal links to endpoint guides.
- Endpoint examples use versioned paths under /v1.
- For code that calls api.dataafrica.io, see /docs/dataafrica-api for selected query mappings and coverage differences.
- AI assistants can query the API directly through the africa-api-mcp MCP server (npm).