🏀 NCAA Basketball Play-by-Play Scraper

The best NCAA Men's Basketball play-by-play scraper on Apify — clean and analysis-ready data from 2006 onward

Stop cleaning messy college basketball data. Get every NCAA Men's Basketball play since 2006 - 50+ fields, proper types, zero cleanup required.

---

🎯 What does this scraper do?

This actor extracts detailed play-by-play information from every NCAA Men's Basketball game played since 2006. It delivers clean, structured data ready for analysis or integration into your applications. No manual cleanup, no parsing nightmares, no messy nested data.

Key Benefits

• ✅ 50+ fields per play - shots, fouls, rebounds, substitutions, and more
• ✅ 2006–present - Nearly 20 seasons of historical coverage
• ✅ All Division I teams - 350+ teams across all conferences
• ✅ Clean structure - proper types and descriptive field names
• ✅ Fast & reliable - built-in validation and error handling
• ✅ Export anywhere - JSON, CSV, Excel, XML, and more

💡 No manual cleanup. No parsing nightmares. Just clean data.

---

📦 What data can you extract?

Every play returns 50+ structured data points organized into logical categories:

Category	What's Included
🎮 Game Info	Game ID, season info, game date, game phase (regulation/overtime)
🏀 Teams	Home & away team names, schools, mascots, abbreviations
⏱️ Timing	Half, period, game clock, time remaining in half/game
🎯 Play Details	Play type, category, full description, which team performed it
📊 Scoring	Current score, point differential, who's leading, tie status
🏹 Shots	Shot type, made/missed, points value, court coordinates
👤 Players	Players involved in each play
💰 Betting	Point spread, home favorite status
➕ And more	Play sequences, boolean flags

💡 See the full data dictionary for all 50+ fields below.

---

🚀 How to scrape NCAA basketball play-by-play data

Quick Start Guide

Extracting NCAA basketball play-by-play data is simple - no coding required.

1. Create account — Sign up for a free Apify account
2. Open scraper — Go to NCAA Basketball Play-by-Play Scraper
3. Select inputs — Choose a team and season year
4. Run — Click Start in the Apify Console
5. Export — Download as JSON, CSV, Excel, XML, or HTML

✨ Try it FREE - No credit card required

---

📥 Inputs

The scraper requires two simple inputs:

Input	Required	Description	Example
Season	✅	4-digit year (2006–present)	2026 → 2025-26 season
Team	✅	Full team name (school + mascot)	Kentucky Wildcats, Duke Blue Devils

Option A: Use Apify Console (No Code)

The easiest way to get started — just point and click.

1. Open the NCAA Basketball Play-by-Play Scraper
2. Enter a season year (defaults to latest)
3. Select a team from the dropdown (e.g., "Kentucky Wildcats", "Duke Blue Devils")
4. Click Start
5. Download results

💡 Tip: Use the full team name including school and mascot. This ensures you get exactly the team you want — for example, "Kentucky Wildcats" vs "Arizona Wildcats" (there are 10 teams with "Wildcats" as their mascot!).

Option B: Use the API (Programmatic)

For automation, scheduling, or integration into your pipeline:

{
  "season": 2026,
  "team": "Kentucky Wildcats"
}

⚠️ Note: both season and team are required fields.

---

📤 Output

Results are stored in the Storage tab as a structured dataset. View directly on the platform or download in multiple formats.

Results Preview

Once scraping completes, preview your data immediately in the Output tab:

Organized Views

We've pre-configured logical dataset views to help you explore the data more easily:

View	Description
🏀 Game Overview	High-level view of games and key plays
🎯 Scoring Plays	All plays that resulted in points
🏹 Shot Analysis	Detailed shooting data with coordinates
📊 Game Flow	Score tracking throughout games
⚡ Key Events	Fouls, turnovers, and important moments
👥 Player Involvement	Which players were involved in each play
💰 Betting Context	Point spreads and betting lines
⏱️ Time Analysis	Detailed timing information

Sample JSON Output

Each play returns a clean, flat JSON object with 50+ fields. Field names are descriptive and grouped by prefix (game_, time_, score_, shot_, etc.) so you can quickly find what you need.

---

📖 Data Dictionary

Complete reference for all 50+ fields returned by this scraper. Fields are grouped by prefix for easy navigation.

Field	Type	Category	Description
game_id	integer	Game	Unique identifier for the game
game_season	integer	Game	Season year (e.g., 2026 for 2025-26 season)
game_season_type	integer	Game	Season type (1 = preseason, 2 = regular, 3 = postseason)
game_date	string	Game	Game date and tip-off time
game_phase	string	Game	Current phase (Regulation, Overtime, etc.)
home_team_id	integer	Home Team	Unique team identifier
home_team_full	string	Home Team	Full team name (e.g., "Kentucky Wildcats")
home_team_location	string	Home Team	School name (e.g., "Kentucky")
home_team_mascot	string	Home Team	Team mascot (e.g., "Wildcats")
home_team_abbreviation	string	Home Team	Team abbreviation (e.g., "UK")
away_team_id	integer	Away Team	Unique team identifier
away_team_full	string	Away Team	Full team name
away_team_location	string	Away Team	School name
away_team_mascot	string	Away Team	Team mascot
away_team_abbreviation	string	Away Team	Team abbreviation
play_sequence	integer	Sequence	Order of play within the game
play_id	integer	Sequence	Unique identifier for the play
time_half	integer	Timing	Current half (1 or 2)
time_half_display	string	Timing	Display format (e.g., "1st Half")
time_period	integer	Timing	Period number (1-2 regulation, 3+ overtime)
time_clock	string	Timing	Game clock display (e.g., "12:34")
time_clock_minutes	integer	Timing	Minutes remaining on clock
time_clock_seconds	integer	Timing	Seconds remaining on clock
time_remaining_half	integer	Timing	Seconds remaining in half
time_remaining_game	integer	Timing	Seconds remaining in game
play_type_id	integer	Play	Numeric code for play type
play_type	string	Play	Specific play type (e.g., "JumpShot", "PersonalFoul")
play_category	string	Play	Standardized category (Shot, Foul, Turnover, etc.)
play_description	string	Play	Full play description
play_team_id	integer	Play	Team that performed the play
play_team_full	string	Play	Full name of team that performed the play
play_team_role	string	Play	Team role (Home or Away)
is_scoring_play	boolean	Flags	Whether points were scored
is_turnover	boolean	Flags	Whether play resulted in turnover
is_foul	boolean	Flags	Whether play involved a foul
is_substitution	boolean	Flags	Whether play was a substitution
score_home	integer	Scoring	Home team score after this play
score_away	integer	Scoring	Away team score after this play
score_differential	integer	Scoring	Score difference (home - away)
score_is_tie	boolean	Scoring	Whether game is tied
score_home_leading	boolean	Scoring	Whether home team is leading
score_away_leading	boolean	Scoring	Whether away team is leading
score_leader_half	integer	Scoring	Which team led at end of half (null if ongoing)
player_primary_id	integer	Players	Primary player involved in play
player_secondary_id	integer	Players	Secondary player (e.g., assister, fouled player)
shot_is_attempt	boolean	Shots	Whether play was a shot attempt
shot_attempt_type	string	Shots	"Two Points", "Three Points", or "Free Throw"
shot_result	string	Shots	"Made" or "Missed"
shot_points_value	integer	Shots	Points value (1, 2, or 3)
shot_coordinate_x	number	Shots	Court X coordinate
shot_coordinate_y	number	Shots	Court Y coordinate
betting_spread	number	Betting	Point spread for the game
betting_home_favorite	boolean	Betting	Whether home team is favored
betting_spread_available	boolean	Betting	Whether spread data is available
betting_home_spread	number	Betting	Home team spread value

💡 Note: Some fields may be null depending on the play type — for example, shot coordinates only appear for shot attempts. All missing values are explicit null, not empty strings.

Key Differences from NBA Data

NCAA basketball has some important structural differences from NBA:

Aspect	NCAA	NBA
Game Length	Two 20-minute halves	Four 12-minute quarters
Overtime	5-minute periods	5-minute periods
Time Fields	time_half, time_period	time_quarter
Shot Clock	30 seconds	24 seconds
Teams	350+ Division I teams	30 teams

---

🔗 Sportsverse Data Suite

Building something bigger? Our ecosystem covers comprehensive sports data. Check out our other sports scrapers:

Actor	Description	Status
🏀 NCAA Basketball Play-by-Play	Every play from every college game (this actor)	✅ Available
🏀 NCAA Basketball Team Box Scores	College team statistics per game	✅ Available
🏀 NCAA Basketball Player Box Scores	College player statistics	✅ Available
🏀 NBA Play-by-Play	Professional basketball play-by-play	✅ Available
🏀 NBA Team Box Scores	NBA team statistics per game	✅ Available
🏀 NBA Player Box Scores	NBA player statistics per game	✅ Available
🏒 NHL Play-by-Play	Hockey game events	🚧 Coming Soon
🏒 NHL Box Scores	Player & team statistics	🚧 Coming Soon
🏈 NFL Play-by-Play	Football play tracking	🚧 Coming Soon
🏈 NFL Box Scores	Player & team statistics	🚧 Coming Soon
⚾ MLB Play-by-Play	Baseball game events	🚧 Coming Soon
⚾ MLB Box Scores	Player & team statistics	🚧 Coming Soon

---

🤝 Support & Feedback

Found a bug? Want a new field? Have an idea?

• 🐛 Report issues in the actor comments
• 💡 Suggest features or enhancements
• 📊 Request additional fields or output tweaks

We read every message and aim to respond quickly.

---

Built with ❤️ and lots of ☕ for the sports analytics community