NFL Next Generation Stats v1
Frequently Asked Questions
## Feed Availability
We package NGS data feeds into 3 distinct offerings. The content and timeliness of the data varies between packages. Below is a table that illustrates the packages and the feeds available in each. To see the timeliness of the data, see the details for each feed.
## Game Leaders
> To generate the Game Leaders replace {your_api_key} with your API key:
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nfl-ngs-t1/games/25fde8b4-6e4e-468c-ba0a-a511530a303c/leaders.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nfl-ngs-t1/games/25fde8b4-6e4e-468c-ba0a-a511530a303c/leaders.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nfl-ngs-t1/games/25fde8b4-6e4e-468c-ba0a-a511530a303c/leaders.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Game Leaders feed by replacing the parameters in the following URL:
https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/games/`{game_id}`/leaders.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as trial (t), or production (p). |
| `version` | Version number of the API you are accessing (current version: 1). |
| `game_id` | ID of a given game. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
## Game Play-By-Play
> To generate the Game Play-By-Play for the Game ID below replace {your_api_key} with your API key:
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nfl-ngs-t1/games/25fde8b4-6e4e-468c-ba0a-a511530a303c/pbp.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nfl-ngs-t1/games/25fde8b4-6e4e-468c-ba0a-a511530a303c/pbp.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nfl-ngs-t1/games/25fde8b4-6e4e-468c-ba0a-a511530a303c/pbp.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the boxscore information for a specific game.
https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/games/`{game_id}`/pbp.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as trial (t), or production (p). |
| `version` | Version number of the API you are accessing (current version: 1). |
| `game_id` | ID of a given game. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
## Game Play-By-Play+ (plus)
> To generate the Game Play-By-Play+ for the Game ID below replace {your_api_key} with your API key:
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nfl-ngs-t1/games/25fde8b4-6e4e-468c-ba0a-a511530a303c/tracked_pbp.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nfl-ngs-t1/games/25fde8b4-6e4e-468c-ba0a-a511530a303c/tracked_pbp.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nfl-ngs-t1/games/25fde8b4-6e4e-468c-ba0a-a511530a303c/tracked_pbp.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Play-by-Play+ information for a specific game.
https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/games/`{game_id}`/tracked_pbp.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as trial (t), or production (p). |
| `version` | Version number of the API you are accessing (current version: 1). |
| `game_id` | ID of a given game. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
## Game Statistics
> To generate the Game Statistics for the Game ID below replace {your_api_key} with your API key:
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nfl-ngs-t1/games/25fde8b4-6e4e-468c-ba0a-a511530a303c/statistics.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nfl-ngs-t1/games/25fde8b4-6e4e-468c-ba0a-a511530a303c/statistics.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nfl-ngs-t1/games/25fde8b4-6e4e-468c-ba0a-a511530a303c/statistics.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the game statistics for a specific game.
https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/games/`{game_id}`/statistics.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as trial (t), or production (p). |
| `version` | Version number of the API you are accessing (current version: 1). |
| `game_id` | ID of a given game. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
## League Leaders
> To generate the League Leaders for the season below replace {your_api_key} with your API key:
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nfl-ngs-t1/seasontd/2016/reg/leaders.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nfl-ngs-t1/seasontd/2016/reg/leaders.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nfl-ngs-t1/seasontd/2016/reg/leaders.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the league leaders for a specific season.
https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/seasontd/`{year}`/`{nfl_season}`/leaders.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as trial (t), or production (p). |
| `version` | Version number of the API you are accessing (current version: 1). |
| `year` | Year in 4 digit format (YYYY). |
| `nfl_season` | Preseason (pre), Regular Season (reg), Postseason (pst). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
## Play Statistics
> To generate Play Statistics replace {your_api_key} with your API key:
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nfl-ngs-t1/plays/83983e8b-bdd9-46bb-b150-7d0808b827aa/statistics.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nfl-ngs-t1/plays/83983e8b-bdd9-46bb-b150-7d0808b827aa/statistics.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nfl-ngs-t1/plays/83983e8b-bdd9-46bb-b150-7d0808b827aa/statistics.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves play statistics.
https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/plays/`{play_id}`/statistics.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as trial (t), or production (p). |
| `version` | Version number of the API you are accessing (current version: 1). |
| `play_id` | ID of a given play. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
## Play Statistics+ (plus)
> To generate Play Statistics+ replace {your_api_key} with your API key:
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nfl-ngs-t1/plays/83983e8b-bdd9-46bb-b150-7d0808b827aa/tracked_statistics.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nfl-ngs-t1/plays/83983e8b-bdd9-46bb-b150-7d0808b827aa/tracked_statistics.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nfl-ngs-t1/plays/83983e8b-bdd9-46bb-b150-7d0808b827aa/tracked_statistics.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves play statistics+.
https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/plays/`{play_id}`/tracked_statistics.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as trial (t), or production (p). |
| `version` | Version number of the API you are accessing (current version: 1). |
| `play_id` | ID of a given play. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
## Play Tracking Statistics
> To generate the Play Tracking Statistics for the Play ID below replace {your_api_key} with your API key:
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nfl-ngs-t1/tracking/7f844ff2-bf53-4dd9-b68f-3bff58226978/tracking.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nfl-ngs-t1/tracking/7f844ff2-bf53-4dd9-b68f-3bff58226978/tracking.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nfl-ngs-t1/tracking/7f844ff2-bf53-4dd9-b68f-3bff58226978/tracking.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Play Tracking Statistics for a specific play.
https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/tracking/`{play_id}`/tracking.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as trial (t), or production (p). |
| `version` | Version number of the API you are accessing (current version: 1). |
| `play_id` | ID of a given play. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
## Player Participation
Participation Data is complementary data collected by the NFL that indicates all 22 players on the field for every play of every game.
> To generate Participation Data replace {your_api_key} with your API key:
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nfl-ngs-t1/participation/b7aeb58f-7987-4202-bc41-3ad9a5b83fa4/participation.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nfl-ngs-t1/participation/b7aeb58f-7987-4202-bc41-3ad9a5b83fa4/participation.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nfl-ngs-t1/participation/b7aeb58f-7987-4202-bc41-3ad9a5b83fa4/participation.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Participation feed by replacing the parameters in the following URL:
https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/participation/`{game_id}`/participation.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as trial (t), or production (p). |
| `version` | Version number of the API you are accessing (current version: 1). |
| `game_id` | ID of a given game. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
## Player Seasonal Statistics
> To generate a Player Seasonal Statistics for the Player ID below replace {your_api_key} with your API key:
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nfl-ngs-t1/players/2016/reg/91fc931a-acff-46d1-8233-182ce9635740/statistics.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nfl-ngs-t1/players/2016/reg/91fc931a-acff-46d1-8233-182ce9635740/statistics.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nfl-ngs-t1/players/2016/reg/91fc931a-acff-46d1-8233-182ce9635740/statistics.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Player Seasonal Statistics for a specific player.
https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/players/`{year}`/`{nfl_season}`/`{player_id}`/statistics.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as trial (t), or production (p). |
| `version` | Version number of the API you are accessing (current version: 1). |
| `year` | Year in 4 digit format (YYYY). |
| `nfl_season` | Preseason (pre), Regular Season (reg), Postseason (pst). |
| `player_id` | ID for a given player. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
## Team Leaders
> To generate the Team Leaders for the Season and Year below replace {your_api_key} with your API key:
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nfl-ngs-t1/seasontd/2016/reg/33405046-04ee-4058-a950-d606f8c30852/leaders.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nfl-ngs-t1/seasontd/2016/reg/33405046-04ee-4058-a950-d606f8c30852/leaders.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nfl-ngs-t1/seasontd/2016/reg/33405046-04ee-4058-a950-d606f8c30852/leaders.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Team Leaders for a team in a specific season.
https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/seasontd/`{year}`/`{nfl_season}`/`{team_id}`/leaders.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as trial (t), or production (p). |
| `version` | Version number of the API you are accessing (current version: 1). |
| `year` | Year in 4 digit format (YYYY). |
| `nfl_season` | Preseason (pre), Regular Season (reg), Postseason (pst). |
| `team_id` | ID for a given team. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
## Team Seasonal Statistics
> To generate the Team Seasonal Statistics for the Year and Season below replace {your_api_key} with your API key:
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nfl-ngs-t1/teams/2016/reg/33405046-04ee-4058-a950-d606f8c30852/statistics.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nfl-ngs-t1/teams/2016/reg/33405046-04ee-4058-a950-d606f8c30852/statistics.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nfl-ngs-t1/teams/2016/reg/33405046-04ee-4058-a950-d606f8c30852/statistics.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Team Seasonal Statistics for a season.
https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/teams/`{year}`/`{nfl_season}`/`{team_id}`/statistics.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as trial (t), or production (p). |
| `version` | Version number of the API you are accessing (current version: 1). |
| `year` | Year in 4 digit format (YYYY). |
| `nfl_season` | Preseason (pre), Regular Season (reg), Postseason (pst). |
| `team_id` | ID for a given team. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
## Weekly League Leaders
> To generate the Weekly Leaders for the week below replace {your_api_key} with your API key:
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nfl-ngs-t1/seasontd/2016/reg/02/leaders.xml?api_key={your_api_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body
```
```python
import http.client
conn = http.client.HTTPSConnection("api.sportradar.us")
conn.request("GET", "/nfl-ngs-t1/seasontd/2016/reg/02/leaders.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
```shell
curl -X GET "https://api.sportradar.us/nfl-ngs-t1/seasontd/2016/reg/02/leaders.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Weekly Leaders.
https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/seasontd/`{year}`/`{nfl_season}`/`{week}`/leaders.`{format}`?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as trial (t), or production (p). |
| `version` | Version number of the API you are accessing (current version: 1). |
| `year` | Year in 4 digit format (YYYY). |
| `nfl_season` | Preseason (pre), Regular Season (reg), Postseason (pst). |
| `week` | Week in 2 digit format (WW). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
## Frequently Asked Questions
| API | API Version |
| NFL Next Generation Stats | v1 |
| Note: Authentication is required for all API calls. |
| Note: The NFL is not providing NGS tracking data for the Hall of Fame between Arizona and Dallas. NGS tracking data will be available for all other preseason games. |
| Note: To use NFL Next Generation Stats API you must also have access to the NFL API. |
| Game Leaders | |||
| Game Play-By-Play | |||
| Game Play-By-Play+ | |||
| Game Statistics | |||
| League Leaders | |||
| Play Statistics | |||
| Play Statistics+ | |||
| Play Tracking Statistics | |||
| Player Participation | |||
| Player Seasonal Statistics | |||
| Team Leaders | |||
| Team Seasonal Statistics | |||
| Weekly League Leaders |
| Update Frequency: | Real-time | ||
| Content Type: | XML or JSON | ||
| Game Leaders Data Points: | Leader Description Leader Id |
Player Id Player Leader Rank |
Player Leader Value Players Type (Position) |
| Game Info Data Points: | Id Scheduled Date/Time |
Type Week |
Year |
| Player Info Data Points: | First Name Id |
Last Name Position |
Position Group |
| Team Info Data Points: | Alias Id |
Name | Type |
| Play-by-Play Data Points: | Play Clock Play Description Play Down Play Id |
Play Possessing Team Play Quarter Play Type |
Yardline Yardline Side Yards to 1st Down |
| Update Frequency: | Real-time | ||
| Content Type: | XML or JSON | ||
| Game Info Data Points: | Away Team Alias Away Team Id Away Team Name Away Team Personnel Away Team Side Away Team Type |
Home Team Alias Home Team Id Home Team Name Home Team Personnel Home Team Side Home Team Type |
Id Scheduled Date Type Week Year |
| League Info Data Points: | Season | Season Type | Week |
| Play-By-Play Data Points: | Event Play Type Event Sequence Event Time Play Clock Play Deleted Play Description Play Down |
Play Flags Penalty on Play Play Flags Quarter Over Play Flags Scoring Play Play Flags Specials Team Play Play Id Play Possessing Team |
Play Quarter Play Type Play Yardline Play Yardline Side Play Yards to 1st Down |
| Play Details Data Points: | Distance Covered Jogging Distance Covered Receiving Distance Covered Running Distance Covered Rushing Distance Covered Special Teams Distance Covered Sprinting Distance Covered Total Distance Covered Walking Dist. Covered (Ball Carrier) - Receiving Plays Dist. Covered (Ball Carrier) - Rushing Plays |
Dist. Covered (Ball Carrier) - Special Teams Plays Dist. Covered (Ball Carrier) - Total Flags Defender in Box Flags Is Ball Carrier Flags Is Official Flags Is On Route Flags Is Receiver Flags Nearest to QB at Throw Flags Participation Official Flags Pass Rusher Flags Performance Official Location Distance to QB at Throw |
Location Lineup Left/Right of Center Location Lineup Location Type Passer Air Distance Passer Dropback Distance Passer Dropback Type Passer Intended Air Distance Passer Pass Location Passer Time to Throw Receiver Separation at Catch Receiver Separation at Pass Speed Average Speed Maximum |
| Player Info Data Points: | First Name Id |
Last Name Position |
Position Group |
| Update Frequency: | Real-time | ||
| Content Type: | XML or JSON | ||
| Game Info Data Points: | Away Team Alias Away Team Id Away Team Name Away Team Personnel Away Team Side Away Team Type |
Home Team Alias Home Team Id Home Team Name Home Team Personnel Home Team Side Home Team Type |
Id Scheduled Date Type Week Year |
| League Info Data Points: | Season | Season Type | Week |
| Play-By-Play Data Points: | Event Play Type Event Sequence Event Time Play Clock Play Deleted Play Description Play Down |
Play Flags Penalty on Play Play Flags Quarter Over Play Flags Scoring Play Play Flags Specials Team Play Play Id Play Possessing Team |
Play Quarter Play Type Play Yardline Play Yardline Side Play Yards to 1st Down |
| Play Details Data Points: | Distance Covered Jogging Distance Covered Receiving Plays Distance Covered Running Distance Covered Rushing Plays Distance Covered Special Teams Plays Distance Covered Sprinting Distance Covered Total Distance Covered Walking Dist. Covered (Ball Carrier) - Receiving Plays Dist. Covered (Ball Carrier) - Rushing Plays Dist. Covered (Ball Carrier) - Special Teams Plays Dist. Covered (Ball Carrier) - Total Flags Defender in Box |
Flags Is Ball Carrier Flags Is Official Flags Is On Route Flags Is Receiver Flags Nearest to QB at Throw Flags Participation Official Flags Pass Rusher Flags Performance Official Location Distance to QB at Throw Location Lineup Left/Right of Center Location Lineup Location Type Passer Air Distance Passer Dropback Distance Passer Dropback Type |
Passer Intended Air Distance Passer Pass Location Passer Time to Throw Receiver Separation at Catch Receiver Separation at Pass Speed Average Speed Maximum Tracking - Player Id Tracking - Player First Name Tracking - Player Last Name Tracking - Player Position Tracking - Player Position Group Tracking - Location X Coordinate Tracking - Location Y Coordinate |
| Player Info Data Points: | First Name Id |
Last Name Position |
Position Group |
| Update Frequency: | Real-time | ||
| Content Type: | XML or JSON | ||
| Game Info Data Points: | Away Team Alias Away Team Id Away Team Name Away Team Type |
Home Team Alias Home Team Id Home Team Name Home Team Type |
Id Scheduled Date Type Week Year |
| Player Info Data Points: | First Name Id |
Last Name Position |
Position Group |
| Player Game Statistics Data Points: | Defense High Safety Defense Time to Sack Defense Defender in Box Defense Pass Rusher Defense Location Total Defense Location Type Distance Covered Jogging Distance Covered Receiving Plays Distance Covered Running Distance Covered Rushing Plays Distance Covered Special Teams Plays Distance Covered Sprinting Distance Covered Total Distance Covered Walking Distance Covered (Ball Carrier) Receiving Plays Distance Covered (Ball Carrier) Rushing Plays |
Distance Covered (Ball Carrier) Special Teams Plays Distance Covered (Ball Carrier) Total Offense Formation Total Offense Formation Type Offense Location Total Offense Location Type Offense Receiver Offense Receiver on Route Passing Air Distance Passing Dropback Distance Passing Intended Air Distance Passing Time to Throw Passing Dropback Total Passing Dropback Type Passing Location Total Passing Location Type |
Play Participation Defense Play Participation Offense Play Participation Receiving Plays Play Participation Rushing Plays Play Participation Special Teams Plays Play Participation Total Plays with Ball Receiving Plays Plays with Ball Rushing Plays Plays with Ball Special Teams Plays Plays with Ball Total Speed Average Speed Maximum Touches Receiving Touches Rushing Touches Special Teams |
| Team Game Statistics Data Points: | Defense High Safety Defense Time to Sack Defense Defender in Box Defense Pass Rusher Defense Location Total Defense Location Type Defensive Plays Receiving Defensive Plays Rushing Defensive Plays Total Dist. Covered by Position - Average Dist. Covered by Position - Position Id Dist. Covered by Position - Total Distance Covered by Defense - Average Distance Covered by Defense - Total Distance Covered by Offense - Average Distance Covered by Offense - Total Offense Formation Total Offense Formation Type |
Offense Location Total Offense Location Type Offense Receiver Offense Receiver on Route Offensive Plays Receiving Offensive Plays Rushing Offensive Plays Total Passing Air Distance Passing Dropback Distance Passing Intended Air Distance Passing Time to Throw Passing Dropback Total Passing Dropback Type Passing Location Total Passing Location Type Play Groups - Defense Distance Covered - Average Play Groups - Defense Distance Covered - Total |
Play Groups - Defense Play Types - Other Play Groups - Defense Play Types - Receiving Play Groups - Defense Play Types - Rushing Play Groups - Defense Play Types - Total Play Groups - Defense Yards Gained - Receiving Play Groups - Defense Yards Gained - Rushing Play Groups - Defense Yards Gained - Total Play Groups - Name Play Groups - Offense Distance Covered - Average Play Groups - Offense Distance Covered - Total Play Groups - Offense Play Types - Other Play Groups - Offense Play Types - Receiving Play Groups - Offense Play Types - Rushing Play Groups - Offense Play Types - Total Play Groups - Offense Yards Gained - Receiving Play Groups - Offense Yards Gained - Rushing Play Groups - Offense Yards Gained - Total |
| Update Frequency: | Post-game | ||
| Content Type: | XML or JSON | ||
| League Info Data Points: | Season | Season Type | Week |
| League Leaders Data Points: | Leader Description Leader Id |
Player Id Player Leader Rank |
Player Leader Value Players Type (Position) |
| Game Info Data Points: | Id Scheduled Date/Time |
Type Week |
Year |
| Player Info Data Points: | First Name Id |
Last Name Position |
Position Group |
| Team Info Data Points: | Alias Id |
Name | Type |
| Play-by-Play Data Points: | Play Clock Play Description Play Down Play Id |
Play Possessing Team Play Quarter Play Type |
Yardline Yardline Side Yards to 1st Down |
| Update Frequency: | Real-time | ||
| Content Type: | XML or JSON | ||
| Game Info Data Points: | Away Team Alias Away Team Id Away Team Name Away Team Personnel Away Team Side Away Team Type |
Home Team Alias Home Team Id Home Team Name Home Team Personnel Home Team Side Home Team Type |
Id Scheduled Date Type Week Year |
| League Info Data Points: | Season | Season Type | Week |
| Play-By-Play Info Data Points: | Event Play Type Event Sequence Event Time Play Clock Play Deleted Play Description Play Down |
Play Flags Penalty on Play Play Flags Quarter Over Play Flags Scoring Play Play Flags Specials Team Play Play Id Play Possessing Team |
Play Quarter Play Type Play Yardline Play Yardline Side Play Yards to 1st Down |
| Play Details Data Points: | Distance Covered Jogging Distance Covered Receiving Distance Covered Running Distance Covered Rushing Distance Covered Special Teams Distance Covered Sprinting Distance Covered Total Distance Covered Walking Dist. Covered (Ball Carrier) - Receiving Plays Dist. Covered (Ball Carrier) - Rushing Plays |
Dist. Covered (Ball Carrier) - Special Teams Plays Dist. Covered (Ball Carrier) - Total Flags Defender in Box Flags Is Ball Carrier Flags Is Official Flags Is On Route Flags Is Receiver Flags Nearest to QB at Throw Flags Participation Official Flags Pass Rusher Flags Performance Official Location Distance to QB at Throw |
Location Lineup Left/Right of Center Location Lineup Location Type Passer Air Distance Passer Dropback Distance Passer Dropback Type Passer Intended Air Distance Passer Pass Location Passer Time to Throw Receiver Separation at Catch Receiver Separation at Pass Speed Average Speed Maximum |
| Player Info Data Points: | First Name Id |
Last Name Position |
Position Group |
| Update Frequency: | Real-time | ||
| Content Type: | XML or JSON | ||
| Game Info Data Points: | Away Team Alias Away Team Defender in Box Away Team Formation Away Team High Safety Away Team Id Away Team Name Away Team Pass Rusher Away Team Personnel Away Team Receiver Away Team Receiver on Route |
Away Team Side Away Team Type Home Team Alias Home Team Defender in Box Home Team Formation Home Team High Safety Home Team Id Home Team Name Home Team Pass Rusher Home Team Personnel |
Home Team Receiver Home Team Receiver on Route Home Team Side Home Team Type Id Scheduled Date Type Week Year |
| Play-By-Play Info Data Points: | Event Play Type Event Sequence Event Time Play Clock Play Deleted Play Description Play Down |
Play Flags Penalty on Play Play Flags Quarter Over Play Flags Scoring Play Play Flags Specials Team Play Play Id Play Possessing Team |
Play Quarter Play Type Play Yardline Play Yardline Side Play Yards to 1st Down |
| Play Details Data Points: | Distance Covered Jogging Distance Covered Receiving Plays Distance Covered Running Distance Covered Rushing Plays Distance Covered Special Teams Plays Distance Covered Sprinting Distance Covered Total Distance Covered Walking Dist. Covered (Ball Carrier) - Receiving Plays Dist. Covered (Ball Carrier) - Rushing Plays Dist. Covered (Ball Carrier) - Special Teams Plays Dist. Covered (Ball Carrier) - Total Flags Defender in Box |
Flags Is Ball Carrier Flags Is Official Flags Is On Route Flags Is Receiver Flags Nearest to QB at Throw Flags Pass Rusher Location Distance to QB at Throw Location Lineup Left/Right of Center Location Lineup Location Type Passer Air Distance Passer Dropback Distance Passer Dropback Type |
Passer Intended Air Distance Passer Pass Location Passer Time to Throw Receiver Separation at Catch Receiver Separation at Pass Speed Average Speed Maximum Tracking - Player Id Tracking - Player First Name Tracking - Player Last Name Tracking - Player Position Tracking - Player Position Group Tracking - Location X Coordinate Tracking - Location Y Coordinate |
| Player Info Data Points: | First Name Id |
Last Name Position |
Position Group |
| Update Frequency: | Real-time | ||
| Content Type: | XML or JSON | ||
| Game Info Data Points: | Away Team Alias Away Team Defender in Box Away Team Formation Away Team High Safety Away Team Id Away Team Name Away Team Pass Rusher Away Team Personnel Away Team Receiver Away Team Receiver on Route |
Away Team Side Away Team Type Home Team Alias Home Team Defender in Box Home Team Formation Home Team High Safety Home Team Id Home Team Name Home Team Pass Rusher Home Team Personnel |
Home Team Receiver Home Team Receiver on Route Home Team Side Home Team Type Id Scheduled Date Type Week Year |
| Play-By-Play Info Data Points: | Play Clock Play Deleted Play Description Play Down Play Flags Penalty on Play Play Flags Quarter Over |
Play Flags Scoring Play Play Flags Specials Team Play Play Id Play Possessing Team Play Quarter |
Play Type Play Yardline Play Yardline Side Play Yards to 1st Down |
| Play Details Data Points: | Location Direction Location Distance Location Speed |
Location Time Location Type |
X Coordinate Y Coordinate |
| Player Info Data Points: | First Name Id |
Last Name Position |
Position Group |
| Update Frequency: | Real-time | ||
| Content Type: | XML or JSON | ||
| Game Info Data Points: | Away Team Alias Away Team Id Away Team Name |
Home Team Alias Home Team Id Home Team Name |
Id Status |
| League Information Data Points: | Season Season Name |
Season Type Week |
Week Sequence |
| Play-By-Play Data Points: | Play Clock Play Deleted |
Play Description Play Id |
Play Type Sequence |
| Player Information Data Points: | Id Name |
Position Position Group |
Reference |
| Venue Data Points: | Address Capacity City Country |
Id Name Roof Type |
State Surface Zip |
| Update Frequency: | Post-game | ||
| Content Type: | XML or JSON | ||
| League Info Data Points: | Season | Season Type | |
| Player Info Data Points: | First Name Id |
Last Name Position |
Position Group |
| Seasonal Player Statistics Data Points: | Defense - High Safety Defense - Time to Sack Defense - Defender in Box Defense - Pass Rusher Defense - Location Total Defense - Location Type Distance Covered - Jogging Distance Covered - Receiving Plays Distance Covered - Running Distance Covered - Rushing Plays Distance Covered - ST Plays Distance Covered - Sprinting Distance Covered - Total Distance Covered - Walking Dist. Covered for Team - Jogging Dist. Covered for Team - Receiving Plays Dist. Covered for Team - Running Dist. Covered for Team - Rushing Plays Dist. Covered for Team - ST Plays Dist. Covered for Team - Sprinting Dist. Covered for Team - Total Dist. Covered for Team - Walking Dist. Covered (Ball Carrier) - Receiving Plays |
Dist. Covered (Ball Carrier) - Rushing Plays Dist. Covered (Ball Carrier) - ST Plays Dist. Covered (Ball Carrier) - Total Dist. Covered (Ball Carrier) for Team - Receiving Plays Dist. Covered (Ball Carrier) for Team - Rushing Plays Dist. Covered (Ball Carrier) for Team - ST Plays Dist. Covered (Ball Carrier) for Team - Total Offense - Formation Total Offense - Formation Type Offense - Location Total Offense - Location Type Offense - Receiver Offense - Receiver on Route Passing - Air Distance Passing - Dropback Distance Passing - Intended Air Distance Passing - Time to Throw Passing - Dropback Total Passing - Dropback Type Passing - Location Total Passing - Location Type Play Participation - Defense Play Participation - Offense |
Play Participation - Receiving Plays Play Participation - Rushing Plays Play Participation - ST Plays Play Participation - Total Def/Off Play Participation for Team - Defense Play Participation for Team - Offense Play Participation for Team - Receiving Plays Play Participation for Team - Rushing Plays Play Participation for Team - ST Plays Play Participation for Team - Total Def/Off Plays with Ball - Receiving Plays Plays with Ball - Rushing Plays Plays with Ball - Special Teams Plays Plays with Ball - Total Plays with Ball for Team - Receiving Plays Plays with Ball for Team - Rushing Plays Plays with Ball for Team - Special Teams Plays Plays with Ball for Team - Total Speed - Average Speed - Maximum Touches - Receiving Plays Touches - Rushing Plays Touches - Special Teams Plays |
| Seasonal Team Statistics Data Points: | Defense - High Safety Defense - Time to Sack Defense - Defender in Box Defense - Pass Rusher Defense - Location Total Defense - Location Type Defensive Plays - Receiving Plays Against Defensive Plays - Rushing Plays Against Defensive Plays - Total Plays Against Dist. Covered - Defense - Average Dist. Dist. Covered - Defense - Total Dist. Dist. Covered - Offense - Average Dist. |
Dist. Covered - Offense - Total Dist. Offense - Formation Total Offense - Formation Type Offense - Location Total Offense - Location Type Offense - Receiver Offense - Receiver on Route Offensive Plays - Receiving Plays Offensive Plays - Rushing Plays Offensive Plays - Total Plays Passing - Air Distance Passing - Dropback Distance |
Passing - Intended Air Distance Passing - Time to Throw Passing - Dropback Total Passing - Dropback Type Passing - Location Total Passing - Location Type Speed - Average Speed - Maximum Touches - Receiving Plays Touches - Rushing Plays Touches - Special Teams Plays |
| Team Info Data Points: | Alias Id |
Name | Type |
| Update Frequency: | Post-game | ||
| Content Type: | XML or JSON | ||
| Game Info Data Points: | Id Scheduled Date/Time |
Type Week |
Year |
| League Info Data Points: | Season | Season Type | |
| Team Leaders Data Points: | Leader Description Leader Id |
Player Id Player Leader Rank |
Player Leader Value Players Type (Position) |
| Player Info Data Points: | First Name Id |
Last Name Position |
Position Group |
| Team Info Data Points: | Alias Id |
Name | Type |
| Play-by-Play Data Points: | Play Clock Play Description Play Down Play Id |
Play Possessing Team Play Quarter Play Type |
Yardline Yardline Side Yards to 1st Down |
| Update Frequency: | Post-game | ||
| Content Type: | XML or JSON | ||
| League Information Data Points: | Season | Season Type | |
| Player Info Data Points: | First Name Id |
Last Name Position |
Position Group |
| Seasonal Player Statistics Data Points: | Defense - High Safety Defense - Time to Sack Defense - Defender in Box Defense - Pass Rusher Defense - Location Total Defense - Location Type Dist. Covered - Jogging Dist. Covered - Receiving Plays Dist. Covered - Running Dist. Covered - Rushing Plays Dist. Covered - ST Plays Dist. Covered - Sprinting Dist. Covered - Total Dist. Covered - Walking Dist. Covered (Ball Carrier) - Receiving Plays Dist. Covered (Ball Carrier) - Rushing Plays |
Dist. Covered (Ball Carrier) - ST Plays Dist. Covered (Ball Carrier) - Total Offense - Formation Total Offense - Formation Type Offense - Location Total Offense - Location Type Offense - Receiver Offense - Receiver on Route Passing - Air Distance Passing - Dropback Distance Passing - Intended Air Distance Passing - Time to Throw Passing - Dropback Total Passing - Dropback Type Passing - Location Total Passing - Location Type |
Play Participation - Defense Play Participation - Offense Play Participation - Receiving Plays Play Participation - Rushing Plays Play Participation - ST Plays Play Participation - Total Def/Off Plays with Ball - Receiving Plays Plays with Ball - Rushing Plays Plays with Ball - ST Plays Plays with Ball - Total Speed - Average Speed - Maximum Touches - Receiving Plays Touches - Rushing Plays Touches - Special Teams Plays |
| Seasonal Team Statistics Data Points: | Defense - High Safety Defense - Time to Sack Defense - Defender in Box Defense - Pass Rusher Defense - Location Total Defense - Location Type Defensive Plays - Receiving Plays Against Defensive Plays - Rushing Plays Against Defensive Plays - Total Plays Against Dist. Covered By Position - Average Dist. Covered By Position - Position Id Dist. Covered By Position - Total Dist. Covered - Defense - Average Dist. Dist. Covered - Defense - Total Dist. Dist. Covered - Offense - Average Dist. Dist. Covered - Offense - Total Dist. Offense - Formation Total Offense - Formation Type Offense - Location Total |
Offense - Location Type Offense - Receiver Offense - Receiver on Route Offensive Plays - Receiving Plays Offensive Plays - Rushing Plays Offensive Plays - Total Plays Passing - Air Distance Passing - Dropback Distance Passing - Intended Air Distance Passing - Time to Throw Passing - Dropback Total Passing - Dropback Type Passing - Location Total Passing - Location Type Play Groups Defense - Dist. Covered - Average Dist. Allowed Play Groups Defense - Dist. Covered - Total Dist. Allowed Play Groups Defense - Play Types - Other Play Groups Defense - Play Types - Receiving Plays Play Groups Defense - Play Types - Rushing Plays |
Play Groups Defense - Play Types - Total Plays Play Groups Defense - Yrds Gained - Receiving Yards Allowed Play Groups Defense - Yrds Gained - Rushing Yards Allowed Play Groups Defense - Yrds Gained - Total Yards Allowed Play Groups Name Play Groups Offense - Dist. Covered - Average Dist. Play Groups Offense - Dist. Covered - Total Dist. Play Groups Offense - Play Types - Other Play Groups Offense - Play Types - Receiving Plays Play Groups Offense - Play Types - Rushing Plays Play Groups Offense - Play Types - Total Plays Play Groups Offense - Yrds Gained - Receiving Yards Play Groups Offense - Yrds Gained - Rushing Yards Play Groups Offense - Yrds Gained - Total Yards Speed - Average Speed - Maximum Touches - Receiving Plays Touches - Rushing Plays Touches - Special Teams Plays |
| Team Info Data Points: | Alias Id |
Name | Type |
| Update Frequency: | Post-game | ||
| Content Type: | XML or JSON | ||
| Game Info Data Points: | Id Scheduled Date/Time |
Type Week |
Year |
| League Info Data Points: | Week | Week Type | Week Year |
| Weekly Leaders Data Points: | Leader Description Leader Id |
Player Id Player Leader Rank |
Player Leader Value Players Type (Position) |
| Player Info Data Points: | First Name Id |
Last Name Position |
Position Group |
| Team Info Data Points: | Alias Id |
Name | Type |
| Play-by-Play Data Points: | Play Clock Play Description Play Down Play Id |
Play Possessing Team Play Quarter Play Type |
Yardline Yardline Side Yards to 1st Down |
Q: What format are date fields presented in?
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 format 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 are the season types and their descriptions?
A: Here are the valid season types and their descriptions:
- PRE – Pre-season
- REG – Regular season
- PST – Post-season
Q: What are the player positions I can expect to see?
A: Here are the valid player positions:
- C
- C/G
- CB
- CB/RS
- CB/S
- DB
- DE
- DE/LB
- DL
- DT
- FB
- FB/RB
- FS
- G
- G/C
- G/T
- H/B
- H/B/T
- HB
- ILB
- K
- KR
- L
- LB
- LB/DE
- LS
- MLB
- NT
- OG
- OL
- OLB
- OT
- P
- QB
- RB
- RB/ST
- RB/WR
- RS
- S
- SS
- T
- T/G
- TE
- TE/DT
- TE/FB
- TE/LS
- TEW
- WR
- WR/CB
- WR/KR
- WR/PR
- WR/RB
- WR/RS
Q: How is the defensive alignment described in the feeds?
A: Using both “player - lineup_location_type” and “player - lineup_lr_of_center” values, you can get the location of where each defender lined up at the snap of the ball. Location types that end in zero (excluding zero itself) implies that the player is lined up in a linebacker position, off of the defensive line. Any number without a zero at the end, implies that the player lined up on the defensive line. Left and right of center values are from the perspective of the defense.
For easy reference, see the diagram below:
Q: What are the play types I can expect to see in the feeds?
A: Here are the valid play types:
- extra_point
- field_goal
- kickoff
- pass
- punt
- rush
- sack
- two_point_conversion
- unknown
Q: What are the formations I can expect to see in the feeds?
A: Here are the valid formations:
- ACE
- EMPTY
- I_FORM
- JUMBO
- PISTOL
- SHOTGUN
- WILDCAT
Q: What are the offensive lineup location types I can expect to see in the feeds?
A: Here are the valid offensive lineup location types:
- BACKFIELD
- LEFT_SLOT
- LEFT_TIGHT
- LEFT_WIDE
- RIGHT_SLOT
- RIGHT_TIGHT
- RIGHT_WIDE
Q: What are the defensive lineup location types I can expect to see in the feeds?
A: Here are the valid defensive lineup location types:
- FIVE
- FIVE_ZERO
- FOUR
- FOUR_ZERO
- LEFT_SLOT
- LEFT_WIDE
- NINE
- NINE_ZERO
- ONE
- ONE_ZERO
- RIGHT_SLOT
- RIGHT_WIDE
- SAFETY
- SEVEN
- SEVEN_ZERO
- SIX
- SIX_ZERO
- THREE
- THREE_ZERO
- TWO
- TWO_ZERO
- ZERO
- ZERO_ZERO
Q: What are the event types I can expect to see in the feeds?
A: Here are the valid event types:
- AUDIT_TIME
- BALL_SNAP
- END_PATH
- EXTRA_POINT
- EXTRA_POINT_ATTEMPT
- EXTRA_POINT_MISSED
- EXTRA_POINT_BLOCKED
- EXCLUDEDFROMPLAY
- FAIR_CATCH
- FIELD_GOAL
- FIELD_GOAL_ATTEMPT
- FIELD_GOAL_BLOCKED
- FIELD_GOAL_MISSED
- FIELD_GOAL_PLAY
- FIRST_CONTACT
- FREE_KICK
- FREE_KICK_PLAY
- FUMBLE
- FUMBLE_OFFENSE_RECOVERED
- FUMBLE_DEFENSE_RECOVERED
- HANDOFF
- HUDDLE_BREAK_OFFENSE
- HUDDLE_START_OFFENSE
- KICK_RECEIVED
- KICKOFF
- KICKOFF_LAND
- KICKOFF_PLAY
- KICK_RECOVERED
- LINE_SET
- MAN_IN_MOTION
- ONSIDE_KICK
- OUT_OF_BOUNDS
- PASS_ARRIVED
- PASS_FORWARD
- PASS_LATERAL
- PASS_OUTCOME_CAUGHT
- PASS_OUTCOME_INCOMPLETE
- PASS_OUTCOME_INTERCEPTION
- PASS_OUTCOME_TOUCHDOWN
- PASS_SHOVEL
- PASS_TIPPED
- PENALTY_ACCEPTED
- PENALTY_DECLINED
- PENALTY_FLAG
- PLAY_MUFFED
- PLAY_START
- PLAY_SUBMIT
- PLAY_STOPPED
- PUNT
- PUNT_BLOCKED
- PUNT_DOWNED
- PUNT_LAND
- PUNT_PLAY
- PUNT_RECEIVED
- QB_KNEEL
- QB_SACK
- QB_STRIP_SACK
- RUN
- SAFETY
- SHIFT
- SNAP_DIRECT
- SYSTEM_NOTE
- TACKLE
- TIMEOUT
- TIMEOUT_AWAY
- TIMEOUT_BOOTH_REVIEW
- TIMEOUT_HALFTIME
- TIMEOUT_HOME
- TIMEOUT_INJURY
- TIMEOUT_QUARTER
- TIMEOUT_TV
- TOUCHBACK
- TOUCHDOWN
- TWO_MINUTE_WARNING
- TWO_POINT_CONVERSION
- TWO_POINT_PLAY
- XP_PLAY
Q: What are the pass locations I can expect to see in the feeds?
A: Here are the valid pass locations:
- INSIDE BOX
- OUTSIDE LEFT
- OUTSIDE RIGHT
- UNKNOWN
Q: What are the dropback types I can expect to see in the feeds?
A: Here are the valid dropback types:
- ROLLOUT
- SCRAMBLE
- TRADITIONAL
- UNKNOWN
Q: Where is the origin (0,0) located relative to the dimensions of a football field?
A: The x-axis = length (120 yards) of the field, the y-axis = width (53.333 yards) of the field, and the origin (0,0) is located in the lower-left corner of a horizontally oriented (broadcast view) of the football field.
Q: Which direction is positive for each coordinate system?
A: The x-values will increase from left to right from the aforementioned broadcast perspective and y-values will increase from bottom to top from the broadcast perspective.
Q: What unit of measure is the x and y-coordinates represented in?
A: Coordinates are provided in yards, each x/y value will represent a yard on the playing field.
Q: What unit of measure is the distance value (dis) represented in?
A: Distance is represented in yards traveled within the given range of time – one-tenth of a second.
Q: What unit of measure is the speed value (spd) represented in?
A: Speed is represented in yards per second.
Q: What unit of measure is direction value (dir) represented in?
A: Direction is represented in degrees (0-360) and signifies the direction that the player is moving:
- 0 - The player is headed towards the northern sideline (broadcast perspective)
- 90 - The player is headed towards the right end zone (broadcast perspective)
- 180 - The player is headed towards the southern sideline (broadcast perspective)
- 270 - The player is headed towards the left end zone (broadcast perspective)
Docs Navigation
- Documentation
- Football (Soccer)
- American Football
- Australian Rules Football
- Baseball
- Basketball
- Combat Sports
- Cricket
- Editorial Content
- eSports
- Golf
- Handball
- Hockey
- Images
- Core Insights
- Betting Insights
- All Insights
- Odds
- Olympics
- Racing
- Rugby
- Tennis
- Baseline Sports Coverage
- Badminton v2
- Badminton v1
- Bandy v1
- Curling v1
- Cycling v2
- Cycling v1
- Darts v2
- Darts v1
- Floorball v1
- Futsal v1
- Horse Racing v2
- Lacrosse v1
- Pesapallo v1
- Snooker v2
- Snooker v1
- Squash v1
- Table Tennis v2
- Volleyball (Beach) v2
- Volleyball (Beach) v1
- Volleyball (Indoor) v2
- Volleyball (Indoor) v1
- Waterpolo v1
- Winter Sports v1
