Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: iSports Basketball Profile API
version: '2026-08-09'
description: 'Key-authenticated REST/HTTP data feeds for football (soccer) and basketball: livescores, schedules and results, match events, lineups, live text, statistics, standings, player and team profiles, transfers, referees, multi-language name packs, live-animation feeds, and pre-match / in-play / historical odds across 200+ bookmakers.'
termsOfService: https://www.isportsapi.com/en/home/terms.html
contact:
name: iSports API
url: https://www.isportsapi.com/en/
x-derived-by: API Evangelist enrichment pipeline
x-derived-from: https://www.isportsapi.com/en/docs.html
x-derived-on: '2026-08-09'
servers:
- url: https://api.isportsapi.com
description: Primary API host
- url: https://api2.isportsapi.com
description: Alternate host, documented for when the primary host is slow or unreachable
security:
- apiKeyQuery: []
tags:
- name: Basketball Profile
paths:
/sport/basketball/team:
get:
operationId: getBasketballTeam
summary: Team Profile
description: '• This API endpoint returns basketball team profile information. Filter by leagueId or teamId; if both are omitted, returns information for all teams.
• Note that detailed fields such as website, conference, division, city, venue, capacity, joinYear, and coach may return empty or 0 for teams in lower-tier leagues where such information is not tracked.'
tags:
- Basketball Profile
parameters:
- name: leagueId
in: query
required: false
schema:
type: string
description: Returns team information for all teams under the specified leagueId.
- name: teamId
in: query
required: false
schema:
type: string
description: Returns team information for the specified teamId.
- name: day
in: query
required: false
schema:
type: string
description: Returns team data that has been added or modified within the specified number of days, e.g. day=1 or day=2.
responses:
'200':
description: Standard iSports envelope. `code` 0 indicates success; a non-zero `code` carries the error in `message` (HTTP status is 200 in both cases).
content:
application/json:
schema:
type: object
properties:
code:
type: integer
description: 0 on success; 2 on invalid/illegal api_key
message:
type: string
description: '"success" on success; otherwise the error message'
data:
type: array
items:
type: object
properties:
teamId:
type: string
description: Unique ID of the team.
leagueId:
type: string
description: Unique ID of the league or cup the team belongs to.
name:
type: string
description: Full name, e.g. Los Angeles Lakers.
shortName:
type: string
description: Short name, e.g. Lakers.
logo:
type: string
description: "Team logo URL. \n\n The image is hosted for reference only — please save it locally rather than calling this URL directly in production."
website:
type: string
description: Official team website. Returns empty if not available.
conference:
type: string
description: Conference the team belongs to, e.g. NBA Western. Returns "NO" if not applicable.
division:
type: string
description: Division the team belongs to, e.g. Pacific. Returns empty if not applicable.
city:
type: string
description: City where the team is based. Returns empty if not available.
venue:
type: string
description: Home venue of the team. Returns empty if not available.
capacity:
type: integer
description: Seating capacity of the home venue. Returns 0 if not available.
joinYear:
type: integer
description: Year the team joined the league, e.g. 1948. Returns 0 if not available.
championCount:
type: integer
description: Number of championships won.
coach:
type: string
description: Name of the head coach. Returns empty if not available.
externalDocs:
description: iSports API documentation
url: https://www.isportsapi.com/en/docs.html?id=27
x-documentation:
- https://www.isportsapi.com/en/docs.html?id=27
x-rate-limit: This interface is limited to 300 seconds/call;
x-recommended-call-frequency: 1 day/call
x-plan-products:
- Live Data
x-doc-modified: '2026-07-09'
/sport/basketball/player:
get:
operationId: getBasketballPlayer
summary: Player Profile
description: '• This API endpoint returns basketball player profile information. All players are returned by default.
• Note: The request must include the parameter cmd=new, e.g. http://api.isportsapi.com/sport/basketball/player?api_key=&cmd=new.'
tags:
- Basketball Profile
parameters:
- name: cmd
in: query
required: true
schema:
type: string
description: Fixed value new. Required for this endpoint to return data correctly.
- name: day
in: query
required: false
schema:
type: string
description: Returns player data that has been added or modified within the specified number of days, e.g. day=1 or day=2.
responses:
'200':
description: Standard iSports envelope. `code` 0 indicates success; a non-zero `code` carries the error in `message` (HTTP status is 200 in both cases).
content:
application/json:
schema:
type: object
properties:
code:
type: integer
description: 0 on success; 2 on invalid/illegal api_key
message:
type: string
description: '"success" on success; otherwise the error message'
data:
type: array
items:
type: object
properties:
playerId:
type: string
description: Unique ID of the player.
number:
type: integer
description: Jersey number. Returns 0 if not available.
name:
type: string
description: Player name.
teamId:
type: string
description: Unique ID of the team the player belongs to.
place:
type: string
description: Position of the player, e.g. Forward. Returns empty if not available.
birthday:
type: integer
description: Player's date of birth (Unix timestamp, GMT+0). Returns 0 if not available.
height:
type: integer
description: 'Height, unit: cm, e.g. 192. Returns 0 if not available.'
weight:
type: integer
description: 'Weight, unit: kg, e.g. 77. Returns 0 if not available.'
photo:
type: string
description: "Player photo URL. \n\n The image is hosted for reference only — please save it locally rather than calling this URL directly in production. Returns empty if not available."
nbaAge:
type: integer
description: Years since the player joined the NBA. Returns 0 for non-NBA players.
salary:
type: string
description: 'Salary, unit: ten thousand USD, e.g. 3565. Returns empty if not available.'
country:
type: string
description: Player's nationality/country.
isNational:
type: boolean
description: "true: player is on a national team roster \n false: player is not on a national team roster"
externalDocs:
description: iSports API documentation
url: https://www.isportsapi.com/en/docs.html?id=28
x-documentation:
- https://www.isportsapi.com/en/docs.html?id=28
x-rate-limit: This interface is limited to 300 seconds/call;
x-recommended-call-frequency: 1 day/call
x-plan-products:
- Live Data
x-doc-modified: '2026-07-09'
/sport/basketball/cupqualify:
get:
operationId: getBasketballCupqualify
summary: Cup Stage Profile
description: '• This API endpoint returns stage type information for basketball cups, such as qualifying rounds, group stages, and regular season.
• The recordId returned by this endpoint corresponds to the stageId field in the Schedule & Results endpoint, allowing you to match a specific match to its cup stage.'
tags:
- Basketball Profile
responses:
'200':
description: Standard iSports envelope. `code` 0 indicates success; a non-zero `code` carries the error in `message` (HTTP status is 200 in both cases).
content:
application/json:
schema:
type: object
properties:
code:
type: integer
description: 0 on success; 2 on invalid/illegal api_key
message:
type: string
description: '"success" on success; otherwise the error message'
data:
type: array
items:
type: object
properties:
recordId:
type: string
description: Unique ID of this stage record. Corresponds to the stageId field in the Schedule & Results endpoint.
leagueId:
type: string
description: Unique ID of the league or cup.
name:
type: string
description: Name of the stage, e.g. Qualifying Round, Regular Season.
season:
type: string
description: Season, e.g. 2025-2026 or 2026.
groupCount:
type: integer
description: "Number of groups this stage is divided into. \n\n Returns 0 if not applicable, e.g. 7 means the schedule is divided into 7 groups."
roundCount:
type: integer
description: "Number of games played between the two sides in a series to determine the winner. \n\n Returns 0 if not applicable, e.g. 7 means the series is decided over 7 games, as seen in Finals stages."
sortNumber:
type: integer
description: The order of this stage among the different stages within the same cup.
currentGroup:
type: boolean
description: "true: this is the current group stage \n false: this is not the current group stage"
group:
type: boolean
description: "true: this stage is a group-based match format \n false: this stage is not a group-based match format"
externalDocs:
description: iSports API documentation
url: https://www.isportsapi.com/en/docs.html?id=77
x-documentation:
- https://www.isportsapi.com/en/docs.html?id=77
x-rate-limit: This interface is limited to 1,800 seconds/call;
x-recommended-call-frequency: 1 day/call
x-plan-products:
- Live Data
x-doc-modified: '2026-07-09'
/sport/basketball/playoffs:
get:
operationId: getBasketballPlayoffs
summary: Playoffs Stage Profile
description: '• This API endpoint returns playoff stage type information for basketball leagues, such as Quarter Final, Semi Final, and Final.
• The recordId returned by this endpoint corresponds to the playoffsId field in the Schedule & Results endpoint, allowing you to match a specific match to its playoff stage.'
tags:
- Basketball Profile
responses:
'200':
description: Standard iSports envelope. `code` 0 indicates success; a non-zero `code` carries the error in `message` (HTTP status is 200 in both cases).
content:
application/json:
schema:
type: object
properties:
code:
type: integer
description: 0 on success; 2 on invalid/illegal api_key
message:
type: string
description: '"success" on success; otherwise the error message'
data:
type: array
items:
type: object
properties:
recordId:
type: string
description: Unique ID of this stage record. Corresponds to the playoffsId field in the Schedule & Results endpoint.
leagueId:
type: string
description: Unique ID of the league.
name:
type: string
description: Name of the playoff stage, e.g. Quarter Final, Semi Final, Final.
season:
type: string
description: Season, e.g. 26 or 25-26.
groupCount:
type: integer
description: Number of groups this stage is divided into. Returns 0 if not applicable.
roundCount:
type: integer
description: "Number of games played between the two sides in a series to determine the winner. \n\n Returns 0 if not applicable, e.g. 7 means the series is decided over 7 games, as seen in Final stages."
sortNumber:
type: integer
description: The order of this stage among the different playoff stages within the same league.
currentGroup:
type: boolean
description: "true: this is the current stage \n false: this is not the current stage"
group:
type: boolean
description: "true: this stage is a group-based match format \n false: this stage is not a group-based match format"
externalDocs:
description: iSports API documentation
url: https://www.isportsapi.com/en/docs.html?id=78
x-documentation:
- https://www.isportsapi.com/en/docs.html?id=78
x-rate-limit: This interface is limited to 1,800 seconds/call;
x-recommended-call-frequency: 1 day/call
x-plan-products:
- Live Data
x-doc-modified: '2026-07-09'
/sport/basketball/league:
get:
operationId: getBasketballLeague
summary: League & Cup Profile
description: This API endpoint returns complete profile information for basketball leagues and cups, including league rules, ranking format, and season details. Click here to view all leagues & cups.
tags:
- Basketball Profile
parameters:
- name: leagueId
in: query
required: false
schema:
type: string
description: Returns profile information for the specified leagueId. If omitted, returns profile information for all leagues and cups.
responses:
'200':
description: Standard iSports envelope. `code` 0 indicates success; a non-zero `code` carries the error in `message` (HTTP status is 200 in both cases).
content:
application/json:
schema:
type: object
properties:
code:
type: integer
description: 0 on success; 2 on invalid/illegal api_key
message:
type: string
description: '"success" on success; otherwise the error message'
data:
type: array
items:
type: object
properties:
leagueId:
type: string
description: Unique ID of the league or cup.
color:
type: string
description: 'RGB color code associated with the league, e.g. #9933FF.'
leagueName:
type: string
description: Full name of the league or cup, e.g. National Basketball Association.
leagueShortName:
type: string
description: Short name of the league or cup, e.g. NBA.
leagueType:
type: string
description: "Number of quarters played in this league's matches. \n\n 2: 2-quarter format \n 4: 4-quarter format"
currentMatchSeason:
type: string
description: Current season, e.g. 25-26.
countryId:
type: string
description: Unique ID of the country or region the league belongs to.
country:
type: string
description: "Country or region name, e.g. USA. \n\n Returns \"International\" for multi-national competitions."
leagueKind:
type: string
description: '1: league
2: cup'
logo:
type: string
description: "League logo URL. \n\n The image is hosted for reference only — please save it locally rather than calling this URL directly in production."
partTime:
type: string
description: Duration of each quarter, format mm:ss, e.g. 12:00.
rule:
type: string
description: "Full text description of the league's rules, including format, scheduling, ranking, tie-breaker, and playoff details where applicable.\n\n This field may contain a large block of text with line breaks (\\r\\ n) — please handle formatting accordingly when rendering."
externalDocs:
description: iSports API documentation
url: https://www.isportsapi.com/en/docs.html?id=79
x-documentation:
- https://www.isportsapi.com/en/docs.html?id=79
x-rate-limit: This interface is limited to 1,800 seconds/call;
x-recommended-call-frequency: 1 day/call
x-plan-products:
- Live Data
x-doc-modified: '2026-07-09'
/sport/basketball/team/search:
get:
operationId: getBasketballTeamSearch
summary: Team Profile for Search
description: '• This API endpoint supports searching for basketball team information by team name, with fuzzy matching supported.
• Note that detailed fields such as website, conference, division, city, venue, capacity, joinYear, and coach may return empty or 0 for teams in lower-tier leagues where such information is not tracked.'
tags:
- Basketball Profile
parameters:
- name: name
in: query
required: true
schema:
type: string
description: Team name to search for. Supports fuzzy search.
responses:
'200':
description: Standard iSports envelope. `code` 0 indicates success; a non-zero `code` carries the error in `message` (HTTP status is 200 in both cases).
content:
application/json:
schema:
type: object
properties:
code:
type: integer
description: 0 on success; 2 on invalid/illegal api_key
message:
type: string
description: '"success" on success; otherwise the error message'
data:
type: array
items:
type: object
properties:
teamId:
type: string
description: Unique ID of the team.
leagueId:
type: string
description: Unique ID of the league or cup the team belongs to.
name:
type: string
description: Full name, e.g. Los Angeles Lakers.
shortName:
type: string
description: Short name, e.g. Lakers.
logo:
type: string
description: "Team logo URL. \n\n The image is hosted for reference only — please save it locally rather than calling this URL directly in production."
website:
type: string
description: Official team website. Returns empty if not available.
conference:
type: string
description: Conference the team belongs to, e.g. NBA Western. Returns "NO" if not applicable.
division:
type: string
description: Division the team belongs to, e.g. Pacific. Returns empty if not applicable.
city:
type: string
description: City where the team is based. Returns empty if not available.
venue:
type: string
description: Home venue of the team. Returns empty if not available.
capacity:
type: integer
description: Seating capacity of the home venue. Returns 0 if not available.
joinYear:
type: integer
description: Year the team joined the league, e.g. 1948. Returns 0 if not available.
championCount:
type: integer
description: Number of championships won.
coach:
type: string
description: Name of the head coach. Returns empty if not available.
externalDocs:
description: iSports API documentation
url: https://www.isportsapi.com/en/docs.html?id=136
x-documentation:
- https://www.isportsapi.com/en/docs.html?id=136
x-rate-limit: This interface is limited to 60 seconds/call;
x-plan-products:
- Live Data
x-doc-modified: '2026-07-09'
/sport/basketball/player/search:
get:
operationId: getBasketballPlayerSearch
summary: Player Profile for Search
description: '• This API endpoint supports searching for basketball player information by player name, with fuzzy matching supported.
• Note: The request must include the parameter cmd=new, e.g. http://api.isportsapi.com/sport/basketball/player/search?api_key=&cmd=new&name=James.'
tags:
- Basketball Profile
parameters:
- name: cmd
in: query
required: true
schema:
type: string
description: Fixed value new. Required for this endpoint to return data correctly.
- name: name
in: query
required: true
schema:
type: string
description: Player name to search for. Supports fuzzy search.
responses:
'200':
description: Standard iSports envelope. `code` 0 indicates success; a non-zero `code` carries the error in `message` (HTTP status is 200 in both cases).
content:
application/json:
schema:
type: object
properties:
code:
type: integer
description: 0 on success; 2 on invalid/illegal api_key
message:
type: string
description: '"success" on success; otherwise the error message'
data:
type: array
items:
type: object
properties:
playerId:
type: string
description: Unique ID of the player.
number:
type: integer
description: Jersey number. Returns 0 if not available.
name:
type: string
description: Player name.
teamId:
type: string
description: Unique ID of the team the player belongs to.
place:
type: string
description: Position of the player, e.g. Forward. Returns empty if not available.
birthday:
type: integer
description: Player's date of birth (Unix timestamp, GMT+0). Returns 0 if not available.
height:
type: integer
description: 'Height, unit: cm, e.g. 192. Returns 0 if not available.'
weight:
type: integer
description: 'Weight, unit: kg, e.g. 77. Returns 0 if not available.'
photo:
type: string
description: "Player photo URL. \n\n The image is hosted for reference only — please save it locally rather than calling this URL directly in production. Returns empty if not available."
nbaAge:
type: integer
description: Years since the player joined the NBA. Returns 0 for non-NBA players.
salary:
type: string
description: 'Salary, unit: ten thousand USD, e.g. 3565. Returns empty if not available.'
country:
type: string
description: Player's nationality/country. Returns empty if not available.
isNational:
type: boolean
description: "true: player is on a national team roster \n false: player is not on a national team roster"
externalDocs:
description: iSports API documentation
url: https://www.isportsapi.com/en/docs.html?id=137
x-documentation:
- https://www.isportsapi.com/en/docs.html?id=137
x-rate-limit: This interface is limited to 60 seconds/call;
x-plan-products:
- Live Data
x-doc-modified: '2026-07-09'
components:
securitySchemes:
apiKeyQuery:
type: apiKey
in: query
name: api_key
description: Personal API key issued from the iSports account settings page and passed on every request as the `api_key` query parameter.
externalDocs:
description: iSports API documentation
url: https://www.isportsapi.com/en/docs.html