Skip to content
datasportsAPI

No. 15 · Cue & target · Fixture sport

SnookerFrame by frame through the draw.

World Snooker Tour frames, live scores and results, with the full tournament draw.

15Cue & target
Snooker11 endpoints · fixtures

Scouting report

What you get for Snooker

Snooker follows the World Snooker Tour with frame scores, live results and the full tournament draw as a bracket: rounds, ties, both players and the fixture ids behind each tie.

Players are profiles like any other competitor, so form, head-to-head records and past results come from the shared endpoints.

First request

Every snooker match in play, one call.

The live board filtered to snooker: each match with its score, status and clock. The same request in four forms; pick yours.

  1. 1Create a key in the dashboard. Free gives you 1,000 requests a day during the beta.
  2. 2Put it in DATASPORTSAPI_API_KEY so the SDKs and the dsa command find it.
  3. 3Call /v2/livescores?sport=snooker.
curl -H "Authorization: Bearer dsa_live_…" \
  "https://api.datasportsapi.com/v2/livescores?sport=snooker"

The catalog

Snooker, endpoint by endpoint

Its own detail first, then the shared spine every fixture sport answers on. Each row opens the endpoint’s reference page.

All 116 endpoints

Where snooker goes deeper

1 endpoint with detail specific to the sport.

The shared spine

10 endpoints that behave the same for every fixture sport.

  1. GETLive scores/v2/livescoresReturns every live fixture across all sports, or a single sport’s in-play board when ?sport= is given.All plans
  2. GETFixtures by date/v2/fixturesLists the fixtures that start on a given UTC date.All plans
  3. GETFixture/v2/fixtures/{id}Everything we hold on one fixture.All plans
  4. GETEvents/v2/fixtures/{id}/eventsThe match’s incidents in chronological order, oldest first: goals, cards, substitutions, period markers and added-time announcements.All plans
  5. GETStatistics/v2/fixtures/{id}/statisticsTeam statistics for the match, organised by period and by category.All plans
  6. GETHead to head/v2/fixtures/{id}/h2hThe two teams’ head-to-head record as tallied by the source, seen from this fixture’s home / away point of view.All plans
  7. GETStandings/v2/leagues/{id}/standingsLeague tables for a single season.All plans
  8. GETTeam/v2/teams/{id}Returns a team’s profile — sport, country, venue, colours, logo, gender, whether it is a club or a national team, kind (team / individual / pair), manager and founding date (foundedOn, pres…All plans
  9. GETLeague/v2/leagues/{id}Returns a league’s profile: its tier (where it sits in the national pyramid), gender, the reigning champion with its title count, the clubs holding the most titles, the divisions directly a…All plans
  10. GETSearch/v2/searchA single search over teams (individual competitors included), players, managers, referees, leagues, fixtures, venues, racing series and races.All plans

What comes back

Cup trees, as served

The documented sample is a football knockout stage. A snooker draw has the same rounds, ties and participants.

GET/v2/leagues/{id}/cup-treesAll plans

Sample from the docs, trimmed with …

GET /v2/leagues/{id}/cup-trees
{ "data": [ { "name": "CONMEBOL Libertadores 2026, Knockout stage", "currentRound": 3, "rounds": [ …,
    { "order": 3, "name": "Semifinals", "blocks": [
      { "order": 1, "finished": true, "inProgress": false, "startTime": "2026-10-16T00:30:00.000Z",
        "matchCount": 2, "fixtureIds": [789, 790], "automaticProgression": false, "venue": null,
        "home": { "team": { "id": 11, "name": "Estudiantes de La Plata", "slug": "estudiantes-de-la-plata", "shortName": "Estudiantes", "code": "ELP", "image": "…" },
                  "seed": null, "winner": true, "score": 0, "penalties": 3, "fromBlock": 1 },
        "away": { "team": { "id": 12, "name": "Flamengo", … }, "seed": null, "winner": false, "score": 0, "penalties": 2, "fromBlock": 2 } }, … ] }, … ] } ],
  "meta": { "season": 87760, "count": 1 } }

Snooker is one query string away.

Swap ?sport=snooker for any other fixture sport and the same code keeps working. Free key, no card.