Rankings (By Week)

Time	Status	User Agent
Retrieving recent requests…

⏱️
Update Frequency
TTL / Cache: 60 minutes
Data Updates: Rankings update within 15 minutes after their release to the public, typically on Mondays

📘
Displaying Rankings
Learn how to use Rankings (By Week) to display historical Associated Press and USA Today rankings, including teams receiving votes, in our Standings and Rankings integration scenario.

Data Points

Polls

The following polls are covered: Associated Press (AP), USA Today (US)

Attribute	Parent Element	Type	Description
`alias`	`poll`	String	Alias of a poll `AP`, `US`
`id`	`poll`	GUID	Unique ID of a poll ex. `9341408d-9f9a-463f-ab60-be8d1aeeffa2`
`name`	`poll`	String	Name of a poll ex. `AP Top 25`
`effective_time`	`poll`	Date/Time	Timestamp of the creation of the weekly ranking (poll) record ex. `2023-01-10T13:42:00+00:00`
`week`	`poll`	String	Week of the season
`year`	`poll`	Integer	Year of the season

Rankings

Attribute	Parent Element	Type	Description
`prev_rank`	`poll` - `rankings` - `team`	Integer	Team rank for the previous week
`losses`	`poll` - `rankings` - `team`	Integer	Number of overall team losses Note: Win/loss data represents a team's record when rankings are released. For "realtime" standing updates/records, use the Standings endpoint.
`wins`	`poll` - `rankings` - `team`	Integer	Number of overall team wins Note: Win/loss data represents a team's record when rankings are released. For "realtime" standing updates/records, use the Standings endpoint.
`rank`	`poll` - `rankings` - `team`	Integer	Team rank for the week polled
`points`	`poll` - `rankings` - `team`	Integer	Number of team rank points for the week polled
`fp_votes`	`poll` - `rankings` - `team`	Integer	Number of first place votes for a team for the week polled
`votes`	`poll` - `candidates` - `team`	Integer	Number of votes for a team outside of the top 25 for the week polled

Team

Attribute	Parent Element	Type	Description
`id`	`team`	GUID	Unique ID of a team ex. `24051034-96bb-4f78-a3a6-312f3258780f`
`market`	`team`	String	School name of a team ex. `Pittsburgh`
`name`	`team`	String	Team name ex. `Panthers`

Update Frequency

Displaying Rankings

Data Points

200200