🔒
API — платне доповнення; MCP-сервер має безкоштовні інструменти

Повна документація з прикладами нижче. Кожен виклик /v1 потребує ключа: увійди через Google, створи ключ в акаунті й почни з 10 безкоштовних балів. 1 виклик = 1 бал = 1 цент. Той самий ключ відкриває MCP-сервер, де довідкові інструменти й результати останнього тижня працюють і без ключа.

Увійти й отримати ключ
API — REST JSON v1 · лише читання

Доступ лише для читання до всієї бази — ті самі запити, що виконує сайт, у JSON. Базова адреса https://fdb4.io. Авторизація через Authorization: Bearer <key>. Кожен запит — GET; запису тут немає.

Базова адреса fdb4.io v1
Адреси API 12 усі GET
Ліміт частоти 120/хв на ключ
Формат JSON UTF-8
MCP-сервер — окрема сторінка й безкоштовні інструменти 11 інструментів · 6 безкоштовних

Та сама база для ШІ-клієнтів через Model Context Protocol за адресою https://fdb4.io/mcp. Ціни відрізняються, тому є окрема сторінка: 6 із 11 інструментів відповідають без ключа — пошук країн, турнірів і команд, поточна серія без нічиїх та результати останніх днів. Моделі нічиїх, історичний рейтинг, особисті зустрічі й давніший архів коштують по балу з того самого балансу. На /v1 безкоштовних викликів немає.

MCP-сервер і безкоштовні інструменти ›
Адреси API 12
/v1/results GET

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.
Як отримати ключ
  1. Увійти через Google — без пароля, форми й очікування.
  2. Створи ключ у своєму акаунті. Він показується лише раз, тож збережи його надійно.
  3. Надсилай його в кожному запиті як Authorization: Bearer <key> — до https://fdb4.io/v1 або https://fdb4.io/mcp.
За реєстрацію 10 бал. безкоштовно, без картки
Щомісяця +2 бал. якщо входиш
За виклик 1 бал. = 1 цент
Запрошення 10% від кожного бала

1 виклик = 1 бал = 1 цент для API та платної частини MCP-сервера. безкоштовні інструменти MCP нічого не коштують із ключем чи без нього. Бали закінчилися? Поповнити — суму обираєш ти, без пакетів і підписки. Запроси когось і отримуй 10% від усіх його нарахувань. Повернень немає: продукт — дані, а дані неможливо повернути.

Наявні ключі без прив'язки до акаунта не оплачуються до перенесення.

Помилки 3
401 Немає чинного ключа

Bearer-токен відсутній, невідомий, відкликаний або прострочений.

402 Бали закінчилися

На акаунті ключа менше одного бала. 1 виклик = 1 бал = 1 цент. Нові акаунти отримують 10 безкоштовних балів і +2 за кожен місяць із входом. Старі ключі без акаунта не оплачуються до перенесення.

{
    "error": {
        "code": "insufficient_balance",
        "balance": 0,
        "top_up_url": "https://fdb4.io/account/balance",
        "monthly_grant": 2
    }
}
429 Ліміт частоти

Перевищено похвилинний ліміт. Відповідь містить Retry-After; відхилений запит не коштує балів.