African Livestock Pricing API

Livestock auction prices and market data across African markets. Track cattle, sheep, goats, pigs, and poultry prices with grade-level detail sourced from RPO and national livestock boards.

Live

Base URL

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

Authentication

Include your Livestock Pricing API key in the Authorization header.

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

Endpoints

GET/v1/livestock/markets

List livestock auction markets with optional country and region filters

Parameters: country, region, page, per_page

Example

GET /v1/livestock/markets?country=ZA

GET/v1/livestock/markets/{marketCode}

Get details for a specific auction market

Parameters: marketCode (path)

Example

GET /v1/livestock/markets/ZA-BFN-001

GET/v1/livestock/types

List animal types and categories

Parameters: None

Example

GET /v1/livestock/types

GET/v1/livestock/prices

Auction prices by market, animal type, grade, and date range

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

Example

GET /v1/livestock/prices?animal_type=cattle_beef&country=ZA

GET/v1/livestock/prices/latest

Most recent price per animal type per market

Parameters: country (optional)

Example

GET /v1/livestock/prices/latest

GET/v1/livestock/averages

Price averages by animal type, country, and period

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

Example

GET /v1/livestock/averages?animal_type=sheep&country=ZA

GET/v1/livestock/stats

Dataset statistics (total markets, animal types, price records)

Parameters: None

Example

GET /v1/livestock/stats

Response Examples

Latest prices response:

{
  "prices": [
    {
      "market_code": "ZA-BFN-001",
      "market_name": "Bloemfontein Livestock Auction",
      "animal_type_id": "cattle_beef",
      "animal_type_name": "Beef Cattle",
      "price": 28500.00,
      "currency": "ZAR",
      "unit": "per head",
      "grade": "A2",
      "weight_kg": 450.0,
      "price_date": "2026-03-05"
    }
  ]
}

Try It

Enter your Livestock 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_livestock_pricing_live_YOUR_KEY" \
     "https://crimate.net/v1/livestock/stats"

Data Sources

RPO

Red Meat Producers' Organisation of South Africa. Weekly auction prices for cattle, sheep, and goats from major livestock auctions.

National Livestock Boards

Official livestock pricing data from national agricultural boards across Botswana, Namibia, Kenya, and Tanzania.

Rate Limits

Tier	Price	Rate Limit	Daily Quota	Monthly Quota
Free	R0/mo	10 req/min	100	1,000
Starter	R599/mo	60 req/min	5,000	50,000
Pro	R2,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.