🏠 MLB Home Run Props JSON API

Last updated: 2025-06-25 02:31 PM EDT

MLB Games

Games with Props

Players with Home Run Odds

📡 Available Endpoints

Full Home Run Props Data

GET /api/v1/homerun-props.json Full data analysis, comprehensive dashboards

Complete dataset with all games, players, lines, and odds from multiple sportsbooks.

Size: ~0.4 KB

Summary Data

GET /api/v1/summary.json Quick overview, mobile apps, initial page loads

Lightweight summary with game info and player counts (no odds data).

Size: ~0.4 KB

Players Only

GET /api/v1/players.json Player comparison tools, fantasy apps

All player props with game context, optimized for player-focused views.

Size: ~0.5 KB

Best Odds

GET /api/v1/best-odds.json Value betting, line shopping, odds comparison

Best odds and value bets ranked by favorability across all sportsbooks.

Size: ~0.5 KB

🚀 Usage Examples

JavaScript/Fetch

fetch('https://your-username.github.io/homerun-odds/api/v1/summary.json')
  .then(response => response.json())
  .then(data => {
    console.log(`${data.summary.total_players} players across ${data.summary.total_games} games`);
    
    data.games.forEach(game => {
      console.log(`${game.away_team} @ ${game.home_team} - ${game.player_count} players`);
    });
  });
        

Python

import requests

response = requests.get('https://your-username.github.io/homerun-odds/api/v1/players.json')
data = response.json()

for player in data['players']:
    print(f"{player['player_name']}: {player['line_display']}")
        

cURL

curl -H "Accept: application/json" \
     https://your-username.github.io/homerun-odds/api/v1/best-odds.json
        

📊 Response Format

All endpoints return JSON with consistent structure:

metadata: Generation timestamp, date, timezone
summary: Total counts and statistics
games or players: Main data arrays

⚡ Rate Limiting

No rate limiting on these endpoints. Data is cached and served statically.

🔗 CORS

All endpoints support CORS for browser-based applications.

📈 Data Updates

Data is automatically updated every 2 hours during baseball season (10 AM - 10 PM ET).

🏠 About

This API provides MLB home run prop betting odds with consensus pricing across multiple sportsbooks. Data is sourced from The Odds API and processed to provide clean, consistent formatting for developers and analysts.

Built with: Python, The Odds API, GitHub Actions, GitHub Pages