--- title: "NFL player game log for a season" method: GET path: "/v1/nfl/players/{id}/game-log" tags: ["nfl"] --- # NFL player game log for a season `GET /v1/nfl/players/{id}/game-log` ## Request - Base URL: `https://api.bigballsdata.com` - URL: `https://api.bigballsdata.com/v1/nfl/players/{id}/game-log` - Auth: one of: - API key in header `x-api-key` - HTTP bearer The same rows as /v1/nfl/players/{id}/stats, ordered by week ascending for one required season and returned unpaginated. Offence and defence. ## Path parameters - `id` string, required ## Query parameters - `season` integer, required ## Response `200` ok. - object - `data` NflPlayerWeekStat[], required - `player_id` string: NFL player id (gsis format). - `player_name` string, nullable - `team` string, nullable: Team abbreviation the player suited up for that week. - `season` integer: Season LABEL: the year the season starts in. - `week` integer - `season_type` 'REG' | 'POST' | 'PRE', nullable - `position` string, nullable - `passing_yards` integer, nullable - `passing_tds` integer, nullable - `completions` integer, nullable - `attempts` integer, nullable - `rushing_yards` integer, nullable - `rushing_tds` integer, nullable - `carries` integer, nullable - `receiving_yards` integer, nullable - `receiving_tds` integer, nullable - `receptions` integer, nullable - `targets` integer, nullable - `fantasy_points_ppr` number, nullable: Standard PPR: 1/reception, 0.1/rush-rec yard, 0.04/pass yard, 6/TD, -2/int or fumble lost. - `interceptions` integer, nullable: DEPRECATED and ALWAYS NULL. The loader read a column the dataset does not carry, so this was never written in any of 112,333 rows. The key is retained only so existing clients do not break. Read `interceptions_thrown` or `interceptions_caught`, which say which one they mean. - `interceptions_thrown` integer, nullable: Interceptions thrown by this player (the quarterback turnover stat). - `interceptions_caught` integer, nullable: Interceptions caught by this player (the defensive takeaway stat). - `tackles_solo` integer, nullable: Unassisted tackles. Not a combined total; see the schema description before comparing against totalTackles elsewhere. - `tackle_assists` integer, nullable: Assisted tackles this player participated in. Not interchangeable with tackles_with_assist. - `tackles_with_assist` integer, nullable: Tackles made WITH an assist from a team-mate. A much smaller count than tackle_assists. - `tackles_for_loss` integer, nullable: Tackles made behind the line of scrimmage. - `tackles_for_loss_yards` integer, nullable: Yards lost by the offence on those tackles. - `sacks` number, nullable: Sacks credited. FRACTIONAL; a shared sack is credited as 0.5 to each defender. - `sack_yards` number, nullable: Yards lost on this player's sacks. Fractional for the same half-credit reason as sacks. - `qb_hits` integer, nullable: Hits on the quarterback - `passes_defended` integer, nullable: Passes broken up without intercepting. - `fumbles_forced` integer, nullable: Fumbles forced. Forcing is not recovering; recoveries are not currently served. - `interception_yards` integer, nullable: Return yards on this player's interceptions. MAY BE NEGATIVE; a return can be tackled behind the catch point. - `defensive_tds` integer, nullable: Touchdowns scored on defence. Distinct from passing_tds / rushing_tds / receiving_tds on the same row. - `safeties` integer, nullable - `punt_blocks` integer, nullable - `pat_blocks` integer, nullable: Extra-point attempts blocked. - `fg_blocks` integer, nullable: Field-goal attempts blocked. - `defensive_two_point_attempts` integer, nullable: Two-point conversion returns attempted by the defence. - `defensive_two_point_conversions` integer, nullable: Two-point conversion returns scored by the defence. - `times_sacked` integer, nullable: Times this OFFENSIVE player (almost always a QB) was sacked. Distinct from `sacks` above, which is the DEFENSIVE credit. - `sack_yards_lost` number, nullable: Yards lost on this player's own sacks. Distinct from `sack_yards` above, which is the DEFENSIVE figure. - `passing_air_yards` number, nullable: Weekly sum of air yards on this player's pass attempts. Per-play value on GET /v1/nfl/games/{id}/plays as `air_yards`. - `passing_yards_after_catch` number, nullable: Weekly sum of yards after the catch on this player's completions. Unofficial figure. - `passing_first_downs` integer, nullable - `passing_epa` number, nullable: Total EPA on this player's pass attempts and sacks. - `passing_2pt_conversions` integer, nullable - `dakota` number, nullable: Adjusted EPA + CPOE composite. A published advanced metric, not derived by us. - `rushing_first_downs` integer, nullable - `rushing_epa` number, nullable - `rushing_2pt_conversions` integer, nullable - `receiving_air_yards` number, nullable: Weekly sum of air yards on targets to this player. Per-play value on GET /v1/nfl/games/{id}/plays as `air_yards`. - `receiving_yards_after_catch` number, nullable: Weekly sum of yards after the catch by this receiver. Per-play value on GET /v1/nfl/games/{id}/plays as `yards_after_catch`. - `receiving_2pt_conversions` integer, nullable - `fantasy_points` number, nullable: Standard (non-PPR) fantasy total. See fantasy_points_ppr for the PPR total. - `air_yards_share` number, nullable: This player's share of the team's air yards this game-week. Fraction in [0,1]. - `pacr` number, nullable: Passing (yards) Air (yards) Conversion Ratio. A published advanced metric, not derived by us. - `racr` number, nullable: Receiving (yards) Air (yards) Conversion Ratio. A published advanced metric, not derived by us. - `receiving_epa` number, nullable - `receiving_first_downs` integer, nullable - `special_teams_tds` integer, nullable: Kick/punt return touchdowns. Distinct from defensive_tds and the offensive *_tds columns. - `wopr` number, nullable: Weighted Opportunity Rating: 1.5 x target_share + 0.7 x air_yards_share. A published advanced metric, not derived by us. - `target_share` number, nullable: This player's share of the team's receiving targets this game-week. Fraction in [0,1]. ## Other responses - `400`: Missing or invalid ?season=. --- [API](https://skmtc.dev/bigballsdata/apis/big-ball-sports-api.md) · [All operations](https://skmtc.dev/bigballsdata/apis/big-ball-sports-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bigballsdata/apis/big-ball-sports-api/revisions/31fb54ac414e?raw)