NBA API: Get standings
Returns NBA regular-season standings for a season, with Eastern and Western Conference teams in rank order. Defaults to the season shown on the NBA standings page.
Unofficial. Not affiliated with or endorsed by NBA.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Season optional
season NBA season, such as "2025-26" or its starting year "2025". Defaults to the season displayed on the NBA standings page.
2024-25
Default
.
Input as JSON
{ "season": "2024-25"}Output
{ "season": "2024-25", "eastern_conference": [ { "rank": 1, "team": "Cleveland Cavaliers", "wins": 64, "losses": 18, "streak": "Lost 1", "last_10": "6-4", "page_url": "https://www.nba.com/team/1610612739/cavaliers" , "away_record": "30-11", "home_record": "34-7", "games_behind": 0, "clinch_status": "Clinched Eastern Conference", "win_percentage": 0.78 }, { "rank": 2, "team": "Boston Celtics", "wins": 61, "losses": 21, "streak": "Won 2", "last_10": "8-2", "page_url": "https://www.nba.com/team/1610612738/celtics" , "away_record": "33-8", "home_record": "28-13", "games_behind": 3, "clinch_status": "Clinched Atlantic Division", "win_percentage": 0.744 }, { "rank": 3, "team": "New York Knicks", "wins": 51, "losses": 31, "streak": "Won 1", "last_10": "6-4", "page_url": "https://www.nba.com/team/1610612752/knicks" , "away_record": "24-17", "home_record": "27-14", "games_behind": 13, "clinch_status": "Clinched Playoff Berth", "win_percentage": 0.622 } ], "western_conference": [ { "rank": 1, "team": "Oklahoma City Thunder", "wins": 68, "losses": 14, "streak": "Won 4", "last_10": "8-2", "page_url": "https://www.nba.com/team/1610612760/thunder" , "away_record": "32-8", "home_record": "35-6", "games_behind": 0, "clinch_status": "Clinched Western Conference", "win_percentage": 0.829 }, { "rank": 2, "team": "Houston Rockets", "wins": 52, "losses": 30, "streak": "Lost 3", "last_10": "6-4", "page_url": "https://www.nba.com/team/1610612745/rockets" , "away_record": "23-17", "home_record": "29-12", "games_behind": 16, "clinch_status": "Clinched Southwest Division", "win_percentage": 0.634 }, { "rank": 3, "team": "Los Angeles Lakers", "wins": 50, "losses": 32, "streak": "Lost 1", "last_10": "6-4", "page_url": "https://www.nba.com/team/1610612747/lakers" , "away_record": "19-22", "home_record": "31-10", "games_behind": 18, "clinch_status": "Clinched Pacific Division", "win_percentage": 0.61 } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"nba.com/get_standings","input":{"season":"2024-25"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "nba.com/get_standings" , "input": { "season": "2024-25" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "nba.com/get_standings" , "input": { "season": "2024-25" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run nba.com/get_standings# with {"season":"2024-25"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "properties": { "season": { "type": "string", "default": "", "description": "NBA season, such as \"2025-26\" or its starting year \"2025\". Defaults to the season displayed on the NBA standings page." } }, "additionalProperties": false}Output schema
{ "type": "object", "required": [ "season", "eastern_conference", "western_conference" ], "properties": { "season": { "type": "string", "description": "Season shown in the standings." }, "eastern_conference": { "type": "array", "items": { "type": "object", "required": [ "rank", "team", "wins", "losses", "win_percentage", "games_behind", "streak", "last_10", "home_record", "away_record", "clinch_status", "page_url" ], "properties": { "rank": { "type": "integer", "description": "Team position in the conference." }, "team": { "type": "string", "description": "Team name." }, "wins": { "type": "integer", "description": "Games won." }, "losses": { "type": "integer", "description": "Games lost." }, "streak": { "type": [ "string", "null" ], "description": "Current consecutive wins or losses." }, "last_10": { "type": [ "string", "null" ], "description": "Record in the last ten games." }, "page_url": { "type": "string", "description": "NBA team page." }, "away_record": { "type": [ "string", "null" ], "description": "Away wins and losses." }, "home_record": { "type": [ "string", "null" ], "description": "Home wins and losses." }, "games_behind": { "type": [ "number", "null" ], "description": "Games behind the conference leader." }, "clinch_status": { "type": [ "string", "null" ], "description": "Clinch or elimination status when shown." }, "win_percentage": { "type": "number", "description": "Fraction of games won." } }, "additionalProperties": false }, "description": "Eastern Conference teams in rank order." }, "western_conference": { "type": "array", "items": { "type": "object", "required": [ "rank", "team", "wins", "losses", "win_percentage", "games_behind", "streak", "last_10", "home_record", "away_record", "clinch_status", "page_url" ], "properties": { "rank": { "type": "integer", "description": "Team position in the conference." }, "team": { "type": "string", "description": "Team name." }, "wins": { "type": "integer", "description": "Games won." }, "losses": { "type": "integer", "description": "Games lost." }, "streak": { "type": [ "string", "null" ], "description": "Current consecutive wins or losses." }, "last_10": { "type": [ "string", "null" ], "description": "Record in the last ten games." }, "page_url": { "type": "string", "description": "NBA team page." }, "away_record": { "type": [ "string", "null" ], "description": "Away wins and losses." }, "home_record": { "type": [ "string", "null" ], "description": "Home wins and losses." }, "games_behind": { "type": [ "number", "null" ], "description": "Games behind the conference leader." }, "clinch_status": { "type": [ "string", "null" ], "description": "Clinch or elimination status when shown." }, "win_percentage": { "type": "number", "description": "Fraction of games won." } }, "additionalProperties": false }, "description": "Western Conference teams in rank order." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
nba.com/get_standings- Returns
- season, eastern_conference and western_conference teams with rank, record, streak, last 10, home/away records, games behind, clinch status and team page URL
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method nba.com/get_standings with the inputs above.
Ask your agent
- What are the current NBA standings for the Eastern Conference this season?
- Show me the 2024-25 Western Conference standings with each team's record and games behind.
- Which teams are on a winning streak in the NBA right now, and where do they rank in their conference?
- I need the 2023-24 NBA standings including home and away records and clinch status for every team on nba.com.
- Can you pull the NBA regular-season standings for 2025 in rank order, with last-10 records for each conference?
See more
All NBA methodsGets NBA games for a date or up to seven days, using the NBA games calendar in US Eastern time. Each game has its score, status, start time, TV channels and venue.
nba.com/get_scoresReturns the NBA box score for a game between two teams on a date; without a date, their most recent matchup, including Summer League and games in progress.
nba.com/get_box_scoreLooks up an NBA player by name, including retired players, and returns the bio and regular-season per-game averages for the reported season and career.
nba.com/get_playerReturns Yahoo Sports team standings for a league and season, grouped by division or conference.
sports.yahoo.com/get_standingsGets NFL regular-season standings by conference and division for a season, with clinch status when shown.
nfl.com/get_standingsReturns MLB regular-season division standings for a season: records, win percentage, games back, streak, last 10 games and wild-card games back. Defaults to the current year.
mlb.com/get_standingsGets NHL standings as of a date, ordered by conference, division and division rank, with each team's official homepage.
nhl.com/get_standingsGets Formula 1 drivers' and teams' championship standings for a season, with the last completed race. Teams' standings begin in 1958.
formula1.com/get_standings