Flashscore Basketball Box Scores & Team Stats Scraper

Pricing

Rating

Developer

Actor stats

Categories

Share

Extract detailed basketball match statistics from Flashscore — 21 per-player box score fields and per-quarter team performance metrics — for any completed or live basketball match. Supply Flashscore match URLs or raw match IDs; the actor returns one structured item per match with a full nested players array and team statistics breakdown.

Data source: Flashscore internal feed endpoints (df_st_1 for team stats, df_psn_1 for player box scores). No proxy required.

What basketball data can you extract?

Player box scores (21 statistics per player)

For every player on both teams, the actor returns:

Per-player fields that are not recorded for a given match (e.g. blocks_against, technical_fouls) are omitted from that player's object — they will not appear as zero or null.

Team statistics (per quarter and match total)

For each period (Match, 1st Quarter, 2nd Quarter, 3rd Quarter, 4th Quarter, OT), the actor returns rows across three categories:

• Scoring: Field goals %, 3-point field goals %, Free throws %
• Rebounds: Total rebounds, Offensive rebounds, Defensive rebounds
• Other: Assists, Blocks, Steals, Turnovers, Personal fouls

Key features

• 21 player statistics per match — complete box score for all players on both teams
• Per-quarter team statistics — FG%, 3P%, FT%, rebounds, assists, blocks, steals, turnovers, fouls broken down by quarter and match total
• Flexible input — supply Flashscore match URLs (startUrls) or raw 8-character match IDs (matchIds), or both
• Selective data fetching — toggle team stats and player box scores independently; each toggle corresponds to one HTTP request per match
• No proxy required — direct requests to Flashscore feed APIs; 2 requests per match in the default configuration
• Covers all basketball leagues — NBA, EuroLeague, national leagues, and any other basketball sport on Flashscore
• Clean, absent-field output — missing player stats are omitted (not null), compatible with strict dataset schema validation

Limitations

Input parameters

Validation rules:

• At least one of startUrls or matchIds must be provided and non-empty.
• At least one of includeTeamStats or includePlayerStats must be true. If both are false, the actor exits immediately with an error.

Supported URL formats

The actor accepts two Flashscore URL formats:

Format A — with ?mid= query parameter:

https://www.flashscore.com/match/basketball/new-york-knicks-WCNO4nbt/philadelphia-76ers-vwRW2QSh/?mid=OxuYoJH6

Match ID extracted from ?mid=OxuYoJH6.

Format B — match ID in trailing path segment:

https://www.flashscore.com/match/basketball/knicks-76ers-OxuYoJH6/

Match ID extracted from the final 8-character path segment.

URLs from which a match ID cannot be extracted are logged as warnings and skipped.

Sample input (both toggles enabled)

{
"matchIds":["OxuYoJH6","nRQtuO9m"],
"includeTeamStats":true,
"includePlayerStats":true
}

Sample input (player stats only, from URL)

{
"startUrls":[
"https://www.flashscore.com/match/basketball/new-york-knicks-WCNO4nbt/philadelphia-76ers-vwRW2QSh/?mid=OxuYoJH6"
],
"includeTeamStats":false,
"includePlayerStats":true
}

Output fields

Top-level fields (one item per match)

team_stats[] element fields

players[] element fields

Sample output

The following is real output from match OxuYoJH6 (New York Knicks vs Philadelphia 76ers, NBA). Two players shown (10 per team in the actual dataset); team_stats truncated to 4 of ~40 rows.

{
"match_id":"OxuYoJH6",
"match_url":"https://www.flashscore.com/match/basketball/OxuYoJH6/",
"home_team":"New York Knicks",
"away_team":"Philadelphia 76ers",
"quarter_scores":[],
"team_stats":[
{
"period":"Match",
"category":"Scoring",
"stat_name":"Field goals %",
"home_value":"50.63%",
"away_value":"45.33%"
},
{
"period":"Match",
"category":"Scoring",
"stat_name":"3-point field goals %",
"home_value":"25.00%",
"away_value":"43.59%"
},
{
"period":"Match",
"category":"Rebounds",
"stat_name":"Total rebounds",
"home_value":"37",
"away_value":"32"
},
{
"period":"1st Quarter",
"category":"Scoring",
"stat_name":"Field goals %",
"home_value":"57.14%",
"away_value":"38.46%"
}
],
"players":[
{
"team":"New York Knicks",
"team_abbreviation":"NYK",
"player_name":"Anunoby OG.",
"player_url":"/player/anunoby-og-ogugua/jiNJMxEa/",
"nationality":"United Kingdom",
"height_cm":197,
"points":24,
"total_rebounds":5,
"assists":2,
"minutes":"37:25",
"fg_made":9,
"fg_attempted":17,
"fg2_made":7,
"fg2_attempted":10,
"fg3_made":2,
"fg3_attempted":7,
"ft_made":4,
"ft_attempted":4,
"plus_minus":12,
"offensive_rebounds":2,
"defensive_rebounds":3,
"personal_fouls":3,
"steals":4,
"blocks":1
},
{
"team":"Philadelphia 76ers",
"team_abbreviation":"PHI",
"player_name":"Maxey T.",
"player_url":"/player/maxey-tyrese/r9DvnZeC/",
"nationality":"USA",
"height_cm":200,
"points":26,
"total_rebounds":3,
"assists":6,
"minutes":"46:48",
"fg_made":9,
"fg_attempted":23,
"fg2_made":8,
"fg2_attempted":17,
"fg3_made":1,
"fg3_attempted":6,
"ft_made":7,
"ft_attempted":9,
"defensive_rebounds":3,
"personal_fouls":1,
"steals":1,
"turnovers":6
}
],
"scraped_at":"2026-05-09T18:19:58Z"
}

Use cases

Fantasy sports developers

Build or power fantasy basketball applications with per-match player box score data. The 21-field player output covers every statistic used in standard fantasy scoring systems: points, rebounds, assists, steals, blocks, turnovers, three-pointers made, plus/minus, and more. Fetch historical match data to backfill a season, or run the actor on a schedule after each match to keep your scoring engine current.

Betting analytics

Enrich sports betting models with historical per-quarter team performance metrics. The team_stats output provides field goal %, 3-point %, free throw %, and rebounding breakdowns split by quarter — useful for building pre-match and historical spread models, identifying teams that struggle in specific quarters, or validating line movement against statistical trends.

Sports research and analytics

Conduct season-level analysis by extracting box scores across hundreds of matches. Compare player efficiency across different leagues (NBA, EuroLeague, national leagues), study team-level performance patterns, or track individual player progression across a season. All 21 player stat fields are available; absent fields are omitted (not zero), preserving data fidelity.

Sports journalism and fact-checking

Verify game statistics quickly for match reporting and fact-checking. Query a specific match by ID and retrieve the complete box score in seconds — no browser automation, no scraping overhead. Useful for confirming player scoring lines, team shooting percentages, or quarter-by-quarter performance narratives before publication.

How it works

1. The actor fetches the Flashscore homepage to extract an authentication token from the core JavaScript bundle.
2. For each match ID (from startUrls or matchIds), the actor makes up to two direct HTTP requests to Flashscore's internal feed endpoints:
   • df_st_1_{matchId} — team statistics (if includeTeamStats: true)
   • df_psn_1_{matchId} — player box scores (if includePlayerStats: true)
3. Responses are parsed using a state-machine feed parser (delimiter-separated text format used internally by Flashscore).
4. One dataset item is emitted per match.

Request budget: 2 fixed requests (homepage + token) + up to 2 per match. A 10-match run with both toggles on = 22 HTTP requests total.

No browser, no proxy, no JavaScript rendering. All data comes from lightweight feed endpoints.

Related actors

FAQ

Q: How do I find a Flashscore basketball match ID?

Navigate to any basketball match page on Flashscore. The match ID is the 8-character alphanumeric segment in the URL, or the value of the ?mid= query parameter. You can also use the Flashscore: Match Listings, Scores & Fixtures actor to retrieve match IDs for a given date and sport.

Q: Why is quarter_scores always an empty array?

Quarter score data (IG÷/IH÷ fields) is only available in Flashscore's live feed endpoints, not in the historical df_st_1 feed used by this actor. The field is always present but always empty. Per-quarter team statistics (FG%, rebounds, etc.) are still available through the team_stats array.

Q: Why are home_score and away_score missing from the output?

Final score data is not available in the df_st_1 or df_psn_1 Flashscore feed endpoints. To get final scores, use the Flashscore: Match Listings, Scores & Fixtures or Flashscore Results actor.

Q: Does this actor cover leagues outside the NBA?

Yes. Any basketball match on Flashscore is supported — NBA, EuroLeague, FIBA competitions, national leagues, and more. Data availability depends on Flashscore's coverage for that league. Matches with no team statistics recorded will return an absent team_stats field; player stats are typically available regardless of league.

Q: What happens if a player stat field is not recorded?

Fields are omitted from that player's object entirely — they will never appear as null or 0. For example, if a player did not record any blocks, the blocks field will not be present in their object at all.

Q: Can I use this for live matches?

The actor fetches a point-in-time snapshot. For matches currently in progress, it will return whatever statistics Flashscore has recorded up to the moment of the request. For continuous live monitoring, schedule the actor to run at regular intervals (e.g. every 5 minutes). For dedicated live match tracking, consider the Flashscore Basketball Live Matches actor.