Football fixtures API in Python

A short, working walkthrough: get an API key, request upcoming football fixtures, filter by date and league, and read the prediction for a match. About five minutes.

1. Get an API key

Start a 14-day trial (no card needed). Your key appears straight after signup and on your dashboard.

2. Fetch fixtures

Send the key in the Authorization: Token header. Filter with status, date_from, date_to and league_id.

import requests

API = "https://api.predictiqpro.com"
HEADERS = {"Authorization": "Token YOUR_API_KEY"}

params = {
    "status": "NS",              # not started
    "date_from": "2026-10-12",
    "date_to": "2026-10-19",
    # "league_id": 39,           # optional
}
r = requests.get(f"{API}/fixtures", headers=HEADERS, params=params, timeout=15)
r.raise_for_status()

for f in r.json()["results"]:
    print(f["kickoff_time"], f["home_team"], "vs", f["away_team"])

3. Read predictions and respect limits

Every response carries rate-limit headers (X-RateLimit-Remaining-Daily, X-RateLimit-Remaining-Monthly), so you can back off before you hit a 429.

r = requests.get(f"{API}/fixtures", headers=HEADERS, params=params, timeout=15)
print(r.headers.get("X-RateLimit-Remaining-Daily"))
print(r.headers.get("X-RateLimit-Remaining-Monthly"))
if r.status_code == 429:
    print("Quota reached - back off or upgrade")