Foresportia Starter API

Published pre-match football predictions and complete Core Analytics for server-side integrations. Six authenticated endpoints, one JSON contract, one official Python SDK.

Quickstart

Every route is authenticated with the X-API-Key header over HTTPS, and returns JSON.

curl -sS https://api.foresportia.com/v1/matches/today \
  -H "X-API-Key: $FORESPORTIA_API_KEY"

With the official Python SDK (version 0.3.0):

pip install foresportia

from foresportia import ForesportiaClient

with ForesportiaClient.from_env() as client:
    response = client.list_leagues()
    print(response.data)

Full quickstart · Python SDK

I want to…

Test the API
Get a free Developer key and make your first authenticated call.
Quickstart →
Follow a full tutorial
Build a football dashboard end to end: upcoming matches, markets, and verified history.
Football dashboard tutorial →
Use analytics with your model
Integrate Core Analytics, compare outputs, or enrich an existing model.
Use Core Analytics with your model →
Fetch many matches at once
One bulk call returns up to 100 matches and costs 10 units.
Bulk and units →
Understand the quotas
Requests, units, rows, and concurrency are aggregated per client.
Quotas →
Handle errors
Business codes, HTTP statuses, and what to retry.
Errors →

The six Starter endpoints

These six routes are the authoritative Starter scope. Health, account, dashboard, administrative, and internal routes are intentionally outside this reference.

GET/v1/leaguesReturns only the selectable competitions in the authenticated Starter client's persistent selection.
GET/v1/leagues/{code}/matchesReturns upcoming, verified historical, or combined match summaries for one selected competition.
GET/v1/matches/{match_id}Returns the complete Core Analytics payload for one published and usable future match in a selected competition.
GET/v1/matches/todayReturns future match summaries for today in Europe/Paris, filtered to selected competitions.
GET/v1/picks/todayReturns the highest-ranked current picks for today, filtered to selected competitions.
POST/v1/matches/bulkReturns complete Core Analytics payloads for up to 100 IDs.

Reference and machine-readable sources

OpenAPI schema — global to the service; it can contain non-Starter routes.
llms.txt — short index for LLM agents.
llms-full.txt — the whole documentation in one file.
Python SDK on PyPI · SDK documentation · source

Availability: Starter is available for purchase now. Starter includes up to 90 rolling days of verified pre-match history, building progressively from pipeline activation. Each request covers at most 31 days. Probabilities are analytical estimates, not guarantees of outcomes or financial returns.