Restful API

We are providing direct access to our features via API so your application can use our data as the source. This is a white label of our data you can customize and display to fit your needs. Below are some example API requests that you can use to get started querying our data. Contact us for billing questions and to receive an example API key to start testing.

Download Postman to test our API
https://www.getpostman.com/downloads/

Value Picks

GET https://api.spreadknowledge.com/v1/valuepicks

Headers
  • apikey: [AddYourApiKeyHere]
  • Accept: application/json
Request parameters (query string)
  • sports: comma-separated list of sports (e.g. football,baseball,basketball)
  • leagues: comma-separated list of leagues (e.g. nba,mlb)
  • startDate: UTC date in the format YYYY-MM-DD (e.g. 2019-06-23)
  • endDate: UTC date in the format YYYY-MM-DD (e.g. 2019-06-25)
  • limit: number of records returned in the response. Default: 1000, Min: 0, Max: 10000
Example:

https://api.spreadknowledge.com/v1/valuepicks?sports=football,baseball&startDate=2019-06-02&endDate=2019-06-03&limit=100

Response Code: 200
Response Body
[  
   {  
      "GameId":751087,
      "Game":"Colorado Rockies vs Los Angeles Dodgers",
      "GamePickId":5409835,
      "GameTrendId":7042365,
      "SportId":2,
      "Sport":"Baseball",
      "LeagueId":2,
      "League":"MLB",
      "GameTime":"2019-06-23T20:10:00Z",
      "ValueGradeLetter": "B+",
      "ValueGradeScore": 0.425,
      "ValueGradeScoreWhole": 42,
      "ValueGradeScoreStars": 2.1,
      "AgreeingScore":0.2942743351133553,
      "AgreeingScoreDisplay":"+29%",
      "ConflictingScore":0.12582215492976498,
      "ConflictingScoreDisplay":"+12%",
      "OverallScore":0.29,
      "OverallScoreDisplay":"+29%",
      "OverallScoreMinusConflictingTrendScore":0.17,
      "OverallScoreMinusConflictingTrendScoreDisplay":"+17%",
      "TrendTypeId":2,
      "TrendTypeGroupDisplay":"WIN",
      "PickTypeId":2,
      "PickType":"Home to Win",
      "Pick":"Los Angeles Dodgers -200",
      "PickLine":1.5,
      "PickLineShort":"-200",
      "PickLineAmerican":"-200",
      "PickLineDecimal":"1.50",
      "PickPrice":1.5,
      "PickPriceAmerican":-200,
      "PickResult":"W",
      "PickNet":"5.00",
      "PickNetScore":"+20",
      "PickRecord":"5-0-0",
      "PickResults":"WWWWW",
      "PickTeamColorHex":"005A9C",
      "GameTrendXml":""
   },
   {  
      ...
   }
]

Games

GET https://api.spreadknowledge.com/v1/games

Headers
  • apikey: [AddYourApiKeyHere]
  • Accept: application/json
Request parameters (query string)
  • sports: comma-separated list of sports (e.g. football,baseball,basketball)
  • leagues: comma-separated list of leagues (e.g. nba,mlb)
  • startDate: UTC date in the format YYYY-MM-DD (e.g. 2019-06-23)
  • endDate: UTC date in the format YYYY-MM-DD (e.g. 2019-06-25)
  • limit: number of records returned in the response. Default: 1000, Min: 0, Max: 10000
Example:

https://api.spreadknowledge.com/v1/games?sports=football,baseball&startDate=2019-06-02&endDate=2019-06-03&limit=100

Response Code: 200
Response Body
[  
   {  
      "GameId":751240,
      "SportId":2,
      "Sport":"Baseball",
      "LeagueId":2,
      "League":"MLB",
      "GameTime":"2019-06-25T00:05:00Z",
      "Status":"Final",
      "Score":"3 - 8",
      "SwapTeams":false,
      "Away":{  
         "Name":"Atlanta Braves",
         "Code":"ATL",
         "ColorHex":"CE1141",
         "Winner":false
      },
      "Home":{  
         "Name":"Chicago Cubs",
         "Code":"CHC",
         "ColorHex":"0E3386",
         "Winner":true
      }
   },
   {  
      ...
   }
]

Sports

GET https://api.spreadknowledge.com/v1/sports

Headers
  • apikey: [AddYourApiKeyHere]
  • Accept: application/json
Response Code: 200
Response Body
[  
   {  
      "Id":1,
      "Name":"Basketball",
      "Code":"BASKETBALL"
   },
   {  
      "Id":2,
      "Name":"Baseball",
      "Code":"BASEBALL"
   },
   {  
      "Id":3,
      "Name":"Football",
      "Code":"AMERICAN_FOOTBALL"
   },
   {  
      "Id":4,
      "Name":"Hockey",
      "Code":"HOCKEY"
   }
]

Leagues

GET https://api.spreadknowledge.com/v1/leagues

Headers
  • apikey: [AddYourApiKeyHere]
  • Accept: application/json
Request parameters (query string)
  • limit: number of records returned in the response. Default: 1000, Min: 0, Max: 10000
Example:

https://api.spreadknowledge.com/v1/leagues?limit=100

Response Code: 200
Response Body
[  
   {  
      "Id":1,
      "ParentId":0,
      "SportId":1,
      "Name":"NBA",
      "Code":"NBA"
   },
   {  
      "Id":2,
      "ParentId":0,
      "SportId":2,
      "Name":"MLB",
      "Code":"MLB"
   }
]

Teams

GET https://api.spreadknowledge.com/v1/teams

Headers
  • apikey: [AddYourApiKeyHere]
  • Accept: application/json
Response Code: 200
Response Body
[  
   {  
      "Id":2,
      "Name":"Boston Celtics",
      "Code":"BOS",
      "SportId":1,
      "SportCode":"BASKETBALL",
      "LeagueId":1,
      "LeagueCode":"NBA"
   },
   {  
      ...
   }
]

Pick Cards

GET https://api.spreadknowledge.com/v1/pickcards

Headers
  • apikey: [AddYourApiKeyHere]
  • Accept: application/json
Request parameters (query string)
  • sports: comma-separated list of sports (e.g. football,baseball,basketball)
  • leagues: comma-separated list of leagues (e.g. nba,mlb)
  • startDate: UTC date in the format YYYY-MM-DD (e.g. 2019-06-23)
  • endDate: UTC date in the format YYYY-MM-DD (e.g. 2019-06-25)
  • limit: number of records returned in the response. Default: 1000, Min: 0, Max: 10000
Example:

https://api.spreadknowledge.com/v1/pickcards?sports=football,baseball&startDate=2019-06-02&endDate=2019-06-03&limit=25

Response Code: 200
Response Body
[  
{  
   "GameId":757367,
   "GameSpreadLiveId":0,
   "LeagueId":2,
   "League":"MLB",
   "Game":"Kansas City Royals vs Toronto Blue Jays",
   "GameNumberInDay":1,
   "GameRowCount":2,
   "GameTime":"2019-07-01T17:07:00Z",
   "GameTimePrimary":null,
   "GameTimeSecondary":null,
   "GameTimeTertiary":null,
   "Live":false,
   "SwapTeams":false,
   "GameLineFormatCd":"AMERICAN",
   "GameTeam":"Kansas City Royals",
   "GameTeamInfo":null,
   "GameTypeId":0,
   "GameTypeCd":"FULL_GAME",
   "GameTeamSuLine":134,
   "GameTeamSuLineDisplay":"+134",
   "GameTeamSuLineLive":0,
   "GameTeamSuLineLiveDisplay":null,
   "GameTeamSuLinePrice":2.34,
   "GameTeamSuLineLiveNet":"0.0",
   "GameTeamSuLineLiveNetDisplay":null,
   "GameTeamLine":1.5,
   "GameTeamLineDisplay":"+1.5",
   "GameTeamLineLive":0,
   "GameTeamLineLiveDisplay":null,
   "GameTeamLinePriceDisplay":"(-139)",
   "GameTeamLinePrice":1.72,
   "GameTeamLineLiveNet":"0.0",
   "GameTeamLineLiveNetDisplay":null,
   "GameTotalOu":11.5,
   "GameTotalOuLineDisplay":"11.5",
   "GameTotalOuLineLive":0,
   "GameTotalOuLineLiveDisplay":null,
   "GameTotalOuLinePrice":1.93,
   "GameTotalOuLineLiveNet":"0.0",
   "GameTotalOuLineLiveNetDisplay":null,
   "PickIdSu":5473573,
   "PickSuTrendScore":0.05,
   "PickSuCount":0,
   "PickSuPerc":0,
   "PickSuWinPerc":0.43,
   "PickSuRecord":"2-3-0",
   "PickSuStreakResults":"W1",
   "PickSuResults":"WLLLW",
   "PickSuNetScore":0,
   "PickSuNetScoreDisplay":null,
   "PickIdAts":5473575,
   "PickAtsTrendScore":0.07,
   "PickAtsCount":1,
   "PickAtsPerc":1,
   "PickAtsWinPerc":0.58,
   "PickAtsRecord":"2-3-0",
   "PickAtsStreakResults":"W1",
   "PickAtsResults":"WLLLW",
   "PickAtsNetScore":0,
   "PickAtsNetScoreDisplay":null,
   "PickIdOu":5473577,
   "PickOuTrendScore":0.08,
   "PickOuCount":0,
   "PickOuPerc":0,
   "PickOuWinPerc":0.52,
   "PickOuRecord":"4-2-0",
   "PickOuStreakResults":"W4",
   "PickOuResults":"WWWWLL",
   "PickOuNetScore":0,
   "PickOuNetScoreDisplay":null,
   "PickTrendNetHighetsRank":"Under 11.5",
   "PickTrendNetHighestId":5473578,
   "AwayTeamId":46,
   "TeamColorHexAway":"004687",
   "HomeTeamId":63,
   "TeamColorHexHome":"134A8E",
   "GameAwayScore":0,
   "GameAwayScoreSecondary":0,
   "GameAwayScoreTertiary":0,
   "GameHomeScore":0,
   "GameHomeScoreSecondary":0,
   "GameHomeScoreTertiary":0
},
{  
   ...
}
]

Sports filter

Here is the list of the most popular sports which can be passed as a comma-separated list in the request

  • football
  • basketball
  • baseball
  • hockey
  • tennis
  • soccer

Leagues filter

Here is the list of the most popular leagues which can be passed as a comma-separated list in the request

  • nba
  • mlb
  • nfl
  • ncaafootball
  • ncaabasketball
  • nhl
  • wnba

Related pages
Our pricing page is located here simply click on “Business” to see our enterprise API pricing.