StatMuse Scraper

Scrape sports statistics from StatMuse using natural language queries. Ask any sports question in plain English and get structured stat data back for NBA, NFL, MLB, and NHL. Perfect for building sports analytics dashboards, betting research tools, and sports history research.

What this actor does

• Four modes: queryNBA, queryNFL, queryMLB, queryNHL
• Natural language queries: ask anything, e.g. "LeBron James career points" or "most touchdowns in 2023"
• Structured output: player name, team, season, rank, individual stats
• Fallback: returns the answer sentence if no table data is available
• Empty fields are omitted — no null values in output

Output per record

Field	Description
queryText	Your original query
answer	StatMuse's natural language answer
sport	Sport (nba/nfl/mlb/nhl)
playerName	Player name
playerId	Player identifier
playerUrl	StatMuse player page URL
imageUrl	Player headshot URL
team	Team name
season	Season/year
rank	Ranking in result list
stats	Object with all numeric stat values
queryUrl	StatMuse query URL
recordType	Always "stat"
scrapedAt	ISO 8601 timestamp

Input

Field	Type	Default	Description
mode	string	queryNBA	queryNBA / queryNFL / queryMLB / queryNHL
query	string	LeBron James career points	Natural language sports question
maxItems	integer	10	Max records to return (1–200)

Example: NBA player career stats

{
  "mode": "queryNBA",
  "query": "LeBron James career points",
  "maxItems": 10
}

Example: NFL touchdowns leaders 2023

{
  "mode": "queryNFL",
  "query": "most touchdowns in 2023",
  "maxItems": 20
}

Example: MLB batting average leaders

{
  "mode": "queryMLB",
  "query": "highest batting average 2023 season",
  "maxItems": 10
}

Frequently Asked Questions

What kind of questions can I ask? Any natural language sports question: player career stats, single-season leaders, game logs, team records, historical comparisons, etc.

Does this require a StatMuse account or API key? No. This uses StatMuse's public website.

Which sports are supported? NBA, NFL, MLB, and NHL.

What if there's no table in the answer? The actor returns a single record with the StatMuse answer sentence and the query URL.

Can I get game-by-game data? Yes, try queries like "LeBron James game log 2023-24 season".