DataSportAPI
11 sports serving Sign in Get a free key
Docs
First hour
1Quick startA key, the first call and the answer2AuthenticationTwo ways to send your key, and rotating it3Plans and limitsWhat each plan reads, and the limits
How it behaves
#Ids and recordsStable ids that link every record↓PaginationPages, totals and cursors!ErrorsEvery code, and what to do about each
Freshness
◷How fresh the data isLive in seconds, results in minutes↻Caching your callsWhat changes, and what never does★ChangelogEverything added and changed, dated
Your first call in one line

The free key reads yesterday for every sport, 50 calls a day. No card.

Get a free key
Scores and schedules
●Live scoresPolling well, events in play▤FixturesWhat is coming, by date✓ResultsBy day, and back through history
Inside an event
▦Line-upsStarters, benches, formations→Periods and timelinesEvery scoring event in order⚑RacecardsRaces, runners, draws and traps
Competitions and people
≡Standings and rankingsTables and ranking lists☺Teams and playersRecords and careers⇄Head to headEvery meeting between two sides
Building with it
16One schema, many sportsCode once for every sport⚙RecipesA scoreboard, a feed, a form guide↺Historical dataBack to 1871
Football: Schedule and live
Live scores/v1/football/liveFixtures/v1/football/fixtures
Football: Results
Results/v1/football/results
Football: Events
A match/v1/football/events/{id}Line-ups/v1/football/events/{id}/lineupsPeriods and timeline/v1/football/events/{id}/periods
Football: Competitions
Competitions/v1/football/competitionsStandings/v1/football/standings
Football: Teams and players
A team/v1/football/teams/{id}A player/v1/football/players/{id}Head to head/v1/football/head-to-head
Football: Search
Search/v1/football/search
Pick a sport: the menu, examples and code follow it
Football12 endpointsHorses9 endpointsGreyhounds8 endpointsTennisconnectingCricket9 endpointsBasketball12 endpointsIce hockeyconnectingBaseballconnectingRugby12 endpointsDarts10 endpointsBoxing7 endpointsCyclingconnectingVolleyball12 endpointsHandballconnectingTable tennis10 endpointsBadminton10 endpoints
Every sport, one key

Complete reads all sixteen sports for $249 a month.

Take Complete
MCP server
◆Connect an assistantClaude, ChatGPT, Cursor, Claude Code⚙MCP toolsEvery tool and the plan it needs
For agents
SAgent skillTeaches an agent our callsMThe manualThe whole API in one file
Machine readable
{}OpenAPIGenerate a client in any languageLllms.txtThe map of these docs
Ask in plain words

"Who won at Kempton yesterday?" Your assistant picks the tool and answers from your plan.

Connect in two minutes
Showing
FootballHorsesGreyhoundsTennisCricketBasketballIce hockeyBaseballRugbyDartsBoxingCyclingVolleyballHandballTable tennisBadminton
Documentation / Subjects

Live scores, sports data API

Live scores

Every match in play now, in one call per sport, refreshed every few seconds.

Live answers list each event in play with its score, its clock or current period, and both sides with their ids. Follow the id to the event, its line-ups or its timeline for more. Live comes with the sport plan; the free key reads yesterday instead.

GET/v1/football/live

How often to ask

A live answer is kept for 10 seconds. Asking more often returns the same copy, marked "cached": true with its age_seconds, and still counts as a call. Every 10 to 15 seconds is right for a scoreboard; every minute for a list of what is on.

Sports with live scores

Football, cricket (ball by ball), basketball, rugby, darts, volleyball, table tennis and badminton answer /live. Racing answers /cards/today through the day, and boxing /fights/upcoming.

An empty list

An empty data with count 0 means nothing is in play right now. It is not an error.

Try it

Football: Live scores, with your key.

GET

  
200 OK1896 ms0 rows shownReal answer from 2026-11-03, trimmed
{
    "data": [],
    "meta": {
        "sport": "football",
        "endpoint": "/live",
        "count": 0,
        "page": 1,
        "per_page": 100,
        "total": 0,
        "total_pages": 1,
        "next_cursor": null,
        "next_page": null,
        "prev_page": null,
        "as_of": "2026-11-02T05:16:53Z",
        "cached": false,
        "age_seconds": 0
    }
}
No key yet? Get a free key: it reads yesterday for every sport and is filled in here once made.


The endpoints
Every sport that answers it.
GET /v1/football/liveFootball: Every match in play now, with the score and the clockOpen page ›GET /v1/cricket/liveCricket: Matches in play, ball by ballOpen page ›GET /v1/basketball/liveBasketball: Every game in play now, with the score and the clockOpen page ›GET /v1/rugby/liveRugby: Every match in play now, with the score and the clockOpen page ›GET /v1/darts/liveDarts: Every match in play now, leg by legOpen page ›GET /v1/volleyball/liveVolleyball: Every match in play now, with the score and the clockOpen page ›GET /v1/table-tennis/liveTable tennis: Every match in play now, game by gameOpen page ›GET /v1/badminton/liveBadminton: Every match in play now, game by gameOpen page ›GET /v1/football/events/{id}Football: One match in full: both sides, the score, the venue and the officialsOpen page ›GET /v1/basketball/events/{id}Basketball: One game in full: both sides, the score, the venue and the officialsOpen page ›GET /v1/rugby/events/{id}Rugby: One match in full: both sides, the score, the venue and the officialsOpen page ›GET /v1/volleyball/events/{id}Volleyball: One match in full: both sides, the score, the venue and the officialsOpen page ›GET /v1/football/events/{id}/periodsFootball: The score by half, and every scoring event in orderOpen page ›GET /v1/basketball/events/{id}/periodsBasketball: The score by quarter, and every scoring event in orderOpen page ›GET /v1/rugby/events/{id}/periodsRugby: The score by half, and every scoring event in orderOpen page ›GET /v1/volleyball/events/{id}/periodsVolleyball: The score by set, and every scoring event in orderOpen page ›
PreviousErrorsNextFixtures