South Africa's official fuel prices, one API call away.
Every grade, every pricing zone, sourced directly from DMPR's monthly regulated circular — no scraping your own, no manual PDF lookups, and every response tagged with the exact effective date it came from.
Keys are emailed within seconds of checkout — no waitlist.
{
"effective_date": "2026-08-05",
"currency": "ZAR",
"unit": "per_litre",
"count": 4,
"data": [
{ "grade": "93 ULP", "region": "Coastal",
"price_rands": 24.55 },
{ "grade": "93 ULP", "region": "Gauteng",
"price_rands": 25.42 },
{ "grade": "95 ULP", "region": "Coastal",
"price_rands": 24.71 },
{ "grade": "95 ULP", "region": "Gauteng",
"price_rands": 25.58 }
]
}A real call, not a mockup
The example above isn't illustrative — this is the same GET /v1/prices/current call, captured live against the production API through its interactive docs.
Coastal & Gauteng · 93 ULP & 95 ULP · effective 2026-08-05 200 OK — 4 live prices returned
From government circular to API response
Every price traces back to the same four-step pipeline, re-run every month — deterministic, not estimated.
Fetch the right document
DMPR publishes two similarly-named monthly PDFs each month; the scraper specifically targets the official "Breakdown of Prices" table, not the prose "Media Statement" press release, and finds it the day it's published.
Extract the table structurally
Structural grid extraction reads the actual table the PDF renders, not scrambled plain text — so a column order that shifts month to month doesn't break parsing.
Classify by content
Each cell is identified as a date, a cents-per-litre figure, or a region label by what it contains, not where it sits — DMPR's own layout isn't consistent month to month.
Publish instantly
Parsed prices land in the database the same run and are live over the API within minutes — current price, month-on-month change, and full history, all from the one pipeline.
Current prices, history, and the change between them
Latest DMPR-effective price for every grade and pricing zone, filterable by region and/or grade.
Cents-per-litre change between the two most recent effective dates, per grade and region — built for price-change alerts.
Full historical time series for any grade/region combination.
Every effective date the API has data for.
Compare prices between any two specific effective dates you choose.
Government-regulated, not modeled
South Africa's fuel prices aren't market-set — the Department of Mineral & Petroleum Resources (DMPR) publishes a regulated price for every fuel grade and pricing zone once a month, effective from a fixed date. There's no estimation step: the API returns exactly what DMPR published, tagged with the effective_date it came from.
Numbers are extracted directly from DMPR's own official "Breakdown of Prices" circular using structural table parsing, not OCR guesswork or manual entry — every figure traces back to a real government PDF, not a third party's summary of one.
Priced by call volume
Every plan includes all five endpoints and full historical data. A new key is emailed within seconds of checkout.
Billing via Lemon Squeezy. Prices in ZAR.