The Top 25 — Top25Rankings

Developer API

JSON · Read-only

A simple, read-only JSON API. The current Top 25 — the most recently released poll — is free. The rest of the archive (every ranked board back to 2000, across college football and men's & women's basketball) is available on the paid tier with an API key.

Endpoints

GET /api/v1/current Free

Returns the Top 25 of the most recently retrieved poll — and only that. This is the one route the free tier can call; no API key required.

curl https://top25rankings.com/api/v1/current

{
  "sport": "college-football",
  "poll": "media-top-25",
  "season": 2025,
  "seasonLabel": "2025",
  "release": "Final Rankings",
  "rankings": [
    { "rank": 1, "team": "Georgia", "conference": "SEC", "record": "13-1",
      "points": 1550, "firstPlaceVotes": 62, "previousRank": 1, "trend": "same" }
  ]
}

GET /api/v1/polls Paid

Lists the polls you can query, with their sport and poll slugs.

GET /api/v1/rankings/{sport}/{poll} Paid

Returns any board, including receiving votes. Add ?season=YYYY for a past season; omit it for the latest. Requires a paid API key.

curl -H "X-Api-Key: YOUR_KEY" \ https://top25rankings.com/api/v1/rankings/college-football/media-top-25?season=2015

Plans & limits

Notes

Responses are JSON. Each response includes X-RateLimit-Tier (free or paid) and X-RateLimit-Limit headers. Over the limit returns 429 Too Many Requests with a Retry-After header. Calling a paid endpoint without a valid key — or sending an unrecognized key to any endpoint — returns 401 Unauthorized. The API is read-only and the data is the same you see on the site.

← Front page Browse the polls