NFL Insights v1
API | API Version | Postman Collection |
Advanced Insights - NFL Insights | v1 |
Note: Authentication is required for all API calls. Authorization must be passed within the header of all calls to the API as: Authorization: {your_auth_token} |
require "uri" require "net/http" url = URI("https://api.radar360.sportradar.com/insights/v1/nfl?types=highs&index=50") https = Net::HTTP.new(url.host, url.port) https.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = "{your_auth_token}" response = https.request(request) puts response.read_body
import http.client conn = http.client.HTTPSConnection("api.radar360.sportradar.com") payload = '' headers = { 'Authorization': '{your_auth_token}' } conn.request("GET", "/insights/v1/nfl?types=highs&index=50", payload, headers) res = conn.getresponse() data = res.read() print(data.decode("utf-8"))
curl --location --request GET 'https://api.radar360.sportradar.com/insights/v1/nfl?types=highs&index=50' \ --header 'Authorization: {your_auth_token}'In addition to the URL parameters listed above, you can filter the insights with one or more of the following optional query string parameters. By default, the insights endpoint displays 50 results. To see more results use the index parameter.
Note: Optional query string parameters must be added after the URL with a question mark (?) and must be separated with an ampersand (&). |
Example: index=50 | | `pageSize` | Number to limit the number of results. Minimum value is 1, maximum value is 50.
Example: pageSize=10 | | `custom` | Comma delimited list of filters to display a subset of the results payload.
Example: custom=content,event | | `types` | Comma delimited list of insight types (expert_picks, game_notes, highs, leaderboards, lineup_changes, milestones, predictions, player_betting_trends, scoring, team_betting_trends) | | `typeIds` | Comma delimited list of insight type ids | | `statuses` | Comma delimited list of status keys (draft, suggestion, published) | | `sources` | Comma delimited list of source keys (advanced_insights, mocap, research) | | `sourceIds` | Comma delimited list of source ids | | `categories` | Comma delimited list of source keys (media, betting) | | `categoryIds` | Comma delimited list of source ids | | `lifecycles` | Comma delimited list of source keys (pre_game, in_game, post_game) | | `lifecycleIds` | Comma delimited list of source ids | | `playerIds` | Comma delimited list of player ids | | `playerSrIds` | Comma delimited list of player sr ids | | `playerUsIds` | Comma delimited list of player us ids | | `teamIds` | Comma delimited list of team ids | | `teamSrIds` | Comma delimited list of team sr ids | | `teamUsIds` | Comma delimited list of team us ids | | `gameIds` | Comma delimited list of game ids | | `gameSrIds` | Comma delimited list of game sr ids | | `gameUsIds` | Comma delimited list of game us ids | | `packagesIds` | Comma delimited list of package ids | ## Milestone Thresholds ```ruby require "uri" require "net/http" url = URI("https://api.radar360.sportradar.com/insights/thresholds/v1/nfl") https = Net::HTTP.new(url.host, url.port) https.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = "{your_auth_token}" response = https.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.radar360.sportradar.com") payload = '' headers = { 'Authorization': '{your_auth_token}' } conn.request("GET", "/insights/thresholds/v1/nfl", payload, headers) res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl --location --request GET 'https://api.radar360.sportradar.com/insights/thresholds/v1/nfl' \ --header 'Authorization: {your_auth_token}' ``` > The above command returns json structured like this. This endpoint retrieves Milestone Thresholds. https://api.radar360.sportradar.com/insights/thresholds/`{version}`/nfl Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `version` | Version number of the API you are accessing (Current Version: v1). | ## Frequently Asked Questions
Q: What is the Date format?
A: When we present date only values we present these in the ISO 8601 standard format.
ex: 2013-04-03
We use these for attributes that have date and no time (such as birthdate). For more information: https://en.wikipedia.org/wiki/ISO_8601
Q: What time zone are the date time fields presented in?
A: All of our Date/Time attributes are in UTC, presented in the ISO 8601 standard format.
ex: 2013-04-03T18:15:00+00:00
For more information: https://en.wikipedia.org/wiki/ISO_8601
Q: What is the benefit of using this API?
A: The Insights API allows you to access a variety of different Insight types all under one call, versus having to integrate with all the various individual Insight APIs.
Q: When should I expect to see Insights come through?
A: There are a number of Insights that populate each morning. Then, when games begin, Insights are generated in real-time.
Q: What career milestone thresholds are available?
A: We support the following career thresholds:
- career_player_passing_attempts
- career_player_passing_completions
- career_player_passing_yards
- career_player_passing_touchdowns
- career_player_passing_interceptions
- career_player_receptions
- career_player_targets
- career_player_receiving_yards
- career_player_receiving_touchdowns
- career_player_rushing_attempts
- career_player_rushing_yards
- career_player_rushing_touchdown
- career_player_defensive_sacks
- career_player_interceptions
- career_player_defensive_touchdowns
- career_player_total_tackles
- career_player_solo_tackles
- career_player_tackles_for_loss
- career_player_fumbles_forced
- career_player_defensive_hurries
- career_player_extra_points_made
- career_player_field_goals_made
Q: What season milestone thresholds are available?
A: We support the following season thresholds:
- season_player_passing_attempts
- season_player_passing_completions
- season_player_passing_yards
- season_player_passing_touchdowns
- season_player_passing_interceptions
- season_player_receptions
- season_player_targets
- season_player_receiving_yards
- season_player_receiving_touchdowns
- season_player_rushing_attempts
- season_player_rushing_yards
- season_player_rushing_touchdown
- season_player_defensive_sacks
- season_player_interceptions
- season_player_defensive_touchdowns
- season_player_total_tackles
- season_player_solo_tackles
- season_player_tackles_for_loss
- season_player_fumbles_forced
- season_player_defensive_hurries
- season_player_extra_points_made
- season_player_field_goals_made
Docs Navigation
- Documentation
- Football (American Football)
- Football (Soccer)
- Australian Rules Football
- Baseball
- Basketball
- Combat Sports
- Cricket
- Editorial Content
- Golf
- Handball
- Hockey
- Images
- Insights
- Betting Insights
- Odds
- Racing
- Rugby
- Tennis
- Baseline Sports Coverage
- Badminton v2
- Badminton v1
- Bandy v2
- Bandy v1
- Beach Soccer v2
- Beach Soccer v1
- Curling v2
- Curling v1
- Cycling v2
- Cycling v1
- Darts v2
- Darts v1
- Field Hockey v2
- Field Hockey v1
- Floorball v2
- Floorball v1
- Futsal v2
- Futsal v1
- Pesapallo v2
- Pesapallo v1
- Snooker v2
- Snooker v1
- Squash v2
- Squash v1
- Table Tennis v2
- Volleyball (Beach) v2
- Volleyball (Beach) v1
- Volleyball (Indoor) v2
- Volleyball (Indoor) v1
- Waterpolo v2
- Waterpolo v1
- Winter Sports v1