Skip to content

Start for free with the Developer football API

Activate Developer to integrate probabilities, essential markets and verified history into websites, applications and prototypes.

An API built to develop, test and backtest your models with up to 90 days of verified data.

Start for free View the documentation

Official Python SDK foresportia 0.3.0 — available on PyPI

Where to start

Start for free with Developer, integrate the API with the Python SDK, then choose the data level that fits your application or product.

Developer

Available

Free

Test the API and prototype for free

Validate authentication, core probabilities and your first server-side integration.

  • 1 selected competition
  • 7 days of verified history
  • 50 requests per day
  • 2 requests per minute
  • 30 requests per hour
View all features (+6) Show fewer features
  • 100 rows per day
  • Up to 5 matches per grouped request
  • You can replace 1 selected competition per month
  • 1 active key
  • Probabilities and essential markets
  • Preview advanced data, with selected variables reserved for Starter.
See all 56 competitions Start for free

Pro

Coming soon

49 € / month

39 € / month with annual billing About 20% off annually

468 € billed annually

Build, train, calibrate and backtest your own football AI

The upcoming Pro offer is planned to provide a long history of pre-match data and observed results for training, calibrating, comparing and backtesting more robust prediction models.

  • Everything included in Starter
  • All available competitions
  • Planned long multi-season history
  • Planned pre-match data linked to observed results
  • Planned machine-learning-ready datasets
View all features (+8) Show fewer features
  • Planned verified pre-match snapshots
  • Backtesting in the upcoming Pro offer
  • Model calibration
  • Model comparison
  • Planned dataset exports
  • Advanced data and context subject to availability
  • Planned higher grouped-request volumes
  • Professional use cases
See all 56 competitions

Developer and Starter are available. Pro is still coming soon. Custom is available on request.

Competition catalog

The catalog contains 54 club competitions, plus the 2026 World Cup and international friendlies. Developer lets you select 1 competition and replace it once per month. Starter lets you select up to 20 and replace up to 2 per month. An off-season competition remains selectable and keeps its place.

Show all 56 available competitions

Algeria

  • Algerian Ligue 1

Argentina

  • Argentine Primera Division

Australia

  • A-League Men

Austria

  • Austrian Bundesliga

Belgium

  • Belgian Pro League

Brazil

  • Brasileirão Série A

Canada

  • Canadian Premier League

Chile

  • Primera División

China

  • Chinese Super League

Croatia

  • Croatian Football League

Czech Republic

  • Czech First League

Denmark

  • Danish Superliga

Egypt

  • Egyptian Premier League

England

  • Championship
  • Premier League

Europe

  • UEFA Champions League
  • UEFA Conference League
  • UEFA Europa League

Finland

  • Veikkausliiga

France

  • Ligue 1
  • Ligue 2

Germany

  • 2. Bundesliga
  • Bundesliga

Greece

  • Super League Greece

Hungary

  • Hungarian NB I

Iceland

  • Besta deild karla

India

  • Indian Super League

International

  • FIFA World Cup 2026
  • International Friendlies

Ireland

  • League of Ireland Premier Division

Italy

  • Serie A
  • Serie B

Japan

  • J1 League

Mexico

  • Liga MX

Morocco

  • Moroccan Botola Pro

Netherlands

  • Eredivisie

Norway

  • Eliteserien

Peru

  • Liga 1

Poland

  • Ekstraklasa

Portugal

  • Liga Portugal
  • Liga Portugal 2

Romania

  • SuperLiga Romania

Russia

  • Russian Premier League

Saudi Arabia

  • Saudi Pro League

Scotland

  • Scottish Premiership

South America

  • CONMEBOL Libertadores
  • CONMEBOL Sudamericana

South Korea

  • K League 1

South-Africa

  • Premier Soccer League

Spain

  • La Liga
  • LaLiga 2

Sweden

  • Allsvenskan

Switzerland

  • Swiss Super League

Turkey

  • Süper Lig

Ukraine

  • Ukrainian Premier League

United States

  • MLS

Compare API plans

Developer and Starter are available; Pro is still coming soon.
PlanStatusCompetitionsHistoryGrouped requestDaily quotaDataPrice
DeveloperAvailable1 competition7 daysUp to 5 matches50 requests/dayAnalytics previewFree
StarterAvailableUp to 20Up to 90 daysUp to 100 matches3,000 units/dayFull Core Analytics€25 / month
ProComing soonComing soonComing soonComing soonComing soonComing soonComing soon

Structured analytics for your products and models

Integrate Foresportia outputs into a product, rank upcoming matches or compare them with your own model. Pro will extend these uses to training and backtesting.

  1. Match data
  2. Core Analytics
  3. Your product or model
  4. Prediction, ranking or analysis
The five Core Analytics variable families
FamilyPurposeContents
Form and statisticsRepresent recent team dynamicsSeason statistics, home/away splits, Last 5, Last 10 and simple streaks
ELO and standingsMeasure the relative strength of both teamsELO ratings, standings and table context
Goal forecastsModel attacking and defensive potentialExposed goal projections and forecast values
ProbabilitiesBuild, calibrate or compare a model1X2, BTTS, Over/Under 2.5, Double Chance, DNB, likely scores, confidence and entropy
Quality and warningsFilter less reliable observationsWarnings, quality indicators and current versions
 
"probabilities": {
  "one_x_two": {"home": 0.58, "draw": 0.25, "away": 0.17},
  "confidence": 0.72,
  "entropy_bits": 1.39
},
"ratings": {
  "elo_home": 1682.0,
  "elo_away": 1544.0,
  "elo_difference": 138.0,
  "elo_reliable": true
},
"forecast": {"home_goals": 1.72, "away_goals": 0.94, "total_goals": 2.66},
"quality": {"warnings": []}

Core Analytics provides structured data for integration, comparison and enrichment of existing models. Training from scratch and long history belong to the upcoming Pro offer. Explore the fields →

Integrate with Python in three lines

The official 0.3.0 SDK covers all six public data routes and handles X-API-Key authentication, ETags, quotas and typed errors. Your key stays in an environment variable.

PyPI SDK docs GitHub 

pip install foresportia

from foresportia import ForesportiaClient

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

Documentation and AI assistants

The official technical documentation is available in English. It covers all six routes, data models, quotas and errors, including LLM-readable formats.

Technical documentation OpenAPI llms.txt llms-full.txt PyPI SDK docs

Choose a prompt based on the official documentation, then open your assistant. No API key or personal data is added.

Frequently asked questions

Is live data available?

Not in the standard plans. Live probabilities can be discussed as part of a Custom offer.

Can I use these data with my own model?

Yes. Starter is intended for comparing or enriching an existing model. The upcoming Pro offer is intended for training, backtesting and calibration from a long history.

Is historical data available?

Yes. Starter provides up to 90 rolling days of verified history, with a maximum of 31 days per request. Available depth builds progressively from activation of the verified pre-match snapshot pipeline.

How do I activate Developer for free?

Use the Start for free button. After signing in to your Foresportia Account, Developer activation remains explicit and sends you to onboarding or your dashboard according to your current state.