Foresportia Python SDK

Python SDK for the Foresportia API, a private beta football analytics API that provides match data, model probabilities, predicted picks, and confidence signals.

Foresportia returns probabilistic forecasts and analytics. It does not provide betting advice, bookmaker odds, or guaranteed outcomes, and it is not a live score feed.

Private beta

The SDK and the Foresportia API are currently in private beta. Endpoints, response fields, limits, and model outputs may change before a stable release.

Official links

• Foresportia website (FR version, ES version)
• Foresportia API overview
• API dashboard
• PyPI package
• GitHub repository

Quick install

pip install foresportia

Quick start

from foresportia import ForesportiaClient

with ForesportiaClient.from_env() as client:
    account = client.me()
    picks = client.picks_today()

print(account.get("plan"))
print(f"Matches returned: {len(picks.get('matches', []))}")

Documentation

• Getting Started — install, configure your key, and make a first request.
• Authentication — how API keys are handled.
• Examples — runnable scripts.
• Response Fields — what API responses may contain.
• Beta Limitations — current beta constraints.