get_plays
Read-only
Use for play-by-play: every event of a game, or a player's or team's plays across a season, with shot location (feet), zone, our expected points, the score and the home win probability after each play (2018 on). Filter to shots, makes or misses, a zone, a period or clutch time. Pass league for the WNBA (wnba) or college (ncaam, ncaaw); default NBA. Costs 10 credits.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| made | No | Only made (true) or missed (false) shots. | |
| team | No | A team's plays (id or abbreviation). | |
| zone | No | One shot zone. | |
| limit | No | Max plays (default 200). | |
| clutch | No | Last 5 minutes of the 4th quarter (college men: 2nd half) or overtime, score within 5. | |
| league | No | League. Defaults to nba. One of: nba, wnba, ncaam, ncaaw. | |
| offset | No | ||
| period | No | ||
| season | No | Season by the year it ends (default: the latest; ignored with game_id). | |
| game_id | No | One game: every play in order. | |
| player_id | No | A player's plays (with season). | |
| shots_only | No | Field goal and free throw attempts only. | |
| season_type | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | ||
| plays | Yes | ||
| next_offset | No |