⚾ MLB Scoreboard Scraper

Get live MLB game scores, line scores, and top performers! This powerful Apify actor fetches comprehensive game data including inning-by-inning scores, team statistics, and player performance metrics. Perfect for sports analytics, betting insights, and real-time game tracking!

🎯 What This Actor Does

This actor allows you to:

• Get live game scores - Real-time and final scores for all MLB games
• Line scores - Runs, Hits, and Errors (R-H-E) for each game
• Inning-by-inning breakdown - Score progression for every inning
• Top performers - Player statistics for hitting, pitching, fielding, and base running
• Game status tracking - Live updates, final results, and game timing
• Batch processing - Scrape multiple game dates in one run

🚀 How to Use

Step 1: Get Game Dates

Determine which dates you want to scrape MLB games from. Use the format YYYYMMDD:

20250902  (September 2, 2025)
20250903  (September 3, 2025)

Step 2: Configure the Actor

Input	Description	Default
gameDates	Array of game dates in YYYYMMDD format	Required
includeTopPerformers	Include detailed player performance stats	true

Step 3: Run and Get Results

Run the actor and download your game data in JSON, CSV, or Excel format.

📊 Output Data Structure

Each game result contains:

🎮 Game Identifiers

Field	Description
gameID	Unique game identifier (e.g., "20250902_NYM@DET")
gameDate	Date of the game (YYYYMMDD)
matchup	Game matchup (e.g., "NYM @ DET")

🏟️ Team Information

Field	Description
awayTeam	Away team abbreviation
homeTeam	Home team abbreviation
teamIDAway	Away team ID
teamIDHome	Home team ID

⏰ Game Timing

Field	Description
gameTime	Game start time (e.g., "6:40p")
gameTime_epoch	Unix timestamp of game time

📊 Score Summary

Field	Description
awayScore	Away team final score
homeScore	Home team final score
winner	Winning team abbreviation

📈 Line Score (R-H-E)

Field	Description
awayHits	Away team total hits
homeHits	Home team total hits
awayErrors	Away team errors
homeErrors	Home team errors

⚾ Inning Breakdown

Field	Description
awayInningScores	Object with scores by inning for away team
homeInningScores	Object with scores by inning for home team

📡 Game Status

Field	Description
currentInning	Current inning or "Final"
currentCount	Current count (balls-strikes)
currentOuts	Current number of outs
gameStatus	Game status (e.g., "Completed")
gameStatusCode	Status code (2 = Completed)
awayResult	Away team result (W/L)
homeResult	Home team result (W/L)

🏆 Top Performers (Optional)

Field	Description
topPerformers	Object containing player statistics for both teams

Top Performers includes:

• Hitting: HR, RBI, H, AB, BB, SO, TB, 2B, 3B, etc.
• Pitching: SO, ER, BB, H, Pitches, Strikes, Batters Faced, etc.
• Fielding: Errors, Assists, Pickoffs, etc.
• Base Running: SB (Stolen Bases), CS (Caught Stealing)

📋 Example Input

{
  "gameDates": [
    "20250902",
    "20250903"
  ],
  "includeTopPerformers": true
}

📋 Example Output

{
  "gameID": "20250902_NYM@DET",
  "gameDate": "20250902",
  "matchup": "NYM @ DET",
  "awayTeam": "NYM",
  "homeTeam": "DET",
  "teamIDAway": "18",
  "teamIDHome": "10",
  "gameTime": "6:40p",
  "gameTime_epoch": "1756852800.0",
  "awayScore": 12,
  "homeScore": 5,
  "winner": "NYM",
  "awayHits": 17,
  "homeHits": 8,
  "awayErrors": 0,
  "homeErrors": 1,
  "awayInningScores": {
    "1": "1",
    "2": "0",
    "3": "0",
    "4": "5",
    "5": "0",
    "6": "0",
    "7": "6",
    "8": "0",
    "9": "0"
  },
  "homeInningScores": {
    "1": "2",
    "2": "0",
    "3": "0",
    "4": "0",
    "5": "0",
    "6": "0",
    "7": "0",
    "8": "0",
    "9": "3"
  },
  "currentInning": "Final",
  "currentCount": "",
  "currentOuts": "",
  "gameStatus": "Completed",
  "gameStatusCode": "2",
  "awayResult": "W",
  "homeResult": "L",
  "topPerformers": {
    "NYM": {
      "Hitting": {
        "HR": {
          "playerID": ["624413"],
          "total": "2"
        }
      },
      "Pitching": {
        "SO": {
          "playerID": ["690997"],
          "total": "7"
        }
      }
    }
  }
}

🎨 Dataset Views

The actor provides 5 organized table views:

View	Description
⚾ Games Overview	All games with scores, matchups, winners, and status
📊 Line Scores	Detailed R-H-E breakdown for each game
📈 Inning Breakdown	Inning-by-inning score progression
✅ Completed Games	Only finished games with final scores
🏆 Top Performers	Player performance statistics

💡 Use Cases

• Sports Analytics - Analyze game trends, team performance, and player statistics
• Betting Insights - Track scores and performance for informed betting decisions
• Real-time Tracking - Monitor live game progress and scores
• Historical Data - Build databases of past game results
• Fantasy Baseball - Track player performance for fantasy leagues
• Sports Journalism - Quick access to game data for articles and reports
• Mobile Apps - Feed live scores into sports applications
• Data Visualization - Create charts and graphs of game statistics

📅 Date Format

Always use the YYYYMMDD format for game dates:

Format	Example	Description
YYYYMMDD	20250902	September 2, 2025
YYYYMMDD	20251225	December 25, 2025

🏆 Top Performers Statistics

When includeTopPerformers is enabled, you get detailed stats:

Hitting Stats

• HR - Home Runs
• RBI - Runs Batted In
• H - Hits
• AB - At Bats
• BB - Walks
• SO - Strikeouts
• TB - Total Bases
• 2B - Doubles
• 3B - Triples

Pitching Stats

• SO - Strikeouts
• ER - Earned Runs
• BB - Walks
• H - Hits Allowed
• Pitches - Total Pitches
• Strikes - Total Strikes
• Batters Faced - Total Batters Faced

Fielding Stats

• E - Errors
• Assists - Fielding Assists
• Pickoffs - Pickoff Attempts

Base Running Stats

• SB - Stolen Bases
• CS - Caught Stealing

🔧 Error Handling

The actor handles various scenarios:

• Invalid date formats
• No games found for a date
• Rate limits
• Network errors
• Missing data

📞 Support

For questions, feedback, or issues, please contact us through Apify or open an issue.

🔎 Tags

MLB scraper, MLB scores scraper, baseball scores, MLB live scores, MLB game data, baseball statistics, MLB API, sports scraper, baseball scraper, MLB data extractor, live sports scores, baseball analytics, Apify MLB scraper, MLB scoreboard

---

Happy scraping! ⚾✨