Повна документація з прикладами нижче. Кожен виклик /v1 потребує ключа: увійди через Google, створи ключ в акаунті й почни з 10 безкоштовних балів. 1 виклик = 1 бал = 1 цент. Той самий ключ відкриває MCP-сервер, де довідкові інструменти й результати останнього тижня працюють і без ключа.
Доступ лише для читання до всієї бази — ті самі запити, що виконує сайт, у JSON. Базова адреса https://fdb4.io. Авторизація через Authorization: Bearer <key>. Кожен запит — GET; запису тут немає.
Та сама база для ШІ-клієнтів через Model Context Protocol за адресою https://fdb4.io/mcp. Ціни відрізняються, тому є окрема сторінка: 6 із 11 інструментів відповідають без ключа — пошук країн, турнірів і команд, поточна серія без нічиїх та результати останніх днів. Моделі нічиїх, історичний рейтинг, особисті зустрічі й давніший архів коштують по балу з того самого балансу. На /v1 безкоштовних викликів немає.
Played matches, newest first, paginated. Same filter names as the results browser. score is the ninety-minute score; a played draw can have null scores when ninety_score_unknown is true. score_120 gives the score after extra time when available.
curl -sS "https://fdb4.io/v1/results?team_id=431&outcome=D&from=2020-01-01" \ -H "Authorization: Bearer $FDB_API_KEY" \ -H "Accept: application/json"
Приклад структури — кілька рядків, не поточні дані.
{
"data": [
{
"id": 91244,
"date": "2026-04-12",
"status": "PLAYED",
"competition": {
"id": 12,
"name": "Premier League",
"edition_id": 208,
"edition": "2025/26",
"year": 2025
},
"home_team": {
"id": 431,
"slug": "arsenal",
"name": "Arsenal"
},
"away_team": {
"id": 447,
"slug": "chelsea",
"name": "Chelsea"
},
"score": {
"home": 1,
"away": 1
},
"ninety_score_unknown": false,
"score_120": {
"home": null,
"away": null
},
"result": "D",
"is_draw": true
}
],
"meta": {
"current_page": 1,
"per_page": 100,
"total": 3421,
"last_page": 35
}
}
| Назва | Тип | Опис |
|---|---|---|
| type | string | national_team or club. |
| competition_id | integer | Restrict to one competition. |
| competition_item_id | integer | Restrict to one edition/season. |
| team_id | integer | Matches involving this team, home or away. |
| outcome | string | H (home win), A (away win) or D (draw). |
| from | date | Earliest match date, inclusive (YYYY-MM-DD). |
| to | date | Latest match date, inclusive (YYYY-MM-DD). |
| limit | integer | Page size: 50, 100, 250 or 500. Default 100. |
| page | integer | Page number. Default 1. |
- Увійти через Google — без пароля, форми й очікування.
- Створи ключ у своєму акаунті. Він показується лише раз, тож збережи його надійно.
- Надсилай його в кожному запиті як
Authorization: Bearer <key>— доhttps://fdb4.io/v1абоhttps://fdb4.io/mcp.
1 виклик = 1 бал = 1 цент для API та платної частини MCP-сервера. безкоштовні інструменти MCP нічого не коштують із ключем чи без нього. Бали закінчилися? Поповнити — суму обираєш ти, без пакетів і підписки. Запроси когось і отримуй 10% від усіх його нарахувань. Повернень немає: продукт — дані, а дані неможливо повернути.
Наявні ключі без прив'язки до акаунта не оплачуються до перенесення.
Bearer-токен відсутній, невідомий, відкликаний або прострочений.
На акаунті ключа менше одного бала. 1 виклик = 1 бал = 1 цент. Нові акаунти отримують 10 безкоштовних балів і +2 за кожен місяць із входом. Старі ключі без акаунта не оплачуються до перенесення.
{
"error": {
"code": "insufficient_balance",
"balance": 0,
"top_up_url": "https://fdb4.io/account/balance",
"monthly_grant": 2
}
}
Перевищено похвилинний ліміт. Відповідь містить Retry-After; відхилений запит не коштує балів.