Guides

Agriculture

Access crop production, yields, irrigation, land use, and livestock data across African countries with historical series and latest values.

African Agriculture Data API

Use Africa API to compare crop output across countries, track yields over time, monitor irrigation and land use, and pull agriculture context into country workflows.

Coming from DataAfrica? The old api.dataafrica.io crop, rainfall, and nutrition queries have been unmaintained since 2017. See the DataAfrica migration guide for endpoint mappings.

This page is the best starting point when you need:

  • agriculture indicators by category
  • latest agriculture snapshots by country
  • historical crop or land-use time series
  • agriculture context inside country profiles

Start With These Endpoints

Agriculture data is exposed through shared indicator, data, and country-profile endpoints.

  • GET /v1/indicators?category=agriculture
  • GET /v1/data?category=agriculture
  • GET /v1/countries/{country_code}/profile
  • GET /v1/sources/faostat_agriculture

Common Agriculture Questions

  • Which crop and livestock metrics are available today?
  • Which countries have data for a specific agriculture metric?
  • How do I fetch the latest agriculture snapshot versus a full time series?
  • How do I blend agriculture with broader country context?

Common Agriculture Workflows

  • Discover the agriculture metrics currently available with /v1/indicators?category=agriculture.
  • Fetch a latest snapshot with /v1/data?category=agriculture&latest=true.
  • Pull a country time series when you need a specific metric across multiple years.
  • Use country profiles when you want agriculture highlights alongside broader economic and infrastructure context.

Useful Metrics

  • agricultural_land_1000ha
  • arable_land_1000ha
  • forest_land_1000ha
  • land_equipped_for_irrigation_1000ha
  • maize_production_tonnes
  • wheat_production_tonnes
  • rice_production_tonnes
  • maize_yield_kg_per_ha
  • wheat_yield_kg_per_ha
  • rice_yield_kg_per_ha
  • cattle_stock_head
  • chicken_stock_1000_head

Example: Compare Crop Production Across Countries

curl "https://api.africa-api.com/v1/data?country_codes=ng,et,za&metric_key=maize_production_tonnes&year=2024" \
  -H "Authorization: Bearer $AFRICA_API_KEY"

Example: Discover Agriculture Metrics And Coverage

curl "https://api.africa-api.com/v1/indicators?category=agriculture&has_data=true" \
  -H "Authorization: Bearer $AFRICA_API_KEY"

Example: Get The Latest Agriculture Snapshot For A Country

curl "https://api.africa-api.com/v1/data?country_code=ke&category=agriculture&latest=true" \
  -H "Authorization: Bearer $AFRICA_API_KEY"

Coverage And Source Notes

Agriculture coverage depends on the metric and country, so check the indicator catalog before you hard-code a workflow around one series.

The main agriculture source in this slice is faostat_agriculture.

Use /v1/indicators?category=agriculture&has_data=true when you want to confirm which metrics are available, how they are named, and where coverage is already strong.

Agriculture API FAQ

Which crops does the agriculture API cover?

Maize, rice, and wheat production (tonnes) and yields (kg/ha) across African countries, plus land-use series (agricultural, arable, and forest land, land equipped for irrigation) and livestock (cattle and chicken stocks). All series come from FAOSTAT with annual frequency and historical depth.

How do I build agriculture reporting on Africa API?

Discover available metrics with /v1/indicators?category=agriculture&has_data=true, pull latest values for report cards with /v1/data?category=agriculture&latest=true, and request full time series per metric for charts. Rankings (/v1/indicators/{metric_key}/rankings) cover leaderboard-style reporting across countries.

Which African countries have crop production data?

FAOSTAT coverage is continent-wide, but depth varies by metric and country. Check coverage per indicator with /v1/indicators?category=agriculture before hard-coding a workflow around one series.

On this page