bleacherreport.com APIbleacherreport.com ↗
Access Bleacher Report sports news, live scores, and NBA box scores via 4 endpoints. Retrieve full article content, game stats, and player statistics by sport and date.
curl -X GET 'https://api.parse.bot/scraper/756c7a01-682b-4984-aa15-851584e21385/get_news?limit=5&sport=nba' \ -H 'X-API-Key: $PARSE_API_KEY'
Get current news articles for a specific sport. Returns article slugs and URLs that can be used with get_article.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of articles to return. |
| sport | string | Sport slug: 'nba', 'nfl', 'mlb', 'nhl'. |
{
"type": "object",
"fields": {
"sport": "string - the sport queried",
"articles": "array of article objects with id, slug, and url"
},
"sample": {
"data": {
"sport": "nba",
"articles": [
{
"id": "25425904",
"url": "https://bleacherreport.com/articles/25425904-austin-rivers-challenges-draymond-green-1-1-game-new-video-amid-viral-beef-nba-star",
"slug": "25425904-austin-rivers-challenges-draymond-green-1-1-game-new-video-amid-viral-beef-nba-star"
}
]
},
"status": "success"
}
}About the bleacherreport.com API
The Bleacher Report API provides 4 endpoints covering sports news articles, live scores, and detailed box-score data across major North American leagues. get_news returns article slugs and URLs for NBA, NFL, MLB, and NHL coverage, while get_game_stats delivers per-player statistics, quarter-by-quarter linescores, and team stat comparisons using a gamecast slug from get_scores.
News and Article Endpoints
get_news accepts a sport parameter (nba, nfl, mlb, nhl) and an optional limit to control how many results come back. It returns an array of article objects, each containing an id, slug, and url. Those slugs feed directly into get_article, which returns the full article: title, author, published_at as an ISO timestamp, and content as an array of paragraph strings. The published_at field may be empty for some articles.
Scores and Game Statistics
get_scores takes a sport and an optional date in YYYY-MM-DD format, defaulting to today. It returns an array of game objects that include team scores, game status, gamecast_slug, and location. NBA is the confirmed working sport; NFL, MLB, and NHL results depend on season availability and may return empty or time out. The gamecast_slug from each game object is the required input for get_game_stats.
Box Score Detail
get_game_stats returns a full game record keyed by gamecast_slug. Response fields include linescore (period-by-period scores), scoreboard (team_one and team_two totals with progress), player_stats (starters and bench grouped by team), stat_leaders (present on some games), comparison (team-level stat contrasts), display_name, status, and game_state (e.g., PostGame, InProgress). This endpoint covers the same game scope as the Bleacher Report Gamecast experience.
- Display NBA box scores with per-player statistics and bench/starter splits in a sports dashboard
- Aggregate Bleacher Report articles by sport tag for a news digest or newsletter
- Track live game status and score progression using the
game_stateandlinescorefields - Build a game recap tool that links article content from
get_articleto box-score data fromget_game_stats - Monitor stat leaders across NBA games by extracting the
stat_leadersobject from box score responses - Pull
gamecast_slugvalues fromget_scoresto build a historical game index for a specific date range - Compare team-level stats from the
comparisonarray to support pre- or post-game analysis features
| 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 | 250 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 Bleacher Report have an official developer API?+
Which sports are supported by get_scores, and what happens with non-NBA sports?+
get_scores. The nfl, mlb, and nhl values are accepted parameters, but results depend on whether games are in season and on upstream data availability. Requests for those sports may return empty game arrays or time out. NBA box scores via get_game_stats are the most reliable use of the scores workflow.What player-level data does get_game_stats return?+
get_game_stats returns player_stats grouped into starters and bench for each team, alongside stat_leaders for notable individual performances (present on some but not all games). The comparison array holds aggregate team-level stat contrasts. Individual historical player season stats or career averages are not included in any endpoint. The API covers game-level and match-level data only. You can fork it on Parse and revise to add an endpoint targeting player profile or season stats pages.Are schedules or upcoming game data available?+
get_scores endpoint returns results for a specific date (defaulting to today) and reflects completed or in-progress games. Forward-looking schedules are not a returned field in any endpoint. You can fork it on Parse and revise to add an endpoint that targets Bleacher Report schedule pages for a given team or league.Can get_article retrieve opinion columns and analysis pieces, or only news reports?+
get_article works with any slug returned by get_news, which covers articles indexed under the specified sport on Bleacher Report. That includes news reports, analysis, and opinion pieces — whatever appears in the sport's feed. The content field returns the full body as an array of paragraph strings, and author identifies the byline. There is no filter parameter to restrict by article type within the endpoint.