This article explains how SportsDataIO's original sportsbook implementation works, and why it was enhanced with Sportsbook Groups, and how to get the best of our odds offering via Sportsbook Group endpoints
Background
When we launched our odds product, we started with a small number of books and flat endpoints that only deliver basic game line information. As we added more sportsbooks, these endpoints and their back end data structures remained lightweight.
However, as we expanded our Aggregated Odds offering to include props and futures, the data structure became much more heavy and robust. Adding more books, too, caused what was once lightweight to become more challenging to deliver quickly.
We wanted to continue adding more sportsbooks, more markets, and faster odds, but knew our underlying structure had to change to accommodate them.
That's where Sportsbook Groups came in. We created a grouping structure and endpoints to access them that allow us to add a notionally unlimited number of books and markets without causing any slowdown for our users.
The Sportsbook Group Advantage
Our old, non-Sportsbook Group endpoints are not going anywhere. Many clients are happy with them and have been using them for years. But we encourage everyone to switch to Sportsbook Group endpoints when they can, because:
- New Sportsbooks: Our By Sportsbook Group endpoints are the only place to find lines from recently-added books such as Pinnacle, Circa, and Bookmaker.eu.
- Speed and Reliability: We have built these endpoints and their cache timings to be as efficient as possible, and these will offer the best service going forward.
- Flexibility: Want to add more books to your contract? Want to work with our sales team on a custom proposal for the books of your choice? Our groups are flexible enough to accommodate what you want, whereas our legacy odds endpoints give a pre-set selection of books that will not expand.
Sportsbook Availability
See this table for sportsbooks that can be found in our old endpoints, and those that are only available via the Sportsbook Group endpoints.
All Old Endpoints Only sportsbooks are available in Sportsbook Group endpoints too, meaning you can call just the Sportsbook Group endpoints to get all books!
Old Endpoints Only | Sportsbook Group Endpoints |
Consensus |
All Old Endpoints' books, plus... |
Implementing Our By Sportsbook Group Endpoints
Ready to move over to our new By Sportsbook Group endpoints? It's easy:
- Our old, non-Sportsbook Group endpoints are identical in structure and implementation to our new By Sportsbook Group ones except for one change: you include the sportsbook group of your choice in the URL.
- You may choose to use these for simplicity's sake but bear in mind you will be unable to access any newly-added sportsbooks.
- The new Sportsbook Group endpoints are available to anyone with a Universal Key.
- Your sales rep will give you the group IDs associated with your account and can help you sign up for exciting new books, too.
- The non-grouped endpoints look like this:
- Format:
- /BettingMarketsByEvent/{eventid}?key={YourKey}
- Example:
- /BettingMarketsByEvent/12345?key=abc123efg456hij789
- Format:
- But the grouped ones are simple to use with just the additional sportsbookgroupID:
- Format:
- /BettingMarketsByEvent/{eventid}/{sportsbookgroup}?key={YourKey}
- Example:
- /BettingMarketsByEvent/12345/G1002?key=abc123efg456hij789
- Format:
- Repeat the call as many times as required to accommodate all the groups you have access to and that you want to call.
- Coming soon: Ability to see which sportsbook groups you have access to from within your My Account section. For now, your sales staff will advise via email.
- Coming soon: Ability to select the sportsbook groups you have access to from a dropdown within the API Documentation for the endpoint you are accessing.
Comments
0 comments
Please sign in to leave a comment.