nfl

NFL season leaderboard

Season leaderboard over stored weekly NFL player statistics. The route sums the selected stat across the requested season and season type, then ranks players in descending order. season defaults to the newest populated season for that season type. player_id is the established NFL player identifier also used by /v1/nfl/players/{id}/stats, not a BigBalls player UUID. Responses are cached for five minutes.

This code-only stage deliberately makes no data_as_of claim. The base table records real value-change timestamps, but production's public view does not expose that column until migration 285 is separately applied. A missing freshness field is more accurate than substituting a row-creation timestamp or cron heartbeat.

get/v1/nfl/leaders

Request

  • Base URL: https://api.bigballsdata.com
  • URL: https://api.bigballsdata.com/v1/nfl/leaders
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Query parameters

stat'fantasy_points_ppr' | 'fantasy_points' | 'passing_yards' | 'passing_tds' | 'rushing_yards' | 'rushing_tds' | 'receiving_yards' | 'receiving_tds' | 'receptions' | 'targets' | 'interceptions_thrown' | 'sacks' | 'tackles_solo'
seasoninteger

Defaults to the newest populated season for the requested season_type.

season_type'REG' | 'POST'
min_gamesinteger
limitinteger

Response

Season leaderboard and cache metadata.

dataobject required

Changes

No recorded changes to this operation across all 3 revisions of this API.