# NFL Odds API

The Odds API covers NFL odds for live and upcoming games in a simple JSON API.

Not a developer? Current NFL odds can also be accessed in Excel or Google Sheets. For website owners, the odds widget brings bookmaker odds into websites with a simple HTML tag.

# Features

NFL odds are covered for live and upcoming games.
Featured markets, including moneyline, spreads, totals are covered for several bookmakers. See the full list of bookmakers.
Additional markets including player props, half and quarter time markets, and more are covered for most US bookmakers. See the full list of betting markets.
Odds are refreshed at regular intervals. More information on update intervals can be found here.
NFL scores are covered, with final scores available for games completed up to 3 days ago.
Current odds data and scores are available on all usage plans, including the free usage plan.
Historical NFL odds data is available on paid usage plans. Historical odds for featured markets (moneyline, spreads, totals) are available from mid-2020. Historical odds for other markets are available from May 2023. More information on historical odds data can be found here.
The API response includes deep links to bookmaker websites.
Rotation numbers are included in the API response.

# Querying NFL Odds

# Query Featured NFL Markets

Featured markets (moneyline, spreads and totals) can be queried using the odds endpoint. For additional markets including player props, use the event-odds endpoint.

Parameters

To query current NFL odds for featured markets, the following parameters need to be provided:

sport In this case americanfootball_nfl
regions Regions of bookmakers to return, for example us
markets For example, h2h for moneyline, spreads and totals
apiKey Get a free API key

See the documentation for more options

Example API Request

https://api.the-odds-api.com/v4/sports/americanfootball_nfl/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY

Example API Response

The API will return live and upcoming NFL games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets.

[{
    "id": "2fd335893dbb8ab9c0e1aea6c98a969c",
    "sport_key": "americanfootball_nfl",
    "sport_title": "NFL",
    "commence_time": "2024-12-10T01:15:00Z",
    "home_team": "Dallas Cowboys",
    "away_team": "Cincinnati Bengals",
    "bookmakers": [
        {
            "key": "draftkings",
            "title": "DraftKings",
            "last_update": "2024-12-09T23:54:52Z",
            "markets": [
                {
                    "key": "h2h",
                    "last_update": "2024-12-09T23:54:52Z",
                    "outcomes": [
                        {"name": "Cincinnati Bengals", "price": -218},
                        {"name": "Dallas Cowboys", "price": 180}
                    ]
                },
                {
                    "key": "spreads",
                    "last_update": "2024-12-09T23:54:52Z",
                    "outcomes": [
                        {"name": "Cincinnati Bengals", "price": -108, "point": -4.5},
                        {"name": "Dallas Cowboys", "price": -112, "point": 4.5}
                    ]
                },
                {
                    "key": "totals",
                    "last_update": "2024-12-09T23:54:52Z",
                    "outcomes": [
                        {"name": "Over", "price": -108, "point": 50.5},
                        {"name": "Under", "price": -112, "point": 50.5}
                    ]
                }
            ]
        },
        {
            "key": "williamhill_us",
            "title": "Caesars",
            "last_update": "2024-12-09T23:53:48Z",
            "markets": [
                ...

The usage cost of the API call in this example is

usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits

See the API documentation for details.

# Query Any NFL Markets

Any supported NFL markets can be queried one game at a time using the event-odds endpoint.

Parameters

To query current NFL odds for any market, including player props, half/quarter time markets, and more, the following parameters need to be provided:

sport In this case americanfootball_nfl
eventId This example uses the id of Bengals @ Cowboys (id 2fd3...). A list of current event ids can be queried using the events endpoint.
regions Regions of bookmakers to return, for example us
markets For example h2h_q1 (1st quarter moneyline), player_pass_tds, player_rush_yds
apiKey Get a free API key

See the documentation for more options.

Example API Request

https://api.the-odds-api.com/v4/sports/americanfootball_nfl/events/2fd335893dbb8ab9c0e1aea6c98a969c/odds?regions=us&markets=h2h_q1,player_pass_tds,player_rush_yds&oddsFormat=american&apiKey=YOUR_API_KEY

Example API Response

The response will contain the specified NFL game including odds from the specified bookmakers and markets.

{
    "id": "2fd335893dbb8ab9c0e1aea6c98a969c",
    "sport_key": "americanfootball_nfl",
    "sport_title": "NFL",
    "commence_time": "2024-12-10T01:15:00Z",
    "home_team": "Dallas Cowboys",
    "away_team": "Cincinnati Bengals",
    "bookmakers": [
        {
            "key": "draftkings",
            "title": "DraftKings",
            "last_update": "2024-12-09T23:54:52Z",
            "markets": [
                {
                    "key": "h2h_q1",
                    "last_update": "2024-12-09T23:55:33Z",
                    "outcomes": [
                        {"name": "Cincinnati Bengals", "price": -148},
                        {"name": "Dallas Cowboys", "price": 124}
                    ]
                },
                {
                    "key": "player_pass_tds",
                    "last_update": "2024-12-09T23:55:33Z",
                    "outcomes": [
                        {"name": "Over", "description": "Cooper Rush", "price": 110, "point": 1.5},
                        {"name": "Under", "description": "Cooper Rush", "price": -145, "point": 1.5},
                        {"name": "Over", "description": "Joe Burrow", "price": -235, "point": 1.5},
                        {"name": "Under", "description": "Joe Burrow", "price": 180, "point": 1.5}
                    ]
                },
                {
                    "key": "player_rush_yds",
                    "last_update": "2024-12-09T23:55:33Z",
                    "outcomes": [
                        {"name": "Over", "description": "Chase Brown", "price": -115, "point": 76.5},
                        {"name": "Under", "description": "Chase Brown", "price": -115, "point": 76.5},
                        {"name": "Over", "description": "Rico Dowdle", "price": -105, "point": 65.5},
                        {"name": "Under", "description": "Rico Dowdle", "price": -125, "point": 65.5},
                        {"name": "Over", "description": "Ezekiel Elliott", "price": -110, "point": 9.5},
                        {"name": "Under", "description": "Ezekiel Elliott", "price": -120, "point": 9.5},
                        ...

                    ]
                }
            ]
        },
        ...

The usage cost of the API call in this example is

usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits

If you only need featured markets (moneyline, spreads, totals), it will be more cost-efficient to query the odds endpoint since it will return multiple games.

See the API documentation for details.

# Other Sports

See the full list of sports covered by The Odds API.

# NFL Odds API

# Features

# Querying NFL Odds

# Query Featured NFL Markets

# Query Any NFL Markets

# Other Sports

# Stay Updated