GoalSoon API

GoalSoon — Football Predictions API

Model-based win probabilities, Expected Points tables and full pre-joined match previews for 99 leagues — data others make you assemble from four APIs, served in a single call.

Get it on RapidAPI →

Why GoalSoon

Predictions, not raw data

1X2, Over-2.5 & BTTS win probabilities from a calibrated Poisson + xG model — numbers you can't scrape anywhere else.

One-call match previews

/matchup returns prediction + both teams' stats, form, lineups, coach, H2H, league context & weather in a single request.

99 leagues covered

Model calibration across 99 leagues worldwide — from MLS to Serie B and beyond.

Expected Points tables

See who's overperforming or getting unlucky with per-team xPts and a luck index — the "deserved table".

Endpoints

GET /v1/fixturesBasic

Upcoming fixtures across all leagues, or filter by league. Your discovery starting point for league & team IDs.

GET /v1/predictionsUltra+

Model 1X2 + Over-2.5 + BTTS probabilities for a league's upcoming fixtures. Query: league (e.g. 3273 = MLS).

[{
  "fixture_id": 2026071615860, "league": "MLS", "season": 2025,
  "kickoff_utc": "2026-07-16 23:30",
  "home": "CF Montreal", "away": "Toronto FC",
  "prob_home": 0.507, "prob_draw": 0.251, "prob_away": 0.242,
  "prob_over_2_5": 0.484, "prob_btts": 0.508,
  "xg_home": 1.59, "xg_away": 1.02, "model": "poisson-xg-blend"
}]
GET /v1/xpts/{league_id}Pro+

Expected Points table — actual vs deserved points, per-team luck index, xG for/against. Query: season (optional).

GET /v1/standings/{league_id}Pro+

Current league table with recent form string.

GET /v1/matchup/{fixture_id}Mega

The full picture for one match in a single call: model prediction, both teams' in-league stats, form, home/away split, scoring minutes, key players' form, probable lineup + coach, head-to-head history, league context and weather.

GET /v1/round/{league_id}Mega

A league's entire upcoming round — every fixture as a full matchup object. Built for "publish the whole matchday" workflows. Query: limit (default 20).

Plans

PlanPriceQuotaAccess
BasicFree100 req/dayfixtures
Pro$5/mo10,000 req/mo+ xpts, standings
Ultra$7/mo20,000 req/mo+ predictions
Mega$10/mo30,000 req/mo+ matchup, round

Notes

Freshness: stats, xG, form, standings and scorers update daily; lineups & coaches populate ~1h before kickoff.
Leagues: 99 leagues have model calibration — use /v1/fixtures to discover IDs (MLS = 3273).
Model: a Poisson goals model with attack/defence ratings, xG blending and calibration — the engine behind GoalSoon's live product.
Injuries/suspensions: injuries appear in matchup.absences when available (partial); suspensions not yet included.