All Insights v1

Frequently Asked Questions
API API Version
Advanced Insights - All 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_api_key}
## Insight by Id > The API returns json structured like this. This endpoint retrieves Insight by Id. https://api.radar360.sportradar.com/insights/`{version}`/`{sport}`/`{insight_id}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `version` | Version number of the API you are accessing (Current Version: v1). | | `sport` | Abbreviation for the specified sport: mlb, nfl, nba, and nhl. | | `insight_id` | Id of a given insight. | ## Insight Package by Id > The API returns json structured like this. This endpoint retrieves Insight Package by Id. https://api.radar360.sportradar.com/insights/`{version}`/`{sport}`/packages/`{package_id}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `version` | Version number of the API you are accessing (Current Version: v1). | | `sport` | Abbreviation for the specified sport: mlb, nfl, nba, and nhl. | | `package_id` | Id of a given package. | ## Insight Packages > The API returns json structured like this. This endpoint retrieves Insight Package by Id. https://api.radar360.sportradar.com/insights/`{version}`/`{sport}`/packages Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `version` | Version number of the API you are accessing (Current Version: v1). | | `sport` | Abbreviation for the specified sport: mlb, nfl, nba, and nhl. | ## Insights > The API returns json structured like this. This endpoint retrieves Insights. https://api.radar360.sportradar.com/insights/`{version}`/`{sport}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `version` | Version number of the API you are accessing (Current Version: v1). | | `sport` | Abbreviation for the specified sport: mlb, nfl, nba, and nhl. | ## 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 All 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. If you're looking to just get the text component of the Insight, this is the API for you. If you're looking to do more detailed filtering, want the raw data, etc, then you should use the various APIs for the individual Insight types.

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.

Return to top

Docs Navigation