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:
footballbasketballbaseballmmaboxinghockeysoccertennisgolfmotorsportsesportswrestlingaussie-rulesrugbylacrossecricketvolleyballpolitics
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%"
}
}
}
},
...
],
}