Returns the long-format ranked teams for one (season x season-type x week x ranking-source). NBA typically returns an empty tibble.
Usage
espn_nba_week_ranking(
ranking_id,
week,
season = most_recent_nba_season(),
season_type = 2L,
...
)Value
A tibble with one row per ranked team (typically 25).
| col_name | types | description |
| league | character | League slug. |
| season | integer | Season year. |
| season_type | integer | Season-type id. |
| week | integer | Week number. |
| ranking_id | character | ESPN ranking id. |
| name | character | Ranking name (e.g. "AP Top 25"). |
| short_name | character | Short name. |
| type | character | Ranking type code. |
| headline | character | Full headline. |
| date | character | Date of the ranking. |
| current | integer | Current rank. |
| previous | integer | Previous-week rank. |
| points | numeric | Voting points. |
| first_place_votes | integer | First-place vote count. |
| trend | character | Trend indicator (e.g. "+3", "-2", "-"). |
| record_summary | character | Team's record at time of poll (e.g. "20-2"). |
| team_id | character | ESPN team id. |
| team_ref | character | $ref to the team-in-season resource. |
| last_updated | character | Last-updated timestamp. |
See also
Other ESPN NBA Functions:
espn_nba_athlete_awards(),
espn_nba_athlete_career_stats(),
espn_nba_athlete_contract(),
espn_nba_athlete_contracts(),
espn_nba_athlete_eventlog(),
espn_nba_athlete_eventlog_v2(),
espn_nba_athlete_gamelog(),
espn_nba_athlete_info(),
espn_nba_athlete_overview(),
espn_nba_athlete_seasons(),
espn_nba_athlete_splits(),
espn_nba_athlete_statisticslog(),
espn_nba_athlete_stats(),
espn_nba_athletes_index(),
espn_nba_award(),
espn_nba_betting(),
espn_nba_calendar(),
espn_nba_coach(),
espn_nba_coach_season(),
espn_nba_coaches(),
espn_nba_conferences(),
espn_nba_draft(),
espn_nba_draft_athletes(),
espn_nba_draft_pick(),
espn_nba_draft_rounds(),
espn_nba_draft_status(),
espn_nba_event_broadcasts(),
espn_nba_event_odds(),
espn_nba_event_officials(),
espn_nba_event_powerindex(),
espn_nba_event_predictor(),
espn_nba_event_probabilities(),
espn_nba_event_propbets(),
espn_nba_event_situation(),
espn_nba_franchise(),
espn_nba_franchises(),
espn_nba_freeagents(),
espn_nba_futures(),
espn_nba_game_all(),
espn_nba_game_rosters(),
espn_nba_injuries(),
espn_nba_leaders(),
espn_nba_news(),
espn_nba_pbp(),
espn_nba_player_box(),
espn_nba_player_stats(),
espn_nba_powerindex(),
espn_nba_scoreboard(),
espn_nba_season_awards(),
espn_nba_season_group(),
espn_nba_season_group_children(),
espn_nba_season_group_teams(),
espn_nba_season_groups(),
espn_nba_season_info(),
espn_nba_season_leaders(),
espn_nba_season_ranking(),
espn_nba_season_rankings(),
espn_nba_season_type(),
espn_nba_season_types(),
espn_nba_season_week(),
espn_nba_season_weeks(),
espn_nba_seasons(),
espn_nba_standings(),
espn_nba_team(),
espn_nba_team_box(),
espn_nba_team_current_roster(),
espn_nba_team_depthchart(),
espn_nba_team_injuries(),
espn_nba_team_leaders(),
espn_nba_team_news(),
espn_nba_team_odds_records(),
espn_nba_team_record(),
espn_nba_team_roster(),
espn_nba_team_schedule(),
espn_nba_team_season_profile(),
espn_nba_team_season_roster(),
espn_nba_team_stats(),
espn_nba_teams(),
espn_nba_tournament(),
espn_nba_tournament_seasons(),
espn_nba_tournaments(),
espn_nba_transactions(),
espn_nba_venues(),
espn_nba_week_rankings(),
espn_nba_wp()
Examples
# \donttest{
espn_nba_week_ranking(ranking_id = 1, week = 5, season = 2025)
#> ✖ 2026-05-19 01:34:21.939629: Failed to retrieve ESPN nba week-5 ranking 1 for season=2025
#> ✖ Args: league = "nba", season = 2025, season_type = 2L, week = 5, ranking_id = 1
#> ✖ Error: The API returned an error
#> NULL
# }