Skip to main content

Historical Scores API Documentation

Requirement

You need an API key to use OddsBlaze. Request access at www.oddsblaze.com.

Description​

This endpoint returns final scores.

API Endpoint​

https://data.oddsblaze.com/v1/scores/historical/{league_id}_{season_year}.json

Parameters​

key (required)​

Your OddsBlaze API key.

id​

The game id (e.g. nfl:baltimore_ravens:kansas_city_chiefs:2024-regular-season-week-1).

team​

The team name or id (e.g. Baltimore Ravens or nfl:baltimore_ravens).

Example URLs​

NFL 2024-2025 scores for all teams:

https://data.oddsblaze.com/v1/scores/historical/nfl_2024-2025.json?key=your_key

NBA 2023-2024 scores for Golden State Warriors:

https://data.oddsblaze.com/v1/scores/historical/nba_2023-2024.json?key=your_key&team=Golden%20State%20Warriors

NCAAF 2022-2023 scores for all teams:

https://data.oddsblaze.com/v1/scores/historical/ncaaf_2022-2023.json?key=your_key

Example Response​

{
    "games": [
        {
            "id": "nfl:baltimore_ravens:kansas_city_chiefs:2024-regular-season-week-1",
            "sport": "Football",
            "league": "NFL",
            "teams": {
                "away": {
                    "id": "nfl:baltimore_ravens",
                    "name": "Baltimore Ravens",
                    "abbreviation": "BAL"
                },
                "home": {
                    "id": "nfl:kansas_city_chiefs",
                    "name": "Kansas City Chiefs",
                    "abbreviation": "KC"
                }
            },
            "start": "2024-09-06T00:40:00",
            "status": "Final",
            "live": false,
            "tournament": "Regular Season Week 1",
            "season": {
                "year": "2024-2025",
                "type": "Regular Season",
                "week": 1
            },
            "venue": {
                "name": "GEHA Field at Arrowhead Stadium",
                "location": "Kansas City, MO"
            },
            "scores": {
                "away": {
                    "1": 7,
                    "2": 3,
                    "3": 0,
                    "4": 10,
                    "total": 20
                },
                "home": {
                    "1": 7,
                    "2": 6,
                    "3": 7,
                    "4": 7,
                    "total": 27
                }
            },
            "updated": "2024-10-18T21:23:03"
        }
    ]
}