WNBA APIwnba.com ↗
Retrieve WNBA team playoff schedules and scores from wnba.com. Access game results, series progression, arena details, and final status per season.
What is the WNBA API?
The WNBA.com API provides 1 endpoint — get_team_playoff_games — that returns all playoff games for a specific team in a given season, including scores, series progression, arena details, and game status. Each response covers every playoff round the team participated in, with a total_playoff_games count and a structured games array containing per-game details. Useful for building postseason trackers, historical records, or team performance tools.
curl -X GET 'https://api.parse.bot/scraper/e8beb0d1-e4f8-467f-b9ab-e8bf63e35638/get_team_playoff_games?team=liberty&season=2025' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace wnba-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: WNBA SDK — fetch playoff game scores for a team."""
from parse_apis.wnba_com_api import WNBA, TeamSlug, TeamNotFound
client = WNBA()
# Get all 2025 playoff games for the New York Liberty
liberty = client.team(slug=TeamSlug.LIBERTY)
for game in liberty.playoff_games(season="2025", limit=10):
print(f"{game.date} | {game.away_team.name} ({game.away_team.score}) @ "
f"{game.home_team.name} ({game.home_team.score}) | {game.status} | {game.series_text}")
# Drill into first game details
first_game = liberty.playoff_games(season="2025", limit=1).first()
if first_game:
print(f"\nGame {first_game.game_id}: {first_game.game_label} at {first_game.arena}, {first_game.arena_city}")
# Typed error handling for an invalid team
try:
bad_team = client.team(slug="nonexistent")
bad_team.playoff_games(season="2025", limit=1).first()
except TeamNotFound as exc:
print(f"\nTeam not found: {exc}")
print("\nexercised: team / playoff_games / TeamNotFound")
Retrieve all playoff games for a specific WNBA team in a given season. Returns game scores, series progression, arena details, and final status for each playoff game. Results are returned as a single list covering all rounds the team participated in.
| Param | Type | Description |
|---|---|---|
| team | string | WNBA team slug. |
| season | string | 4-digit season year (e.g. 2025). |
{
"type": "object",
"fields": {
"team": "string",
"games": "array of playoff game objects with scores",
"season": "string",
"total_playoff_games": "integer"
},
"sample": {
"data": {
"team": "liberty",
"games": [
{
"date": "2025-09-14",
"arena": "PHX Arena",
"status": "Final/OT",
"game_id": "1042500131",
"away_team": {
"name": "New York Liberty",
"wins": 1,
"score": 76,
"losses": 0,
"team_id": 1611661313,
"tricode": "NYL"
},
"home_team": {
"name": "Phoenix Mercury",
"wins": 0,
"score": 69,
"losses": 1,
"team_id": 1611661317,
"tricode": "PHX"
},
"arena_city": "Phoenix",
"game_label": "First Round",
"arena_state": "AZ",
"season_type": "Playoffs",
"series_text": "NYL leads 1-0"
}
],
"season": "2025",
"total_playoff_games": 3
},
"status": "success"
}
}About the WNBA API
What the API Returns
The get_team_playoff_games endpoint accepts a team slug and a 4-digit season year, then returns a flat list of playoff game objects covering all rounds that team played. Each response includes the team identifier, season, total_playoff_games count, and a games array. Each game object within that array contains scores for both sides, arena details, series progression context, and a final status field indicating whether the game is completed.
Input Parameters
Both team and season are optional string inputs. Pass team as a WNBA team slug (e.g. new-york-liberty) to scope results to that franchise. Pass season as a 4-digit year to target a specific postseason. Omitting either parameter may return default data; combining both gives the most precise result set.
Data Shape and Coverage
The games array delivers results as a single ordered list across all playoff rounds — first round, semifinals, and finals appearances are all included without separate pagination per round. Each game object surfaces score data for both teams, the arena where the game was played, and where that game falls within the series. The total_playoff_games integer at the top level lets you verify you have the full set without counting the array manually.
Source and Freshness
Data reflects what wnba.com publishes for a given team's postseason. Coverage is limited to playoff games; regular-season schedules and stats are not part of this endpoint. Historical seasons can be queried by changing the season parameter.
The WNBA API is a managed, monitored endpoint for wnba.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when wnba.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official wnba.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a WNBA postseason bracket tracker showing scores and series status per team
- Aggregate historical playoff performance data for a franchise across multiple seasons
- Display arena-specific game history for a team's playoff appearances
- Power a notification service that monitors final game status for completed playoff games
- Compare series progression between two teams that met in the same playoff round
- Populate a stats dashboard with total playoff games played per team per season
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does wnba.com have an official developer API?+
What does the `games` array contain for each playoff game?+
games array includes scores for both teams, the arena where the game was played, the game's position within the series, and a final status field. All rounds the team participated in appear in the same flat list, so there is no need to paginate per round.Does the API cover regular-season games or only the playoffs?+
get_team_playoff_games. Regular-season schedules, individual player stats, and standings are not returned. You can fork this API on Parse and revise it to add an endpoint targeting regular-season game data.Can I retrieve playoff data for multiple teams in one call?+
team slug per request, so each call returns data for one team. Querying multiple teams requires one call per team. You can fork this API on Parse and revise it to add a batch endpoint that accepts multiple team slugs.How current is the playoff game data?+
season year parameter.