Live Game Scores API Documentation
Description
This endpoint returns all the games scores for live, completed and unplayed games, filterable by sports, league, & more.
You'll need a license key to use OpticOdds' API. You can get one by contacting us at www.opticodds.com.
API Endpoint
https://api.opticodds.com/api/v2/scores
Supported Leagues
NBA, NFL, NHL, MLB, NCAAB, NCAAF, UFC, ATP, WTA, Soccer, AFL, UFL, KBO, NPB, NCAA Baseball, NCAA Lacrosse
Parameters
key (required)
Your OpticOdds API license key.
sport
You can pass in multiple of this parameter.
The sport you want to receive scores for. We support the following:
footballbasketballbaseballmmaboxinghockeysoccertennisgolfmotorsportsesportswrestlingaussie-rulesrugbylacrossecricketvolleyballpolitics
league
You can pass in multiple of this parameter.
The league you want to receive scores for (e.g. NBA)
game_id
You can pass in multiple of this parameter.
The OpticOdds game ID you want to receive scores for (e.g. 39341-78014-2022-01-17)
team_id
You can pass in multiple of this parameter.
The team ID you want to receive scores for (e.g. E89B6AABD4C6)
live
Whether you want live scores or completed.
status
Filter games by status, possible statuses are Live|Half|Unplayed|Completed|Cancelled|Suspended|Delayed.
include_starting_lineups
Set to true to include home_starting_lineups and away_starting_lineups.
include_team_ids
Whether or not to include the team_id field on the odds returned, if there is no matching team id, this will default to null.
include_events
For soccer, this will include major incidents (Yellow Cards, Goals, VAR).
page
The page number of the request.
Example Response
{
"data": [
{
"game_id": "29679-37994-2023-01-05",
"score_home_total": 18,
"score_away_total": 10,
"clock": "10:18",
"sport": "Basketball",
"league": "NCAAB",
"period": "1",
"status": "Live",
"is_live": true,
"weather": null,
"away_team": "USC",
"broadcast": "ESPN",
"home_team": "UCLA",
"last_play": "Tre White Defensive Rebound.",
"start_date": "2023-01-06T02:30:00Z",
"venue_name": "Pauley Pavilion",
"description": "USC vs UCLA",
"season_type": "Regular",
"season_week": null,
"season_year": "2023",
"away_starter": null,
"checked_date": "2023-01-06T02:55:51Z",
"current_outs": null,
"home_starter": null,
"weather_temp": null,
"away_team_abb": "USC",
"current_balls": null,
"home_team_abb": "UCLA",
"away_team_city": "USC",
"away_team_name": "Trojans",
"home_team_city": "UCLA",
"home_team_name": "Bruins",
"venue_location": "Los Angeles, CA",
"current_strikes": null,
"runner_on_first": null,
"runner_on_third": null,
"runner_on_second": null,
"weather_temp_high": null,
"current_possession": null,
"current_batter_name": null,
"score_away_period_1": 10,
"score_home_period_1": 18,
"current_pitcher_name": null,
"current_down_and_distance": null
},
{
"id": "6BC68D3A415B",
"sport": "Hockey",
"league": "NHL",
"start_date": "2022-02-13T17:30:00Z",
"season_type": "Regular",
"season_year": "2021-2022",
"season_week": "",
"away_team_abb": "BUF",
"away_team_city": "Buffalo",
"away_team_name": "Sabres",
"away_team": "Buffalo Sabres",
"home_team_abb": "MTL",
"home_team_city": "Montreal",
"home_team_name": "Canadiens",
"home_team": "Montreal Canadiens",
"description": "Buffalo Sabres vs Montreal Canadiens",
"venue_name": "Bell Centre",
"venue_location": "Montreal, QC",
"away_starting_goalie_name": "Craig Anderson",
"home_starting_goalie_name": "Sam Montembeault",
"is_live": false,
"status": "Completed",
"period": null,
"clock": null,
"score_away_total": 5,
"score_home_total": 3,
"score_away_period_1": 1,
"score_away_period_2": 2,
"score_away_period_3": 2,
"score_home_period_1": 0,
"score_home_period_2": 3,
"score_home_period_3": 0,
"checked_date": "2022-02-17T00:33:27Z",
"game_id": "10120-21758-2022-02-13"
},
{
"id": "646DAF876F18",
"sport": "Basketball",
"league": "NBA",
"start_date": "2022-02-13T19:00:00Z",
"season_type": "Regular",
"season_year": "2021-2022",
"season_week": "",
"away_team_abb": "ATL",
"away_team_city": "Atlanta",
"away_team_name": "Hawks",
"away_team": "Atlanta Hawks",
"home_team_abb": "BOS",
"home_team_city": "Boston",
"home_team_name": "Celtics",
"home_team": "Boston Celtics",
"description": "Atlanta Hawks vs Boston Celtics",
"venue_name": "TD Garden",
"venue_location": "Boston, MA",
"is_live": false,
"status": "Completed",
"period": null,
"clock": null,
"score_away_total": 95,
"score_home_total": 105,
"score_away_period_1": 28,
"score_away_period_2": 27,
"score_away_period_3": 23,
"score_away_period_4": 17,
"score_home_period_1": 17,
"score_home_period_2": 28,
"score_home_period_3": 42,
"score_home_period_4": 18,
"checked_date": "2022-02-17T00:33:26Z",
"game_id": "19957-77646-2022-02-13"
},
...
],
"page": 1,
"total_pages": 4
}