API и встраиваемые виджеты для доступа к экономическим данным 179 стран. Для использования нужен бесплатный токен.
Зарегистрируйтесь по email — токен выдаётся мгновенно и бесплатно. Тариф Free: 1000 запросов в день.
Виджет — это компактный блок с данными страны, который вставляется на ваш сайт через <iframe>. Передайте токен в параметре token.
<iframe
src="https://world-economy.pages.dev/widget/?c=us&token=ВАШ_ТОКЕН&metrics=gdp,inflation,debt"
width="360" height="240" frameborder="0">
</iframe>| Параметр | Описание | Пример |
|---|---|---|
c | Код страны (ISO 3166-1 alpha-2) | us, de, ru |
token | Ваш токен (обязательно) | we_a1b2... |
metrics | Показатели через запятую | gdp,inflation,debt,index |
theme | Тема оформления | light / dark |
Прямой доступ к данным в формате JSON. Токен передаётся в заголовке X-API-Token или в параметре ?token=.
https://worldbank-proxy.fnemoy.workers.dev| Метод | Путь | Токен | Описание |
|---|---|---|---|
| GET | /data/:iso | да | Данные страны |
| GET | /widget-data?c=:iso | да | Данные для виджета |
| GET | /verify?token=:t | — | Проверить токен |
| GET | /fx?base=USD | нет | Курсы валют |
| GET | /api/v2/country/... | нет | Прокси World Bank |
const res = await fetch(
'https://worldbank-proxy.fnemoy.workers.dev/data/us',
{ headers: { 'X-API-Token': 'ВАШ_ТОКЕН' } }
);
const data = await res.json();
console.log(data);curl -H "X-API-Token: ВАШ_ТОКЕН" \
https://worldbank-proxy.fnemoy.workers.dev/data/deОтвет появится здесь…
| Код | Значение |
|---|---|
401 no_token | Токен не передан |
401 invalid_token | Токен не найден в базе |
401 rate_limit_exceeded | Превышен дневной лимит (1000/день для Free) |
400 invalid_email | Некорректный email при регистрации |