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

  • 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

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":""
   },
   {  
      ...
   }
]

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

  • 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

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
      }
   },
   {  
      ...
   }
]

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

  • 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"
   }
]

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

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

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"
   }
]

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

  • 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

  • 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

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.

Last updated byPaul