CBS Sports APIcbssports.com ↗
Access CBS Sports data via API: league schedules, game details, expert betting picks, analyst rankings, and team social feeds across NFL, NBA, MLB, and more.
What is the CBS Sports API?
The CBS Sports API provides 6 endpoints covering league schedules, game details, expert betting picks, analyst performance rankings, and team social feeds. The get_expert_picks endpoint returns per-game picks with expert writeups, betting selections, and outcome results, while get_hottest_experts surfaces ranked analysts with profit figures, win percentages, and streak labels for major leagues including NFL, NBA, MLB, NHL, NCAAF, and NCAAB.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/6f6b151f-34dd-4ca3-b92a-1bced675c394/list_leagues' \ -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 cbssports-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.
from parse_apis.cbs_sports_api import CBSSports, LeagueAbbrev
cbs = CBSSports()
# List all available leagues
for league in cbs.leagues.list():
print(league.id, league.abbrev)
# Find NBA league and list its games
nba_league = None
for league in cbs.leagues.list():
if league.abbrev == LeagueAbbrev.NBA:
nba_league = league
break
# List games for the NBA
for game in nba_league.games.list(max_results=5):
print(game.id, game.abbrev, game.away_team.abbrev, game.home_team.medium_name)
# Get detailed game info via navigation
first_game = next(iter(nba_league.games.list(max_results=1)))
detailed = first_game.details()
print(detailed.away_team.nickname, detailed.away_team.color_hex)
print(detailed.home_team.nickname, detailed.home_team.color_hex)
# Explore expert picks on the game
for pick in detailed.expert_picks.list(picks_count=3):
print(pick.expert.first_name, pick.expert.last_name, pick.selection.odds, pick.result_status)
# Get hottest experts for the league
for expert in nba_league.hottest_experts.list():
print(expert.rank, expert.first_name, expert.last_name, expert.profit, expert.win_percentage)
# Get team twitter feed using constructible Team
away_team = cbs.team(id="351")
for tweet in away_team.twitter_feed():
print(tweet.screen_name, tweet.text, tweet.created_at)
List all available sports leagues and their IDs. Returns league abbreviations and numeric IDs usable with other endpoints. The full catalog includes major US leagues (NFL, NBA, MLB, NHL), college sports, international soccer, golf, tennis, and minor leagues.
No input parameters required.
{
"type": "object",
"fields": {
"leagues": "array of league objects with id and abbrev"
},
"sample": {
"data": {
"leagues": [
{
"id": "54",
"abbrev": "NBA"
},
{
"id": "59",
"abbrev": "NFL"
},
{
"id": "52",
"abbrev": "MLB"
}
]
},
"status": "success"
}
}About the CBS Sports API
League and Game Data
Start with list_leagues to retrieve all available league IDs and abbreviations — these IDs are required inputs for get_league_games. That endpoint returns games in chronological order and exposes each game's id, abbrev, awayTeam, and homeTeam nodes. Pass a limit integer to cap results. For fuller team metadata on a specific matchup, call get_game_details with a game_id from the previous response; it returns each team's mediumName, nickname, abbrev, and colorHexDex alongside league metadata.
Expert Picks and Analyst Rankings
get_expert_picks accepts a game_id and an optional picks_count cap. It returns an expertPicks object with a totalCount and an edges array where each node contains the expert's identity, their selection, a writeup, and result data. Coverage is strongest for recent games in NFL, NBA, and MLB — not all games carry picks. get_hottest_experts takes a league_abbrev string (e.g. 'NFL', 'NCAAB') and returns a ranked list of analysts with firstName, lastName, profit, winPercentage, streakLabel, and rank fields, making it useful for building expert leaderboard features.
Team Social Feed
get_team_twitter_feed accepts a comma-separated list of team IDs (sourced from get_league_games or get_game_details) and an optional limit. It returns tweet objects containing id_str, name, screen_name, text, created_at, entities, and media fields — sufficient to render a team-specific social timeline alongside game data.
The CBS Sports API is a managed, monitored endpoint for cbssports.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when cbssports.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 cbssports.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?+
- Display a daily NFL or NBA schedule by pulling game nodes from
get_league_gamesfiltered by league ID. - Build a betting-pick aggregator using expert
selection,writeup, and result fields fromget_expert_picks. - Rank sports analysts by
profitandwinPercentagefor a fantasy or sports-betting research tool usingget_hottest_experts. - Render team color-themed UI components using
colorHexDexvalues returned byget_game_details. - Show a live social sidebar for a game page by fetching team tweet objects from
get_team_twitter_feed. - Monitor expert streak data across multiple leagues to identify analysts on winning runs using
streakLabelfromget_hottest_experts. - Cross-reference game IDs with expert pick counts to identify high-attention matchups before broadcast.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does CBS Sports have an official public developer API?+
What does `get_expert_picks` return and which games have picks?+
get_expert_picks returns an expertPicks object with a totalCount and an edges array. Each pick node includes the expert's identity, their selection, a prose writeup, and result data. Pick coverage is strongest for recent games in the NFL, NBA, and MLB. Games from smaller leagues or from the distant past are less likely to have picks attached.Does the API return live scores or final scores for games?+
get_league_games and get_game_details return team identities, abbreviations, and metadata but do not currently expose score fields or real-time game state. You can fork the API on Parse and revise it to add score or status fields if they appear in the game node data.Can I retrieve player-level stats or injury reports through this API?+
Is there a way to filter `get_league_games` to a specific date or week?+
get_league_games accepts a league_id and an optional limit integer but does not expose a date or week filter parameter. Games are returned in chronological order from the earliest available. You can fork the API on Parse and revise it to add date-range filtering if the underlying data supports it.