Getting Started with the NFL Odds API

If you’re new to querying the SportsGameOdds API, this NFL odds guide is designed to help you hit the ground running. We’ll use the NFL as an example to walk through the /v2/events endpoint in Postman, covering everything from basic requests to more advanced queries like filtering player props and using oddIDs.

NFL Odds API Guide: NFL ODDS API endpoint examples

The goal is to give you practical, copy-and-paste examples you can adapt for your own projects, while also highlighting best practices to keep your calls efficient and results tailored to your needs.

Whether you’re building a betting app, a DFS tool, or simply exploring sports data, this guide will show you how to:

• Query events and player props with the NFL as a working example.
• Use parameters like leagueID, oddIDs, and bookmakerID to filter results.
• Speed up response times with smart parameter choices.
• Access supporting documentation, Postman collections, and examples to go further.

In this quick video, I’ll show you how to query our Odds API using Postman.

We’ll walk through the version two events endpoint with an NFL football example, and I’ll highlight some useful parameters along the way.

NFL Odds API Guide

Here’s the reference docs on the /v2/events endpoint: /docs/reference#tag/events/GET/events/.

This gives you info on all the fields you can include in your requests. Most are optional.

Link to Postman Collection: /postman-collection

Odds Query Examples

If you want to fetch events with player props the easiest way would be this:

https://api.sportsgameodds.com/v2/events?apiKey=API_KEY_HERE&oddsAvailable=true&leagueID=NFL&limit=10

This returns you player props in addition to all of the other markets.

If you want to get more fine-grained with the specific NFL player props you want, you can do something like this:

https://api.sportsgameodds.com/v2/events?apiKey=API_KEY_HERE&oddsAvailable=true&leagueID=NFL&oddIDs=rushing_yards-PLAYER_ID-game-ou-over,rushing_yards-PLAYER_ID-game-ou-under

That will give you the over-unders on NFL rushing yards for all players. Note that the “PLAYER_ID” value is a special value which means “any playerID”, but if you swap PLAYER_ID with a specific player’s playerID then you’ll get odds for only that player like so:

https://api.sportsgameodds.com/v2/events?apiKey=API_KEY_HERE&oddsAvailable=true&leagueID=NFL&oddIDs=rushing_yards-JAMES_COOK_1_NFL-game-ou-over,rushing_yards-JAMES_COOK_1_NFL-game-ou-under

As you can see in those NFL football examples, you’re able to provide a comma separated list of any oddID values. The oddID values are basically a bet and they take the following format: {statID}-{statEntityID}-{periodID}-{betTypeID}-{sideID}

Here’s a guide from our docs which lists all of our supported markets: /docs/data-types/markets#football

A few extra notes:

• We highly recommend trimming down the list of oddIDs to only include the ones you’re actually interested in.
• We also recommend you include a bookmakerID param (ex: bookmakerID=fanduel,draftkings,prizepicks,underdog)
• The above two params will greatly speed up your response time
• By having the param includeOpposingOdds=true you make it so you only need to list the odds for the over sideID and it will automatically include the under odds too.
• You can also add includeAltLines=true to get the alt lines for each market but be careful about doing so as it can slow response times and increase response size.

Watch the video below for examples discussed above.

Next Steps

Now that you’ve seen how to query NFL data using our /v2/events endpoint, you’re ready to start experimenting with your own use cases. We recommend:

• Exploring more markets: Check out our Markets Guide for a full list of supported bet types.
• Testing with different bookmakers: Add the bookmakerID parameter to focus on the operators most relevant to your project.
• Optimizing queries: Use includeOpposingOdds=true and includeAltLines=true carefully to balance detail with performance.
• Building beyond NFL: Swap leagueID=NFL with any other supported league to unlock odds across 25+ sports and 55+ leagues.

If you’d like to dive deeper, here are some helpful links:

• Full API Reference
• SportsGameOdds SDK Guide
• Postman Collection
• Join Our Discord to connect with other developers and get support

And of course, if you have any questions, our support team is here to help.

Read More: MLB Odds API Guide | NBA Odds API Guide

Ready to get started?

Join thousands of developers building the next generation of sports and betting applications.

Get Your API KeyExplore the Docs