Every figure carries its certainty
On the page, in the CSV and in the APIreportedPublished by the provider for that exact period.estimatedThe provider’s own estimate, where no count or survey covers the period. The model is theirs. We never add one.derivedArithmetic on two published figures for the same country and year, such as exports minus imports. On the site’s pages these count with reported figures, since both inputs were published.indicativeAn informal-market reading. There is one: Nigeria’s street exchange rate, a median of public quotes, kept apart from the official rate and never offered as tradable.no rowNo usable record. Hatched on the map, a break in the line, a blank in the table. Never a zero.The middle column is the value of value_status the API returns with each observation. How a figure is marked is the provider’s call as we record it, not a judgement of ours.
What we do
- Keep every value attached to its year, its source and its certainty.
- Record when we retrieved it, and which release of the dataset it came from where the provider names one.
- Keep a provider’s low and high estimate beside its figure, where it publishes one.
- Say, for every indicator, how many countries reported the figure and how many were estimated.
- Break the line where the record breaks, so a missing year looks missing.
What we never do
- Estimate a value ourselves. Every modelled figure is its provider’s model, not ours.
- Interpolate between years, or extend a series past its last observation.
- Fill a gap with a zero.
- Blend sources that disagree. The one composite in the record, Nigeria’s street exchange rate, says that it is one.
Where it comes from
We take most series from international agencies, which compile them from national statistics offices, and some directly from central banks, regulators and exchanges. The record draws on 59 datasets from 48 organisations.
When more than one source publishes the same country and year, the API returns one: the source ranked first for that measure, and otherwise the one retrieved most recently. Central banks rank first for their own country’s inflation and official exchange rate, the ILO for unemployment, and the World Bank for the national accounts. The other sources stay in the record and can be requested by name with source=. Nothing is averaged.
What this data cannot tell you
Citing this
Our compilation is CC BY 4.0, free to reuse commercially. Source data keeps its provider’s licence, listed above.
Each indicator and country page gives its own citation, and the CSV from an indicator page carries the request behind it and the date you took it. Found something wrong? Tell us.