# World Bank Indicators API

> GDP, population, inflation and 29,000+ World Bank development indicators by country and year

- Vendor: `worldbankindicatorsapi` · version 1.0 · category Government Data · tags world bank api, gdp data api, population data api, country indicators api, development data api, inflation by country api, economic indicators api, wdi api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/worldbankindicatorsapi
- This document: https://apiclay.com/docs/worldbankindicatorsapi.md
- OpenAPI 3.1: https://apiclay.com/api/worldbankindicatorsapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `worldbankindicatorsapi`
- Updated: 2026-11-18

## About

## World Bank Indicators API

Time series for 29,000+ development indicators (GDP, population, inflation, poverty, CO2, internet use...) for 200+ countries and regional aggregates, from the World Bank's World Development Indicators and 70 other sources.

Data comes from **worldbank.org** (https://data.worldbank.org). Every route below calls the source's own public endpoint directly and returns the upstream response unchanged.

Typical flow: `/indicators` or `/sources` -&gt; `/data`

### Routes

#### GET `/data` - Indicator values
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| country | path | string | yes | ISO2/ISO3 code, `all`, or several joined by `;`, e.g. `IN;US`. |
| indicator | path | string | yes | Indicator id, e.g. `SP.POP.TOTL`, `NY.GDP.MKTP.CD`. |
| date | query | string | no | Year or range, e.g. `2015:2024`. |
| mrv | query | number | no | Most recent N values. |
| per_page | query | number | no | Rows per page (default 50). |
| page | query | number | no | Page number. |

Returns: `[paging, rows]`; each row has `country.value`, `countryiso3code`, `date`, `value`, `indicator.value`.

#### GET `/indicator` - Indicator metadata
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| indicator | path | string | yes | e.g. `SP.POP.TOTL`. |

Returns: `[paging, [ {id, name, unit, source, sourceNote, sourceOrganization, topics} ]]`.

#### GET `/indicators` - List indicators
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| source | query | string | no | Source id from `/sources`, e.g. `2` (WDI). |
| per_page | query | number | no | Rows per page. |
| page | query | number | no | Page number. |

#### GET `/countries` - Countries
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| region | query | string | no | Region code, e.g. `SAS`. |
| incomelevel | query | string | no | e.g. `HIC`, `LMC`. |
| per_page | query | number | no | Rows per page. |
| page | query | number | no | Page number. |

Returns: `id`, `iso2Code`, `name`, `region`, `incomeLevel`, `capitalCity`, `longitude`, `latitude`.

#### GET `/sources` - Data sources
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| per_page | query | number | no | Rows per page. |
| page | query | number | no | Page number. |

### License

World Bank data is licensed CC BY 4.0. Credit "The World Bank" when you display it.

### Caveats

- Responses are `[paging, data]` arrays, not objects.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by worldbank.org.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /data — Indicator values for a country
- Gateway: `GET https://api.apiclay.com/v1/api/worldbankindicatorsapi/data`
- Public query params: `date` (string), `mrv` (string), `per_page` (string), `page` (string), `country` (string, required), `indicator` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /indicator — Indicator metadata
- Gateway: `GET https://api.apiclay.com/v1/api/worldbankindicatorsapi/indicator`
- Public query params: `indicator` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /indicators — List indicators
- Gateway: `GET https://api.apiclay.com/v1/api/worldbankindicatorsapi/indicators`
- Public query params: `source` (string), `per_page` (string), `page` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /countries — Countries
- Gateway: `GET https://api.apiclay.com/v1/api/worldbankindicatorsapi/countries`
- Public query params: `region` (string), `incomelevel` (string), `per_page` (string), `page` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /sources — Data sources
- Gateway: `GET https://api.apiclay.com/v1/api/worldbankindicatorsapi/sources`
- Public query params: `per_page` (string), `page` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/worldbankindicatorsapi/data?country=<country>&indicator=<indicator>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
