SofaSport API

Appearance

SofaScore Sport API - Complete Tutorial ​

Table of Contents ​

  1. Introduction
  2. Getting Started
  3. Authentication
  4. API Reference
  5. Common Workflows
  6. Response Examples

Introduction ​

Sport API provides comprehensive sports data, from simple live scores to deep statistics and detailed player analysis. The API covers 20+ sports, more than 5000 leagues, tournaments and special events.

Supported Sports ​

Football (Soccer), Tennis, Basketball, Ice Hockey, Handball, Volleyball, Table Tennis, Baseball, American Football, MMA, Motorsport, Cricket, Rugby, Darts, Snooker, Futsal, Badminton, Aussie Rules, Beach Volleyball, Waterpolo, Cycling, Floorball, Bandy, Esports.

Data Similar To ​

  • Opta Sports (statsperform.com)
  • SofaScore.com
  • AIScore.com

Support ​

Getting Started ​

Connect to API and Get API key ​

Base URL ​

https://sofasport.p.rapidapi.com

or

https://sofascores-api.hgapi.top

API Reference ​

Sports ​

GET Sport List ​

Get a list of all available sports.

MethodEndpoint
GET/v1/sports

Response:

json
{
  "data": [
    {"name": "Football", "slug": "football", "id": 1},
    {"name": "Basketball", "slug": "basketball", "id": 2},
    {"name": "Ice Hockey", "slug": "ice-hockey", "id": 4},
    {"name": "Tennis", "slug": "tennis", "id": 5}
    // ... more sports
  ]
}

GET Number of Live Events ​

Get the number of live events across all sports.

MethodEndpoint
GET/v1/sports/number-live

Parameters: None

Categories ​

GET Categories List ​

Get a list of categories (countries/regions) by sport.

MethodEndpoint
GET/v1/categories
ParameterTypeRequiredDescriptionExample
sport_idintegerYesSport ID1

GET Categories Number Live ​

Get the number of live events in each category by sport.

MethodEndpoint
GET/v1/categories/number-live
ParameterTypeRequiredDescriptionExample
sport_idintegerYesSport ID1

Calendar ​

GET Actual Categories ​

Get actual categories by date and sport (categories with events on a specific date).

MethodEndpoint
GET/v1/calendar/categories
ParameterTypeRequiredDescriptionExample
sport_idintegerYesSport ID1
datestringYesDate (YYYY-MM-DD)2022-05-06
timezoneintegerYesTimezone offset (-11 to 13)6

GET Daily Unique Tournaments ​

Get daily unique tournaments by month and sport.

MethodEndpoint
GET/v1/calendar/daily-unique-tournaments
ParameterTypeRequiredDescriptionExample
sport_idintegerYesSport ID1
monthstringYesMonth (YYYY-MM)2022-05
timezoneintegerYesTimezone offset (-11 to 13)6

Tournaments ​

GET Unique Tournaments List ​

Get a list of unique tournaments by category.

MethodEndpoint
GET/v1/unique-tournaments
ParameterTypeRequiredDescriptionExample
category_idintegerYesCategory ID20

GET Unique Tournaments Top ​

Get top tournaments list.

MethodEndpoint
GET/v1/unique-tournaments-top
ParameterTypeRequiredDescriptionExample
localestringYesLocale codeen

GET Unique Tournament Data ​

Get detailed data about a unique tournament.

MethodEndpoint
GET/v1/unique-tournaments/data
ParameterTypeRequiredDescriptionExample
unique_tournament_idintegerYesUnique Tournament ID17

GET Unique Tournament Seasons ​

Get all seasons of a unique tournament.

MethodEndpoint
GET/v1/unique-tournaments/seasons
ParameterTypeRequiredDescriptionExample
unique_tournament_idintegerYesUnique Tournament ID17

Get featured events of a unique tournament.

MethodEndpoint
GET/v1/unique-tournaments/featured-events
ParameterTypeRequiredDescriptionExample
unique_tournament_idintegerYesUnique Tournament ID17

GET Unique Tournament Media ​

Get media content of a unique tournament.

MethodEndpoint
GET/v1/unique-tournaments/media
ParameterTypeRequiredDescriptionExample
unique_tournament_idintegerYesUnique Tournament ID17

Get tournament logo.

MethodEndpoint
GET/v1/unique-tournaments/logo
ParameterTypeRequiredDescriptionExample
unique_tournament_idintegerYesUnique Tournament ID17
sport_idintegerNoSport ID1

GET Tournament Data ​

Get tournament data by tournament ID.

MethodEndpoint
GET/v1/tournaments/data
ParameterTypeRequiredDescriptionExample
tournament_idintegerYesTournament ID1

GET Tournament Seasons ​

Get seasons of a tournament.

MethodEndpoint
GET/v1/tournaments/seasons
ParameterTypeRequiredDescriptionExample
tournament_idintegerYesTournament ID1

GET Tournament Events ​

Get events of a tournament.

MethodEndpoint
GET/v1/tournaments/events
ParameterTypeRequiredDescriptionExample
tournament_idintegerYesTournament ID95741
pageintegerYesPage number (0-indexed)0
course_eventsstringYesEvent course typelast

Seasons ​

GET Season Data ​

Get detailed data about a season.

MethodEndpoint
GET/v1/seasons/data
ParameterTypeRequiredDescriptionExample
unique_tournament_idintegerYesUnique Tournament ID17
seasons_idintegerYesSeason ID37036

GET Season Details ​

Get season statistics summary (goals, wins, etc.).

MethodEndpoint
GET/v1/seasons/details
ParameterTypeRequiredDescriptionExample
unique_tournament_idintegerYesUnique Tournament ID17
seasons_idintegerYesSeason ID37036

GET Season Standings ​

Get league standings/table.

MethodEndpoint
GET/v1/seasons/standings
ParameterTypeRequiredDescriptionExample
seasons_idintegerYesSeason ID37036
unique_tournament_idintegerNoUnique Tournament ID17
tournament_idintegerNoTournament ID-
standing_typestringYesType of standingstotal

Standing Types: total, home, away

GET Season Cup Trees ​

Get cup/knockout tournament bracket.

MethodEndpoint
GET/v1/seasons/cup-trees
ParameterTypeRequiredDescriptionExample
unique_tournament_idintegerYesUnique Tournament ID7
seasons_idintegerYesSeason ID36886

GET Season Rounds ​

Get all rounds of a season.

MethodEndpoint
GET/v1/seasons/rounds
ParameterTypeRequiredDescriptionExample
unique_tournament_idintegerYesUnique Tournament ID7
seasons_idintegerYesSeason ID52561

GET Season Events ​

Get all events of a season.

MethodEndpoint
GET/v1/seasons/events
ParameterTypeRequiredDescriptionExample
unique_tournament_idintegerYesUnique Tournament ID17
seasons_idintegerYesSeason ID37036
pageintegerYesPage number (0-indexed)0
course_eventsstringYesEvent course typelast

GET Season Team Events ​

Get team events of a season.

MethodEndpoint
GET/v1/seasons/team-events
ParameterTypeRequiredDescriptionExample
unique_tournament_idintegerYesUnique Tournament ID17
seasons_idintegerYesSeason ID37036

GET Season Players Statistics ​

Get player statistics for a season.

MethodEndpoint
GET/v1/seasons/players-statistics/result
ParameterTypeRequiredDescriptionExample
unique_tournament_idintegerYesUnique Tournament ID17
seasons_idintegerYesSeason ID37036
seasons_statistics_typestringYesStatistics typeoverall

Statistics Types: overall, home, away

GET Season Teams Statistics ​

Get team statistics for a season.

MethodEndpoint
GET/v1/seasons/teams-statistics/result
ParameterTypeRequiredDescriptionExample
unique_tournament_idintegerYesUnique Tournament ID17
seasons_idintegerYesSeason ID37036
seasons_statistics_typestringYesStatistics typeoverall

GET Season Team Week Rounds ​

Get team of the week rounds.

MethodEndpoint
GET/v1/seasons/team-week/rounds
ParameterTypeRequiredDescriptionExample
unique_tournament_idintegerYesUnique Tournament ID17
seasons_idintegerYesSeason ID37036

GET Season Team Week Players ​

Get team of the week players for a specific round.

MethodEndpoint
GET/v1/seasons/team-week/result
ParameterTypeRequiredDescriptionExample
unique_tournament_idintegerYesUnique Tournament ID17
seasons_idintegerYesSeason ID37036
round_idintegerYesRound ID7177

Events ​

GET Event Data ​

Get complete event/match data.

MethodEndpoint
GET/v1/events/data
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID11930405

GET Schedule by Category ​

Get event schedule by category and date.

MethodEndpoint
GET/v1/events/schedule/category
ParameterTypeRequiredDescriptionExample
category_idintegerYesCategory ID26
datestringYesDate (YYYY-MM-DD)2022-05-11

GET Schedule by Date ​

Get event schedule by sport and date (±12 hours for all timezones).

MethodEndpoint
GET/v1/events/schedule/date
ParameterTypeRequiredDescriptionExample
sport_idintegerYesSport ID1
datestringYesDate (YYYY-MM-DD)2024-02-29
inversebooleanNoInverse orderfalse

Note: This endpoint is deprecated. Use Schedule by Category instead.

GET Live Schedule ​

Get all live events by sport.

MethodEndpoint
GET/v1/events/schedule/live
ParameterTypeRequiredDescriptionExample
sport_idintegerYesSport ID1

Get today's popular events.

MethodEndpoint
GET/v1/events/schedule/popular
ParameterTypeRequiredDescriptionExample
localestringYesLocale codeen

GET Event Statistics ​

Get match statistics.

MethodEndpoint
GET/v1/events/statistics
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID11930405

GET Event Lineups ​

Get team lineups.

MethodEndpoint
GET/v1/events/lineups
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID11930405

GET Event Incidents ​

Get match incidents (goals, cards, substitutions).

MethodEndpoint
GET/v1/events/incidents
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID11930405

GET Event H2H Stats ​

Get head-to-head statistics.

MethodEndpoint
GET/v1/events/h2h-stats
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID10253769

GET Event H2H Events ​

Get head-to-head events history.

MethodEndpoint
GET/v1/events/h2h-events
ParameterTypeRequiredDescriptionExample
event_idintegerNoEvent ID11930405
custom_event_idstringNoCustom Event IDpcWcsWDfd

GET Event Heatmap ​

Get team heatmap during the match.

MethodEndpoint
GET/v1/events/heatmap
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID10253769
team_idintegerYesTeam ID2819

GET Event Player Heatmap ​

Get individual player heatmap.

MethodEndpoint
GET/v1/events/player-heatmap
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID10023294
player_idintegerYesPlayer ID839410

GET Event Player Statistics ​

Get individual player statistics.

MethodEndpoint
GET/v1/events/player-statistics
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID10023294
player_idintegerYesPlayer ID839410

GET Event Best Players ​

Get best players of the match.

MethodEndpoint
GET/v1/events/best-players
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID10253769

GET Event Form ​

Get pregame team form.

MethodEndpoint
GET/v1/events/form
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID10236820

GET Event Streaks ​

Get team streaks.

MethodEndpoint
GET/v1/events/streaks
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID9576298

GET Event Predict ​

Get match prediction.

MethodEndpoint
GET/v1/events/predict
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID10253769

GET Event Media ​

Get media content (videos, highlights).

MethodEndpoint
GET/v1/events/media
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID10253769

GET Event Tweets ​

Get related tweets.

MethodEndpoint
GET/v1/events/tweets
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID10253769

GET Event Comments ​

Get user comments.

MethodEndpoint
GET/v1/events/comments
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID10230638

GET Event Graph Points ​

Get graph points data.

MethodEndpoint
GET/v1/events/graph-points
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID10253769

GET Event Shotmap ​

Get shotmap data.

MethodEndpoint
GET/v1/events/shotmap
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID10230638

GET Event Fan Rating ​

Get fan ratings.

MethodEndpoint
GET/v1/events/fan-rating
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID10253769

GET Event Managers ​

Get team managers.

MethodEndpoint
GET/v1/events/managers
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID10236820

GET Event Odds All ​

Get all betting odds.

MethodEndpoint
GET/v1/events/odds/all
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID11930405
odds_formatstringYesOdds formatdecimal
provider_idintegerNoProvider ID (1 = Bet365)1

GET Event Odds Winning ​

Get winning odds.

MethodEndpoint
GET/v1/events/odds/winning
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID10253769
odds_formatstringYesOdds formatdecimal
provider_idintegerNoProvider ID1

GET Event Point by Point ​

Get point-by-point data (tennis).

MethodEndpoint
GET/v1/events/point-by-point
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID10290654

GET Event Innings ​

Get innings data (cricket).

MethodEndpoint
GET/v1/events/innings
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID10188874

GET Event Sub Events ​

Get sub events.

MethodEndpoint
GET/v1/events/sub-events
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID10277254

GET Newly Added Events ​

Get newly added events.

MethodEndpoint
GET/v1/events/newly-added-events

Parameters: None

Esports Events ​

GET Esports Statistics ​

Get esports match statistics.

MethodEndpoint
GET/v1/events/esports-statistics
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID10289011

GET Esports Lineups ​

Get esports lineups.

MethodEndpoint
GET/v1/events/esports-lineups
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID10289011

GET Esports Bans ​

Get esports bans.

MethodEndpoint
GET/v1/events/esports-bans
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID10289011

GET Esports Games ​

Get esports games.

MethodEndpoint
GET/v1/events/esports-games
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID10289011

GET Esports Rounds ​

Get esports rounds.

MethodEndpoint
GET/v1/events/esports-rounds
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID323668

Teams ​

GET Team Data ​

Get team information.

MethodEndpoint
GET/v1/teams/data
ParameterTypeRequiredDescriptionExample
team_idintegerYesTeam ID44

GET Team Players ​

Get team roster.

MethodEndpoint
GET/v1/teams/players
ParameterTypeRequiredDescriptionExample
team_idintegerYesTeam ID44

GET Team Events ​

Get team's match history.

MethodEndpoint
GET/v1/teams/events
ParameterTypeRequiredDescriptionExample
team_idintegerYesTeam ID2817
pageintegerYesPage number (0-indexed)0
course_eventsstringYesEvent course typelast

GET Team Near Events ​

Get team's upcoming/recent events.

MethodEndpoint
GET/v1/teams/near-events
ParameterTypeRequiredDescriptionExample
team_idintegerYesTeam ID2817

GET Team Current Tournaments ​

Get team's current tournaments.

MethodEndpoint
GET/v1/teams/current-tournaments
ParameterTypeRequiredDescriptionExample
team_idintegerYesTeam ID2817

GET Team Recent Form ​

Get team's recent form.

MethodEndpoint
GET/v1/teams/recent-form
ParameterTypeRequiredDescriptionExample
team_idintegerYesTeam ID2817

GET Team Rankings ​

Get team rankings.

MethodEndpoint
GET/v1/teams/rankings
ParameterTypeRequiredDescriptionExample
team_idintegerYesTeam ID2817

Get team logo.

MethodEndpoint
GET/v1/teams/logo
ParameterTypeRequiredDescriptionExample
team_idintegerYesTeam ID44
sport_idintegerNoSport ID1

GET Team Transfers ​

Get team transfers.

MethodEndpoint
GET/v1/teams/transfers
ParameterTypeRequiredDescriptionExample
team_idintegerYesTeam ID2817

GET Team News Feed ​

Get team news feed.

MethodEndpoint
GET/v1/teams/news-feed
ParameterTypeRequiredDescriptionExample
team_idintegerYesTeam ID44

GET Team Statistics Seasons ​

Get available seasons for team statistics.

MethodEndpoint
GET/v1/teams/statistics/seasons
ParameterTypeRequiredDescriptionExample
team_idintegerYesTeam ID44

GET Team Statistics Result ​

Get team statistics.

MethodEndpoint
GET/v1/teams/statistics/result
ParameterTypeRequiredDescriptionExample
team_idintegerYesTeam ID44
unique_tournament_idintegerYesUnique Tournament ID17
season_idintegerYesSeason ID37036
team_stat_typestringNoStatistics typeoverall

GET Team Player Statistics Seasons ​

Get available seasons for player statistics.

MethodEndpoint
GET/v1/teams/player-statistics/seasons
ParameterTypeRequiredDescriptionExample
team_idintegerYesTeam ID44

GET Team Player Statistics Result ​

Get player statistics by team.

MethodEndpoint
GET/v1/teams/player-statistics/result
ParameterTypeRequiredDescriptionExample
team_idintegerYesTeam ID44
unique_tournament_idintegerYesUnique Tournament ID17
season_idintegerYesSeason ID37036
player_stat_typestringNoStatistics typeoverall

GET Team Standings Seasons ​

Get seasons for standings.

MethodEndpoint
GET/v1/teams/standings/seasons
ParameterTypeRequiredDescriptionExample
team_idintegerYesTeam ID44

GET Team Recent Unique Tournaments ​

Get recent unique tournaments.

MethodEndpoint
GET/v1/teams/recent-unique-tournaments
ParameterTypeRequiredDescriptionExample
team_idintegerYesTeam ID14486

Players ​

GET Player Data ​

Get player information.

MethodEndpoint
GET/v1/players/data
ParameterTypeRequiredDescriptionExample
player_idintegerYesPlayer ID12994

GET Player Photo ​

Get player photo.

MethodEndpoint
GET/v1/players/photo
ParameterTypeRequiredDescriptionExample
player_idintegerYesPlayer ID12994

GET Player Characteristics ​

Get player characteristics.

MethodEndpoint
GET/v1/players/characteristics
ParameterTypeRequiredDescriptionExample
player_idintegerYesPlayer ID12994

GET Player Attribute Overviews ​

Get player attribute overviews.

MethodEndpoint
GET/v1/players/attribute-overviews
ParameterTypeRequiredDescriptionExample
player_idintegerYesPlayer ID12994

GET Player Events ​

Get player's match history.

MethodEndpoint
GET/v1/players/events
ParameterTypeRequiredDescriptionExample
player_idintegerYesPlayer ID12994
pageintegerYesPage number (0-indexed)0
course_eventsstringYesEvent course typelast

GET Player Statistics Seasons ​

Get available seasons for player statistics.

MethodEndpoint
GET/v1/players/statistics/seasons
ParameterTypeRequiredDescriptionExample
player_idintegerYesPlayer ID12994

GET Player Statistics Result ​

Get player statistics.

MethodEndpoint
GET/v1/players/statistics/result
ParameterTypeRequiredDescriptionExample
player_idintegerYesPlayer ID12994
unique_tournament_idintegerYesUnique Tournament ID34
seasons_idintegerYesSeason ID37167
player_stat_typestringYesStatistics typeoverall

Note: Use regularSeason for hockey statistics.

GET Player Heatmap ​

Get player's heatmap for a season.

MethodEndpoint
GET/v1/players/heatmap
ParameterTypeRequiredDescriptionExample
player_idintegerYesPlayer ID12994
unique_tournament_idintegerYesUnique Tournament ID34
seasons_idintegerYesSeason ID37167

GET Player Last Ratings ​

Get player's latest ratings.

MethodEndpoint
GET/v1/players/last-ratings
ParameterTypeRequiredDescriptionExample
player_idintegerYesPlayer ID12994
unique_tournament_idintegerYesUnique Tournament ID34
seasons_idintegerYesSeason ID37167

GET Player Transfer History ​

Get player's transfer history.

MethodEndpoint
GET/v1/players/transfer-history
ParameterTypeRequiredDescriptionExample
player_idintegerYesPlayer ID12994

GET Player National Team Statistics ​

Get player's national team statistics.

MethodEndpoint
GET/v1/players/national-team-statistics
ParameterTypeRequiredDescriptionExample
player_idintegerYesPlayer ID12994

GET Player Last Year Summary ​

Get player's last year summary.

MethodEndpoint
GET/v1/players/last-year-summary
ParameterTypeRequiredDescriptionExample
player_idintegerYesPlayer ID12994

Managers ​

GET Manager Data ​

Get manager information.

MethodEndpoint
GET/v1/managers/data
ParameterTypeRequiredDescriptionExample
manager_idintegerYesManager ID52829

GET Manager Photo ​

Get manager photo.

MethodEndpoint
GET/v1/managers/photo
ParameterTypeRequiredDescriptionExample
manager_idintegerYesManager ID52829

GET Manager Career History ​

Get manager's career history.

MethodEndpoint
GET/v1/managers/career-history
ParameterTypeRequiredDescriptionExample
manager_idintegerYesManager ID52829

GET Manager Events ​

Get manager's match history.

MethodEndpoint
GET/v1/managers/events
ParameterTypeRequiredDescriptionExample
manager_idintegerYesManager ID52829
pageintegerYesPage number (0-indexed)0
course_eventsstringYesEvent course typelast

Referees ​

GET Referee Data ​

Get referee information.

MethodEndpoint
GET/v1/referees/data
ParameterTypeRequiredDescriptionExample
referee_idintegerYesReferee ID72792

GET Referee Statistics ​

Get referee statistics.

MethodEndpoint
GET/v1/referees/statistics
ParameterTypeRequiredDescriptionExample
referee_idintegerYesReferee ID72792

GET Referee Events ​

Get referee's match history.

MethodEndpoint
GET/v1/referees/events
ParameterTypeRequiredDescriptionExample
referee_idintegerYesReferee ID72792
pageintegerYesPage number (0-indexed)0
course_eventsstringYesEvent course typelast

Rankings ​

GET Current Rankings ​

Get current rankings.

MethodEndpoint
GET/v1/rankings/current
ParameterTypeRequiredDescriptionExample
rankingstringYesRanking typeatp

GET Season Rankings ​

Get rankings by season/year.

MethodEndpoint
GET/v1/rankings/season
ParameterTypeRequiredDescriptionExample
rankingstringYesRanking typeatp
yearintegerYesYear2022

Transfers ​

GET Search Transfers ​

Search transfers with filters.

MethodEndpoint
GET/v1/transfers/search
ParameterTypeRequiredDescriptionExample
pageintegerYesPage number (0-indexed)0
nationalitystringNoCountry codeENG
min_ageintegerNoMinimum age15
max_ageintegerNoMaximum age50
position_typestringNoPosition (G, D, M, F)G
popularityintegerNoPopularity filter10
joinedbooleanNoJoined filtertrue
sort_typestringNoSort typetransfer_fee_max
unique_tournament_idintegerNoUnique Tournament ID-

TV ​

GET TV Channels ​

Get list of TV channels by country.

MethodEndpoint
GET/v1/tv/channels
ParameterTypeRequiredDescriptionExample
localestringYesLocale codeen

GET TV Country Channels ​

Get TV channels for an event.

MethodEndpoint
GET/v1/tv/country-channels
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID11930405

GET TV Channel Data ​

Get channel data.

MethodEndpoint
GET/v1/tv/channel-data
ParameterTypeRequiredDescriptionExample
event_idintegerYesEvent ID10253769
channel_idintegerYesChannel ID2707

Stages (Motorsport) ​

GET Unique Stages ​

Get list of unique stages by category.

MethodEndpoint
GET/v1/unique-stages
ParameterTypeRequiredDescriptionExample
category_idintegerYesCategory ID84

GET Unique Stages Seasons ​

Get seasons for a unique stage.

MethodEndpoint
GET/v1/unique-stages/seasons
ParameterTypeRequiredDescriptionExample
unique_stage_idintegerYesUnique Stage ID28

GET Stage Data ​

Get stage data.

MethodEndpoint
GET/v1/stages/data
ParameterTypeRequiredDescriptionExample
stage_idintegerYesStage ID190582

GET Stage Substages ​

Get substages of a stage.

MethodEndpoint
GET/v1/stages/substages
ParameterTypeRequiredDescriptionExample
stage_idintegerYesStage ID190582

GET Stage Standings Competitor ​

Get competitor standings.

MethodEndpoint
GET/v1/stages/standings/competitor
ParameterTypeRequiredDescriptionExample
stage_idintegerYesStage ID188803

GET Stage Standings Teams ​

Get team standings.

MethodEndpoint
GET/v1/stages/standings/teams
ParameterTypeRequiredDescriptionExample
stage_idintegerYesStage ID188803

GET Team Races (Motorsport) ​

Get team races.

MethodEndpoint
GET/v1/teams/races
ParameterTypeRequiredDescriptionExample
team_idintegerYesTeam ID226818
pageintegerYesPage number (0-indexed)0
course_eventsstringYesEvent course typelast

GET Team Career History (Motorsport) ​

Get team career history.

MethodEndpoint
GET/v1/teams/career-history
ParameterTypeRequiredDescriptionExample
team_idintegerYesTeam ID226818

GET Team Stage Seasons (Motorsport) ​

Get team stage seasons.

MethodEndpoint
GET/v1/teams/stage-seasons
ParameterTypeRequiredDescriptionExample
team_idintegerYesTeam ID226818

Common Workflows ​

Workflow 1: Get Today's Football Matches ​

1. GET /v1/sports → Get sport_id for Football (1)
2. GET /v1/calendar/categories?sport_id=1&date=2024-03-15&timezone=0 → Get categories with events
3. GET /v1/events/schedule/category?category_id=1&date=2024-03-15 → Get events for each category

Workflow 2: Get Match Details ​

1. GET /v1/events/data?event_id=11930405 → Get basic match info
2. GET /v1/events/statistics?event_id=11930405 → Get match statistics
3. GET /v1/events/lineups?event_id=11930405 → Get lineups
4. GET /v1/events/incidents?event_id=11930405 → Get incidents (goals, cards)

Workflow 3: Get League Standings ​

1. GET /v1/categories?sport_id=1 → Get categories
2. GET /v1/unique-tournaments?category_id=1 → Get tournaments for category
3. GET /v1/unique-tournaments/seasons?unique_tournament_id=17 → Get seasons
4. GET /v1/seasons/standings?unique_tournament_id=17&seasons_id=37036&standing_type=total → Get standings

Workflow 4: Get Player Statistics ​

1. GET /v1/teams/players?team_id=44 → Get team players
2. GET /v1/players/statistics/seasons?player_id=12994 → Get available seasons
3. GET /v1/players/statistics/result?player_id=12994&unique_tournament_id=34&seasons_id=37167&player_stat_type=overall → Get stats

Workflow 5: Get Live Events ​

1. GET /v1/sports/number-live → Get number of live events per sport
2. GET /v1/events/schedule/live?sport_id=1 → Get all live football matches

Response Examples ​

Sport List Response ​

json
{
  "data": [
    {"name": "Football", "slug": "football", "id": 1},
    {"name": "Basketball", "slug": "basketball", "id": 2},
    {"name": "Ice Hockey", "slug": "ice-hockey", "id": 4},
    {"name": "Tennis", "slug": "tennis", "id": 5},
    {"name": "Handball", "slug": "handball", "id": 6},
    {"name": "Volleyball", "slug": "volleyball", "id": 23},
    {"name": "Cricket", "slug": "cricket", "id": 62},
    {"name": "American Football", "slug": "american-football", "id": 63},
    {"name": "Baseball", "slug": "baseball", "id": 64},
    {"name": "eSports", "slug": "esports", "id": 72}
  ]
}

Event Data Response ​

json
{
  "data": {
    "tournament": {
      "name": "Premier League",
      "category": {"name": "England", "alpha2": "EN"},
      "uniqueTournament": {"id": 17, "name": "Premier League"}
    },
    "season": {"name": "Premier League 25/26", "year": "25/26", "id": 76986},
    "roundInfo": {"round": 26},
    "status": {"code": 100, "description": "Ended", "type": "finished"},
    "winnerCode": 3,
    "homeTeam": {"name": "Chelsea", "id": 38, "nameCode": "CHE"},
    "awayTeam": {"name": "Leeds United", "id": 34, "nameCode": "LEE"},
    "homeScore": {"current": 2, "period1": 1, "period2": 1},
    "awayScore": {"current": 2, "period1": 0, "period2": 2},
    "venue": {"name": "Stamford Bridge", "city": {"name": "London"}},
    "referee": {"name": "Robert Jones"},
    "startTimestamp": 1770751800
  }
}

Categories Response ​

json
{
  "data": [
    {
      "category": {
        "name": "England",
        "slug": "england",
        "sport": {"name": "Football", "id": 1},
        "id": 1,
        "flag": "england",
        "alpha2": "EN"
      },
      "totalEvents": 7,
      "totalVideos": 5,
      "uniqueTournamentIds": [1044, 17, 18, 25]
    }
  ]
}

We’re dedicated to providing the best API products.

API by Tipsters CO © All Right Reserved