African Agricultural Pricing API

Crop prices and market data across African agricultural markets. Track maize, wheat, sorghum, rice, and more with seasonal trends sourced from SAGIS and FAO GIEWS.

Live

Base URL

https://api.crimate.net/v1/agri

Authentication

Include your Agricultural Pricing API key in the Authorization header.

curl -H "Authorization: Bearer db_agri_pricing_live_YOUR_KEY" \
     https://api.crimate.net/v1/agri/stats

Endpoints

GET/v1/agri/markets

List agricultural markets with optional country, region, and type filters

Parameters: country, region, market_type, page, per_page

Example

GET /v1/agri/markets?country=ZA

GET/v1/agri/markets/{marketCode}

Get details for a specific market

Parameters: marketCode (path)

Example

GET /v1/agri/markets/ZA-JSE-SAFEX

GET/v1/agri/commodities

List available agricultural commodities

Parameters: category (optional)

Example

GET /v1/agri/commodities?category=grains

GET/v1/agri/prices

Commodity prices by market, product, country, and date range

Parameters: market_code, commodity, country, from (YYYY-MM-DD), to (YYYY-MM-DD), page, per_page

Example

GET /v1/agri/prices?commodity=maize&country=ZA

GET/v1/agri/prices/latest

Most recent price per commodity per market

Parameters: country (optional)

Example

GET /v1/agri/prices/latest?country=KE

GET/v1/agri/trends

Price trends by commodity, country, and period

Parameters: commodity, country, from, to, page, per_page

Example

GET /v1/agri/trends?commodity=wheat&country=ZA

GET/v1/agri/stats

Dataset statistics (total markets, commodities, price records)

Parameters: None

Example

GET /v1/agri/stats

Response Examples

Latest prices response:

{
  "prices": [
    {
      "market_code": "ZA-JSE-SAFEX",
      "market_name": "SAFEX Johannesburg",
      "commodity_id": "maize",
      "commodity_name": "Maize (White)",
      "price": 4250.00,
      "currency": "ZAR",
      "unit": "per tonne",
      "price_date": "2026-03-07"
    },
    {
      "market_code": "KE-NAI-001",
      "market_name": "Nairobi Wholesale Market",
      "commodity_id": "maize",
      "commodity_name": "Maize (White)",
      "price": 38500.00,
      "currency": "KES",
      "unit": "per tonne",
      "price_date": "2026-03-06"
    }
  ]
}

Try It

Enter your Agricultural Pricing API key to make a live request. Generate a key in the dashboard.

Try It

Make a live API call from your browser

API Key

Endpoint

GET

curl -H "Authorization: Bearer db_agri_pricing_live_YOUR_KEY" \
     "https://crimate.net/v1/agri/stats"

Data Sources

SAGIS

South African Grain Information Service. Weekly spot prices for grains and oilseeds from SAFEX and regional markets.

FAO GIEWS

Global Information and Early Warning System. Food price data across African markets with monthly updates.

Rate Limits

Tier	Price	Rate Limit	Daily Quota	Monthly Quota
Free	R0/mo	10 req/min	100	1,000
Starter	R899/mo	60 req/min	5,000	50,000
Pro	R3,499/mo	300 req/min	Unlimited	500,000

Error Codes

All error responses follow a consistent JSON format:

{
  "error": "error_code",
  "message": "Human-readable description."
}

Status	Error Code	Description
400	invalid_request	The request body or query parameters are malformed.
401	unauthorized	Missing or invalid API key.
403	no_subscription	No active subscription for this API product.
403	quota_exceeded	Daily or monthly quota exceeded.
404	not_found	The requested resource does not exist.
429	rate_limit_exceeded	Too many requests. Check X-RateLimit-Remaining header.
500	internal_error	An unexpected server error occurred.