By therundown
Updated 3 months ago

TheRundown API Documentation

API Documentation: Real-time odds and scores from major sportsbooks. NFL, NBA, WNBA, MLB, NHL, NCAA Football, & NCAA Basketball with more sports soon. Over a dozen sportsbooks currently integrated: 5Dimes, Pinnacle, Matchbook, Betcris, Lowvig, TheGreek, YouWager, Justbet, Tigergaming, Betonline, Bookmaker, Sportsbetting, Intertops & more coming soon. Moneyline, Spread, & Total for full-games, 1st half, 2nd half, 1st Quarter/Period, 2nd Quarter/Period, 3rd Quarter/Period, and 4th Quarter/Period with more markets coming soon. See more at

Learn more about this API
Affiliates (Sportsbooks)
GETAffiliates (Sportsbooks)
GETDates by sport
Events (Odds)
GETEvents by Sport by Date
GETEvents by Sport
GETOpeners by Sport by Date
GETDelta (Changed Events)
GETMoneyline by Line Identifier
GETSpread by Line Identifier
GETTotals by Line Identifier
GETEvents by Sport

The /sports/{sport-id}/events endpoint can be used to request events for a single sport. Only events that have not yet started will be returned from this endpoint. To get events that have also started, use the /sports/{sport-id}/events/{date} endpoint to request events for a particular sport on a particular date. Specifying optional include values may be used to get lines for all markets (instead of just full-game by default) in addition to scores or the team names from specific sportsbooks. To request multiple, simply add multiple values and duplicate the include= parameter in the request like so: &include=allperiods&include=scores. When include=allperiods is used, the key for the lines changes from lines to line_periods. An optional offset in minutes from UTC may be sent in the request to group events by date with an offset. For example, if you are in CDT and want to see events grouped by date in CDT, then specify ?offset=300. Any value of 0.0001 represents the value NotPublished. This means that the sportsbook currently has not published a price or odds for this wager, or that the line was removed.

Header Parameters
Required Parameters
REQUIREDThe sport-id of the events to return. See the /sports endpoint to get a list of sport-ids.
Optional Parameters
OPTIONAL(Optional) Specifies whether the response should include all available markets (halves/quarters/periods) instead of just full-game by default.
OPTIONAL(Optional) Specifies whether the response should include scores, status, and other game information.
Code Snippet
Install SDK
Response ExampleSchema

Install SDK for (Node.js)Unirest

OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication