Skip to main content
Version: 2.0.0

Sports Team API Documentation

Description

This endpoint returns all the detailed team, league, conference, logos & record data for every sports team: NFL, NBA, MLB, NHL, soccer & more.

REQUIREMENT

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/teams/

Parameters

key (required)

Your OpticOdds API license key.

name

The team name.

id

The team ID.

sport

NOTE

You can pass in multiple of this parameter.

The sport you want to receive teams for. We support the following:

  • football
  • basketball
  • baseball
  • mma
  • boxing
  • hockey
  • soccer
  • tennis
  • golf
  • motorsports
  • esports
  • wrestling
  • aussie-rules
  • rugby
  • lacrosse
  • cricket
  • volleyball
  • politics

league

NOTE

You can pass in multiple of this parameter.

The league you want to receive teams for (e.g. NBA)

division

NOTE

You can pass in multiple of this parameter.

Filter by division.

conference

NOTE

You can pass in multiple of this parameter.

Filter by conference.

detailed

Whether you want to include conference, division, nickname, and logos with the teams.

include_logos

Whether you want to include logos with the teams.

include_records

Whether you want to include team record information.

include_statsperform_ids

Specify this parameter if you want the StatsPerform IDs to be included as part of the response.

Example Response

{
"data": [
{
"id": "E89B6AABD4C6",
"sport": "baseball",
"league": "MLB",
"team_name": "Colorado Rockies",
"team_city": "Colorado",
"team_mascot": "Rockies",
"team_abbreviation": "COL"
},
{
"id": "118E9A57A501",
"sport": "baseball",
"league": "MLB",
"team_name": "Toronto Blue Jays",
"team_city": "Toronto",
"team_mascot": "Blue Jays",
"team_abbreviation": "TOR"
},
{
"id": "C4B26B4FAD20",
"sport": "baseball",
"league": "MLB",
"team_name": "Oakland Athletics",
"team_city": "Oakland",
"team_mascot": "Athletics",
"team_abbreviation": "OAK"
},
...
]
}

Example Response with Logos

{
"data": [
{
"id": "0B1A0B6BF016",
"team_name": "Korea Republic",
"team_city": "Korea Republic",
"team_mascot": null,
"team_abbreviation": "KOR",
"sport": "soccer",
"league": "soccer",
"logo": null
},
{
"id": "005068F3136A",
"team_name": "Lafayette",
"team_city": "Lafayette",
"team_mascot": "Leopards",
"team_abbreviation": "ULL",
"sport": "football",
"league": "NCAAF",
"logo": "https://cdn.opticodds.com/team-logos/ncaaf/lafayette_leopards.png"
},
],
}

Example Response with detailed=true

{
"data": [
{
"id": "34C7C1D5B0B7",
"team_name": "Duke",
"team_city": "Duke",
"team_mascot": "Blue Devils",
"team_abbreviation": "DUKE",
"sport": "football",
"league": "NCAAF",
"logo": "https://a.espncdn.com/i/teamlogos/ncaa/500/150.png",
"team_nickname": "Blue Devils",
"division": "FBS",
"conference": "ACC"
},
{
"id": "36D5C55CF7F1",
"team_name": "Florida State",
"team_city": "Florida State",
"team_mascot": "Seminoles",
"team_abbreviation": "FSU",
"sport": "football",
"league": "NCAAF",
"logo": "https://a.espncdn.com/i/teamlogos/ncaa/500/52.png",
"team_nickname": "Seminoles",
"division": "FBS",
"conference": "ACC"
},
],
}

Example Response with Team Records

{
"data": [
{
"id": "0054C2679F77",
"team_name": "Portland Trail Blazers",
"team_city": "Portland",
"team_mascot": "Trail Blazers",
"team_abbreviation": "POR",
"sport": "basketball",
"league": "NBA",
"logo": null,
"records": {
"ATS": {
"All Games": {
"wins": 40,
"losses": 42,
"ties": 0,
"record": "40-42-0",
"cover_percentage": "48.8%"
},
"As Home Team": {
"wins": 18,
"losses": 23,
"ties": 0,
"record": "18-23-0",
"cover_percentage": "43.9%"
},
"As Favorite": {
"wins": 17,
"losses": 14,
"ties": 0,
"record": "17-14-0",
"cover_percentage": "54.8%"
},
"As Underdog": {
"wins": 23,
"losses": 28,
"ties": 0,
"record": "23-28-0",
"cover_percentage": "45.1%"
},
"As Home Favorite": {
"wins": 13,
"losses": 10,
"ties": 0,
"record": "13-10-0",
"cover_percentage": "56.5%"
},
"As Home Underdog": {
"wins": 5,
"losses": 13,
"ties": 0,
"record": "5-13-0",
"cover_percentage": "27.8%"
},
"As Away Underdog": {
"wins": 17,
"losses": 15,
"ties": 0,
"record": "17-15-0",
"cover_percentage": "53.1%"
},
"Conference Games": {
"wins": 29,
"losses": 23,
"ties": 0,
"record": "29-23-0",
"cover_percentage": "55.8%"
},
"Non-Conference Games": {
"wins": 11,
"losses": 19,
"ties": 0,
"record": "11-19-0",
"cover_percentage": "36.7%"
},
"Division Games": {
"wins": 9,
"losses": 7,
"ties": 0,
"record": "9-7-0",
"cover_percentage": "56.3%"
},
"Non-Division Games": {
"wins": 31,
"losses": 35,
"ties": 0,
"record": "31-35-0",
"cover_percentage": "47.0%"
},
"Regular Season Games": {
"wins": 40,
"losses": 42,
"ties": 0,
"record": "40-42-0",
"cover_percentage": "48.8%"
},
"As Away Team": {
"wins": 21,
"losses": 19,
"ties": 0,
"record": "21-19-0",
"cover_percentage": "52.5%"
},
"As Away Favorite": {
"wins": 4,
"losses": 4,
"ties": 0,
"record": "4-4-0",
"cover_percentage": "50.0%"
}
},
"Over/Under": {
"All Games": {
"wins": 40,
"losses": 40,
"ties": 2,
"record": "40-40-2",
"cover_percentage": "50.0%"
},
"As Home Team": {
"wins": 23,
"losses": 16,
"ties": 2,
"record": "23-16-2",
"cover_percentage": "59.0%"
},
"As Away Team": {
"wins": 16,
"losses": 24,
"ties": 0,
"record": "16-24-0",
"cover_percentage": "40.0%"
},
"As Favorite": {
"wins": 17,
"losses": 13,
"ties": 1,
"record": "17-13-1",
"cover_percentage": "56.7%"
},
"As Underdog": {
"wins": 23,
"losses": 27,
"ties": 1,
"record": "23-27-1",
"cover_percentage": "46.0%"
},
"As Home Favorite": {
"wins": 15,
"losses": 7,
"ties": 1,
"record": "15-7-1",
"cover_percentage": "68.2%"
},
"As Away Favorite": {
"wins": 2,
"losses": 6,
"ties": 0,
"record": "2-6-0",
"cover_percentage": "25.0%"
},
"As Home Underdog": {
"wins": 8,
"losses": 9,
"ties": 1,
"record": "8-9-1",
"cover_percentage": "47.1%"
},
"As Away Underdog": {
"wins": 14,
"losses": 18,
"ties": 0,
"record": "14-18-0",
"cover_percentage": "43.8%"
},
"Conference Games": {
"wins": 27,
"losses": 23,
"ties": 2,
"record": "27-23-2",
"cover_percentage": "54.0%"
},
"Non-Conference Games": {
"wins": 13,
"losses": 17,
"ties": 0,
"record": "13-17-0",
"cover_percentage": "43.3%"
},
"Division Games": {
"wins": 9,
"losses": 7,
"ties": 0,
"record": "9-7-0",
"cover_percentage": "56.3%"
},
"Non-Division Games": {
"wins": 31,
"losses": 33,
"ties": 2,
"record": "31-33-2",
"cover_percentage": "48.4%"
},
"Regular Season Games": {
"wins": 40,
"losses": 40,
"ties": 2,
"record": "40-40-2",
"cover_percentage": "50.0%"
}
},
"Win/Loss": {
"All Games": {
"wins": 33,
"losses": 49,
"ties": 0,
"record": "33-49-0",
"cover_percentage": "40.2%"
},
"As Home Team": {
"wins": 17,
"losses": 24,
"ties": 0,
"record": "17-24-0",
"cover_percentage": "41.5%"
},
"As Away Team": {
"wins": 16,
"losses": 24,
"ties": 0,
"record": "16-24-0",
"cover_percentage": "40.0%"
},
"As Favorite": {
"wins": 19,
"losses": 12,
"ties": 0,
"record": "19-12-0",
"cover_percentage": "61.3%"
},
"As Underdog": {
"wins": 14,
"losses": 37,
"ties": 0,
"record": "14-37-0",
"cover_percentage": "27.5%"
},
"As Home Favorite": {
"wins": 15,
"losses": 8,
"ties": 0,
"record": "15-8-0",
"cover_percentage": "65.2%"
},
"As Away Favorite": {
"wins": 4,
"losses": 4,
"ties": 0,
"record": "4-4-0",
"cover_percentage": "50.0%"
},
"As Home Underdog": {
"wins": 2,
"losses": 16,
"ties": 0,
"record": "2-16-0",
"cover_percentage": "11.1%"
},
"As Away Underdog": {
"wins": 12,
"losses": 20,
"ties": 0,
"record": "12-20-0",
"cover_percentage": "37.5%"
},
"Conference Games": {
"wins": 23,
"losses": 29,
"ties": 0,
"record": "23-29-0",
"cover_percentage": "44.2%"
},
"Non-Conference Games": {
"wins": 10,
"losses": 20,
"ties": 0,
"record": "10-20-0",
"cover_percentage": "33.3%"
},
"Division Games": {
"wins": 7,
"losses": 9,
"ties": 0,
"record": "7-9-0",
"cover_percentage": "43.8%"
},
"Non-Division Games": {
"wins": 26,
"losses": 40,
"ties": 0,
"record": "26-40-0",
"cover_percentage": "39.4%"
},
"Regular Season Games": {
"wins": 33,
"losses": 49,
"ties": 0,
"record": "33-49-0",
"cover_percentage": "40.2%"
}
}
}
},
...
],
}