Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Integration Guides

Standings and Rankings

Use this guide to effectively access NCAAMB standings and rankings. It also covers the Daily Change Log endpoint which can be used to track postgame revisions to standings and rankings.

Prerequisite - Accessing Available Seasons

To avoid confusion and ensure you're accessing available data, refer to our Seasons feed. This resource lists all the seasons for which we have data.

For example: To ensure data availability for future seasons, such as a schedule in advance of when a season begins, first check the Seasons feed to verify that data for that specific season is already provided.

Starting with this feed can prevent unnecessary errors and streamline your data retrieval process.


📆

Starting Year for Each Season

It's important to note that the season parameter uses the starting year of the season; for example, to retrieve data for the 2024-25 NCAAMB season, you would use 2024 as the value for the season parameter.



Difference Between Standings and Rankings

In college basketball, standings and rankings refer to related but distinct concepts:

  • Standings provide detailed team records across various views including, overall, conference, and division information.
  • Rankings are used to determine teams’ rank in divisions and conferences. This endpoint is updated manually at the end of each night. We provide the following rankings endpoints in the NCAAMB API:
    • Rankings (Current Week) - List of current Associated Press and USA Today rankings, including those teams not ranked but receiving votes.
    • Rankings (By Week) - List by week of Associated Press and USA Today rankings, including those teams not ranked but receiving votes.
    • NET Rankings - Provides the NCAA NET rankings for a given season.
    • RPI (Rate Percentage Index) Rankings - RPI information including rating, strength of schedule, ranking, and records based on Sportradar’s RPI calculations.


How to Access Standings

You can access standings using the Standings feed. This endpoint provides detailed team records across various views including, overall, conference, and division information.


Recommended Call Frequency:

  • Standings are updated on a timer of 10 minutes after a game has moved to complete.
  • Pull every hour or less, depending on your use case.
  • Pull 10 mins after a game is moved to 'complete' to receive the quickest updates.

Analyzing Standings Data

{
  "league": {
    "id": "cd4268ee-07aa-4c4d-a435-ec44ad2c76cb",
    "name": "NCAA MEN",
    "alias": "NCAAM"
  },
  "season": {
    "id": "05b9e2ec-8916-432f-8a56-6579eb825dd0",
    "year": 2023,
    "type": "REG"
  },
  "conferences": [
    {
      "id": "9ed9d01e-977c-4ba7-ac7d-64035039461c",
      "name": "Southeastern",
      "alias": "SEC",
      "teams": [
        {
          "id": "b827dbdf-230f-4916-9703-3bb9004e26eb",
          "name": "Volunteers",
          "market": "Tennessee",
          "wins": 27,
          "losses": 9,
          "win_pct": 0.75,
          "points_for": 78.78,
          "points_against": 67.39,
          "point_diff": 11.39,
          "conf_points_for": 81.94,
          "conf_points_against": 70.17,
          "clinched": "conference",
          "post_season_ineligible": false,
          "strength_of_schedule_rank": 2,
          "conference_rank": 1,
          "subdivision_rank": 0,
          "games_behind": {
            "conference": 0
          },
          "streak": {
            "kind": "loss",
            "length": 1
          },
          "records": [
            {
              "record_type": "a10",
              "wins": 1,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "acc",
              "wins": 2,
              "losses": 1,
              "win_pct": 0.667
            },
            {
              "record_type": "below_500",
              "wins": 4,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "big10",
              "wins": 2,
              "losses": 2,
              "win_pct": 0.5
            },
            {
              "record_type": "big12",
              "wins": 1,
              "losses": 1,
              "win_pct": 0.5
            },
            {
              "record_type": "bigeast",
              "wins": 1,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "conference",
              "wins": 14,
              "losses": 4,
              "win_pct": 0.778
            },
            {
              "record_type": "equal_rebounds",
              "wins": 1,
              "losses": 1,
              "win_pct": 0.5
            },
            {
              "record_type": "equal_turnovers",
              "wins": 4,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "fewer_turnovers",
              "wins": 16,
              "losses": 8,
              "win_pct": 0.667
            },
            {
              "record_type": "home",
              "wins": 14,
              "losses": 2,
              "win_pct": 0.875
            },
            {
              "record_type": "last_10",
              "wins": 7,
              "losses": 3,
              "win_pct": 0.7
            },
            {
              "record_type": "last_10_home",
              "wins": 7,
              "losses": 3,
              "win_pct": 0.7
            },
            {
              "record_type": "last_10_road",
              "wins": 7,
              "losses": 3,
              "win_pct": 0.7
            },
            {
              "record_type": "leads_field_goal_pct",
              "wins": 22,
              "losses": 2,
              "win_pct": 0.917
            },
            {
              "record_type": "leads_rebounds",
              "wins": 22,
              "losses": 1,
              "win_pct": 0.957
            },
            {
              "record_type": "maac",
              "wins": 1,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "meac",
              "wins": 1,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "neutral",
              "wins": 5,
              "losses": 4,
              "win_pct": 0.556
            },
            {
              "record_type": "opponent_fewer_turnovers",
              "wins": 7,
              "losses": 1,
              "win_pct": 0.875
            },
            {
              "record_type": "opponent_leads_field_goal_pct",
              "wins": 5,
              "losses": 7,
              "win_pct": 0.417
            },
            {
              "record_type": "opponent_leads_rebounds",
              "wins": 4,
              "losses": 7,
              "win_pct": 0.364
            },
            {
              "record_type": "opponent_scores_100_or_more",
              "wins": 0,
              "losses": 1,
              "win_pct": 0
            },
            {
              "record_type": "ovc",
              "wins": 1,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "overtime",
              "wins": 0,
              "losses": 0,
              "win_pct": 0
            },
            {
              "record_type": "over_500",
              "wins": 23,
              "losses": 9,
              "win_pct": 0.719
            },
            {
              "record_type": "road",
              "wins": 8,
              "losses": 3,
              "win_pct": 0.727
            },
            {
              "record_type": "scores_100_or_more",
              "wins": 1,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "sec",
              "wins": 14,
              "losses": 5,
              "win_pct": 0.737
            },
            {
              "record_type": "southern",
              "wins": 1,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "sunbelt",
              "wins": 1,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "ten_points",
              "wins": 18,
              "losses": 2,
              "win_pct": 0.9
            },
            {
              "record_type": "three_points",
              "wins": 0,
              "losses": 0,
              "win_pct": 0
            },
            {
              "record_type": "top_25",
              "wins": 7,
              "losses": 5,
              "win_pct": 0.583
            },
            {
              "record_type": "wac",
              "wins": 1,
              "losses": 0,
              "win_pct": 1
            }
          ]
        },
        {
          "id": "1c7ec608-3b36-4cee-adac-9265e3792597",
          "name": "Gamecocks",
          "market": "South Carolina",
          "wins": 26,
          "losses": 8,
          "win_pct": 0.765,
          "points_for": 72.06,
          "points_against": 67.56,
          "point_diff": 4.5,
          "conf_points_for": 70.06,
          "conf_points_against": 68.78,
          "clinched": null,
          "post_season_ineligible": false,
          "strength_of_schedule_rank": 16,
          "conference_rank": 5,
          "subdivision_rank": 0,
          "games_behind": {
            "conference": 1
          },
          "streak": {
            "kind": "loss",
            "length": 2
          },
          "records": [
            {
              "record_type": "a10",
              "wins": 1,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "aac",
              "wins": 1,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "acc",
              "wins": 2,
              "losses": 1,
              "win_pct": 0.667
            },
            {
              "record_type": "below_500",
              "wins": 5,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "bigeast",
              "wins": 1,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "bigsouth",
              "wins": 3,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "caa",
              "wins": 1,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "conference",
              "wins": 13,
              "losses": 5,
              "win_pct": 0.722
            },
            {
              "record_type": "equal_rebounds",
              "wins": 0,
              "losses": 1,
              "win_pct": 0
            },
            {
              "record_type": "equal_turnovers",
              "wins": 2,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "fewer_turnovers",
              "wins": 10,
              "losses": 2,
              "win_pct": 0.833
            },
            {
              "record_type": "home",
              "wins": 14,
              "losses": 3,
              "win_pct": 0.824
            },
            {
              "record_type": "last_10",
              "wins": 5,
              "losses": 5,
              "win_pct": 0.5
            },
            {
              "record_type": "last_10_home",
              "wins": 6,
              "losses": 4,
              "win_pct": 0.6
            },
            {
              "record_type": "last_10_road",
              "wins": 7,
              "losses": 3,
              "win_pct": 0.7
            },
            {
              "record_type": "leads_field_goal_pct",
              "wins": 17,
              "losses": 2,
              "win_pct": 0.895
            },
            {
              "record_type": "leads_rebounds",
              "wins": 19,
              "losses": 1,
              "win_pct": 0.95
            },
            {
              "record_type": "neutral",
              "wins": 4,
              "losses": 2,
              "win_pct": 0.667
            },
            {
              "record_type": "opponent_fewer_turnovers",
              "wins": 14,
              "losses": 6,
              "win_pct": 0.7
            },
            {
              "record_type": "opponent_leads_field_goal_pct",
              "wins": 9,
              "losses": 6,
              "win_pct": 0.6
            },
            {
              "record_type": "opponent_leads_rebounds",
              "wins": 7,
              "losses": 6,
              "win_pct": 0.538
            },
            {
              "record_type": "opponent_scores_100_or_more",
              "wins": 0,
              "losses": 1,
              "win_pct": 0
            },
            {
              "record_type": "overtime",
              "wins": 2,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "over_500",
              "wins": 21,
              "losses": 8,
              "win_pct": 0.724
            },
            {
              "record_type": "pac12",
              "wins": 0,
              "losses": 1,
              "win_pct": 0
            },
            {
              "record_type": "road",
              "wins": 8,
              "losses": 3,
              "win_pct": 0.727
            },
            {
              "record_type": "sec",
              "wins": 14,
              "losses": 6,
              "win_pct": 0.7
            },
            {
              "record_type": "southern",
              "wins": 1,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "swac",
              "wins": 1,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "ten_points",
              "wins": 13,
              "losses": 4,
              "win_pct": 0.765
            },
            {
              "record_type": "three_points",
              "wins": 4,
              "losses": 1,
              "win_pct": 0.8
            },
            {
              "record_type": "top_25",
              "wins": 3,
              "losses": 4,
              "win_pct": 0.429
            },
            {
              "record_type": "wac",
              "wins": 1,
              "losses": 0,
              "win_pct": 1
            }
          ]
        },
        {
          "id": "0c0608b3-f349-4f5e-9a10-7e6a744dd0d2",
          "name": "Tigers",
          "market": "Auburn",
          "wins": 27,
          "losses": 8,
          "win_pct": 0.771,
          "points_for": 83.11,
          "points_against": 68.31,
          "point_diff": 14.8,
          "conf_points_for": 82.5,
          "conf_points_against": 69.89,
          "clinched": null,
          "post_season_ineligible": false,
          "strength_of_schedule_rank": 5,
          "conference_rank": 4,
          "subdivision_rank": 0,
          "games_behind": {
            "conference": 1
          },
          "streak": {
            "kind": "loss",
            "length": 1
          },
          "records": [
            {
              "record_type": "a10",
              "wins": 1,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "acc",
              "wins": 2,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "below_500",
              "wins": 5,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "big10",
              "wins": 1,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "big12",
              "wins": 0,
              "losses": 1,
              "win_pct": 0
            },
            {
              "record_type": "bigsouth",
              "wins": 1,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "conference",
              "wins": 13,
              "losses": 5,
              "win_pct": 0.722
            },
            {
              "record_type": "equal_rebounds",
              "wins": 3,
              "losses": 1,
              "win_pct": 0.75
            },
            {
              "record_type": "equal_turnovers",
              "wins": 4,
              "losses": 1,
              "win_pct": 0.8
            },
            {
              "record_type": "fewer_turnovers",
              "wins": 17,
              "losses": 3,
              "win_pct": 0.85
            },
            {
              "record_type": "home",
              "wins": 15,
              "losses": 1,
              "win_pct": 0.938
            },
            {
              "record_type": "ivy",
              "wins": 1,
              "losses": 1,
              "win_pct": 0.5
            },
            {
              "record_type": "last_10",
              "wins": 7,
              "losses": 3,
              "win_pct": 0.7
            },
            {
              "record_type": "last_10_home",
              "wins": 8,
              "losses": 2,
              "win_pct": 0.8
            },
            {
              "record_type": "last_10_road",
              "wins": 6,
              "losses": 4,
              "win_pct": 0.6
            },
            {
              "record_type": "leads_field_goal_pct",
              "wins": 27,
              "losses": 4,
              "win_pct": 0.871
            },
            {
              "record_type": "leads_rebounds",
              "wins": 16,
              "losses": 2,
              "win_pct": 0.889
            },
            {
              "record_type": "neutral",
              "wins": 7,
              "losses": 2,
              "win_pct": 0.778
            },
            {
              "record_type": "opponent_fewer_turnovers",
              "wins": 6,
              "losses": 4,
              "win_pct": 0.6
            },
            {
              "record_type": "opponent_leads_field_goal_pct",
              "wins": 0,
              "losses": 4,
              "win_pct": 0
            },
            {
              "record_type": "opponent_leads_rebounds",
              "wins": 8,
              "losses": 5,
              "win_pct": 0.615
            },
            {
              "record_type": "overtime",
              "wins": 0,
              "losses": 0,
              "win_pct": 0
            },
            {
              "record_type": "over_500",
              "wins": 22,
              "losses": 8,
              "win_pct": 0.733
            },
            {
              "record_type": "pac12",
              "wins": 1,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "road",
              "wins": 5,
              "losses": 5,
              "win_pct": 0.5
            },
            {
              "record_type": "scores_100_or_more",
              "wins": 4,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "sec",
              "wins": 16,
              "losses": 5,
              "win_pct": 0.762
            },
            {
              "record_type": "southern",
              "wins": 1,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "southland",
              "wins": 1,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "sunbelt",
              "wins": 0,
              "losses": 1,
              "win_pct": 0
            },
            {
              "record_type": "swac",
              "wins": 2,
              "losses": 0,
              "win_pct": 1
            },
            {
              "record_type": "ten_points",
              "wins": 26,
              "losses": 2,
              "win_pct": 0.929
            },
            {
              "record_type": "three_points",
              "wins": 0,
              "losses": 1,
              "win_pct": 0
            },
            {
              "record_type": "top_25",
              "wins": 4,
              "losses": 3,
              "win_pct": 0.571
            }
          ]
        }
      ]
    }
  ]
}
  1. Season and Conference Information

    • The data pertains to the 2023 NCAA Men’s basketball season, specifying it's for the regular season (REG). This context helps understand where the teams stand during the season.
    • Teams are organized by conferences, such as the Southeastern Conference (SEC), with detailed information for each team within the conference, allowing for easy analysis of their performance.
  2. Team Data

    • Each team includes details like their ID, name, market (e.g., Tennessee Volunteers), and a variety of performance metrics:
      • Record (Wins and Losses): Key for tracking a team's overall success. For example, Tennessee has 27 wins and 9 losses.
      • Win Percentage (Win_pct): Shows the percentage of games won out of total games played (e.g., Tennessee’s win percentage is 0.75).
      • Points For and Against: This provides insights into a team's offensive strength (points scored) and defensive capability (points allowed). Tennessee, for instance, averages 78.78 points per game and allows 67.39 points.
      • Conference Rank: Indicates how teams are performing within their conference (e.g., Tennessee is ranked 1st in the SEC).
      • Streaks: Highlights the team's momentum, such as a current winning or losing streak. In this case, Tennessee is on a 1-game losing streak.
  3. Records Categories

    • The records section breaks down a team's performance in various game contexts:
      • Conference Record: Shows how well the team performs within its own conference, which is crucial for seeding in conference tournaments (e.g., Tennessee’s conference record is 14-4).
      • Home and Road Records: Indicates performance at home versus on the road, highlighting the team's home-court advantage or challenges on the road. Tennessee has a strong home record (14-2) and a solid road record (8-3).
      • Performance Against Specific Opponents: Shows how the team fares against teams from other conferences like the ACC or Big Ten, or against teams with different win percentages, providing deeper insight into their adaptability.
  4. Additional Metrics and Strength Indicators

    • Points in Different Game Scenarios: Categories like points for in conference games, or points against, help evaluate how the team performs in specific settings, such as conference matchups.
    • Strength of Schedule Rank (SOS): Indicates the difficulty of a team's schedule based on the performance of their opponents. Tennessee’s SOS rank is 2, reflecting a particularly tough schedule.
    • Games Behind: Shows how far a team is behind the conference leader, which is particularly relevant in competitive conferences like the SEC.

🏀

What is Clinching Status?

Clinching status refers to the point in the season when a team has secured a the top spot in their conference (clinched = conference) based on their performance.

You might consider displaying NCAAMB season standings data like the following to provide users with a comprehensive overview of team performances. It shows detailed statistics including wins, losses, home and away records.



How to Access Rankings

In the NCAAMB API, a variety of endpoints are available to access rankings data, depending on your specific data needs. To retrieve rankings information, you can utilize the following feeds:

  • NET Rankings - Provides the NCAA NET rankings for a given season.
  • RPI Rankings - RPI (Rate Percentage Index) Rankings - RPI information including rating, strength of schedule, ranking, and records based on Sportradar's RPI calculations.
  • Associated Press (AP) and USA Today Rankings
    • Rankings (Current Week) (AP Rankings) - List of current Associated Press and USA Today rankings, including those teams not ranked but receiving votes.
    • Rankings (By Week) - List by week of Associated Press and USA Today rankings, including those teams not ranked but receiving votes.

RPI vs. NET Rankings

The Ratings Percentage Index (RPI) focuses on a team's winning percentage and strength of schedule, while the NCAA Evaluation Tool (NET) incorporates factors like game location, margin of victory, and efficiency metrics. RPI is simpler, based on win-loss data, while NET provides a more detailed, analytics-driven ranking. If you need basic performance metrics, consider using RPI; for more in-depth analysis, NET is a better option.

Note: NET Rankings became the primary ranking system for the NCAA in the 2018-19 season


NET Rankings Example:

{
  "season": {
    "id": "05b9e2ec-8916-432f-8a56-6579eb825dd0",
    "year": 2023,
    "type": "REG"
  },
  "rankings": [
    {
      "id": "efba5350-79bc-47aa-a189-db177b95b491",
      "name": "Huskies",
      "market": "UConn",
      "net_rank": 1,
      "prev_net_rank": 2,
      "avg_opp_net_rank": 54,
      "avg_opp_net": 105,
      "wins": 37,
      "losses": 3,
      "conf_wins": 21,
      "conf_losses": 2,
      "non_conf_wins": 16,
      "non_conf_losses": 1,
      "road_wins": 9,
      "road_losses": 3,
      "net_sos": 10,
      "net_non_conf_sos": 21,
      "quad_1_wins": 18,
      "quad_1_losses": 3,
      "quad_2_wins": 8,
      "quad_2_losses": 0,
      "quad_3_wins": 1,
      "quad_3_losses": 0,
      "quad_4_wins": 10,
      "quad_4_losses": 0
    },
    {
      "id": "1f99a164-d593-4d81-85d5-0d7889d6f486",
      "name": "Cougars",
      "market": "Houston",
      "net_rank": 2,
      "prev_net_rank": 1,
      "avg_opp_net_rank": 16,
      "avg_opp_net": 89,
      "wins": 32,
      "losses": 5,
      "conf_wins": 17,
      "conf_losses": 4,
      "non_conf_wins": 15,
      "non_conf_losses": 1,
      "road_wins": 7,
      "road_losses": 3,
      "net_sos": 13,
      "net_non_conf_sos": 120,
      "quad_1_wins": 16,
      "quad_1_losses": 5,
      "quad_2_wins": 4,
      "quad_2_losses": 0,
      "quad_3_wins": 5,
      "quad_3_losses": 0,
      "quad_4_wins": 7,
      "quad_4_losses": 0
    },
    {
      "id": "12d7f888-675b-459f-9099-a38f771d8a95",
      "name": "Boilermakers",
      "market": "Purdue",
      "net_rank": 3,
      "prev_net_rank": 3,
      "avg_opp_net_rank": 3,
      "avg_opp_net": 71,
      "wins": 34,
      "losses": 5,
      "conf_wins": 18,
      "conf_losses": 4,
      "non_conf_wins": 16,
      "non_conf_losses": 1,
      "road_wins": 7,
      "road_losses": 3,
      "net_sos": 2,
      "net_non_conf_sos": 5,
      "quad_1_wins": 16,
      "quad_1_losses": 5,
      "quad_2_wins": 8,
      "quad_2_losses": 0,
      "quad_3_wins": 6,
      "quad_3_losses": 0,
      "quad_4_wins": 4,
      "quad_4_losses": 0
    },
    {
      "id": "9b166a3f-e64b-4825-bb6b-92c6f0418263",
      "name": "Wildcats",
      "market": "Arizona",
      "net_rank": 4,
      "prev_net_rank": 4,
      "avg_opp_net_rank": 11,
      "avg_opp_net": 87,
      "wins": 27,
      "losses": 9,
      "conf_wins": 16,
      "conf_losses": 6,
      "non_conf_wins": 11,
      "non_conf_losses": 3,
      "road_wins": 7,
      "road_losses": 4,
      "net_sos": 47,
      "net_non_conf_sos": 12,
      "quad_1_wins": 9,
      "quad_1_losses": 4,
      "quad_2_wins": 7,
      "quad_2_losses": 4,
      "quad_3_wins": 9,
      "quad_3_losses": 1,
      "quad_4_wins": 2,
      "quad_4_losses": 0
    }
  ]
}

Each team in the code sample has a unique ID, name, and market, along with key performance metrics that influence their ranking:

  1. NET Rank and Previous NET Rank: Indicates the team’s current position in the NCAA Evaluation Tool (NET) rankings. For example, UConn is ranked 1st, having moved up from 2nd.

  2. Conference and Non-Conference Wins/Losses: Displays how the team performed within and outside their conference. UConn has 21 conference wins and 16 non-conference wins.

  3. Strength of Schedule (SOS): Shows the difficulty of the team’s opponents, with metrics like NET SOS and NET Non-Conf SOS providing insight into the strength of their schedule.

  4. Quadrant Wins/Losses: Teams are evaluated based on wins and losses in four quadrants, each representing different levels of opponent strength. UConn, for instance, has 18 wins in Quadrant 1, the toughest category.

These metrics give a comprehensive view of a team's performance, helping developers integrate detailed ranking data for applications that track team standings, strength, and progression over the season.


NET Rankings - Recommended Pull Frequency

  • NET rankings release 1 month after the start of the season.
  • The feed updates daily when new rankings are available from the NCAA.
  • Pull on an as-needed basis.

RPI Rankings - Recommended Pull Frequency

  • RPI Rankings are updated overnight around 11 AM UTC.
  • Pull every hour or less, depending on your use case.

AP and USA Today Rankings

The Rankings (Current Week) and Rankings (By Week) endpoints return the current Associated Press and USA Today rankings, including those teams not ranked but receiving votes.


AP Rankings (Current Week) - Example:

{
  "poll": {
    "id": "9341408d-9f9a-463f-ab60-be8d1aeeffa2",
    "alias": "AP",
    "name": "AP Top 25"
  },
  "year": 2023,
  "week": "PSTF",
  "effective_time": "2024-04-09T13:15:00+00:00",
  "rankings": [
    {
      "id": "efba5350-79bc-47aa-a189-db177b95b491",
      "name": "Huskies",
      "market": "UConn",
      "rank": 1,
      "wins": 37,
      "losses": 3,
      "prev_rank": 1,
      "points": 1450,
      "fp_votes": 58
    },
    {
      "id": "12d7f888-675b-459f-9099-a38f771d8a95",
      "name": "Boilermakers",
      "market": "Purdue",
      "rank": 2,
      "wins": 34,
      "losses": 5,
      "prev_rank": 3,
      "points": 1386,
      "fp_votes": 0
    },
    {
      "id": "1f99a164-d593-4d81-85d5-0d7889d6f486",
      "name": "Cougars",
      "market": "Houston",
      "rank": 3,
      "wins": 32,
      "losses": 5,
      "prev_rank": 2,
      "points": 1217,
      "fp_votes": 0
    },
    {
      "id": "c2104cdc-c83d-40d2-a3cd-df986e29f5d3",
      "name": "Crimson Tide",
      "market": "Alabama",
      "rank": 3,
      "wins": 25,
      "losses": 12,
      "prev_rank": 19,
      "points": 1217,
      "fp_votes": 0
    },
    {
      "id": "b827dbdf-230f-4916-9703-3bb9004e26eb",
      "name": "Volunteers",
      "market": "Tennessee",
      "rank": 5,
      "wins": 27,
      "losses": 9,
      "prev_rank": 6,
      "points": 1203,
      "fp_votes": 0
    },
    {
      "id": "150148c2-ca8f-414f-8f41-d94a55d4a122",
      "name": "Fighting Illini",
      "market": "Illinois",
      "rank": 6,
      "wins": 29,
      "losses": 9,
      "prev_rank": 10,
      "points": 1095,
      "fp_votes": 0
    },
    {
      "id": "e9ca48b2-00ba-41c0-a02b-6885a2da1ff1",
      "name": "Tar Heels",
      "market": "North Carolina",
      "rank": 7,
      "wins": 29,
      "losses": 8,
      "prev_rank": 5,
      "points": 1048,
      "fp_votes": 0
    },
    {
      "id": "0e4258fa-3154-4c16-b693-adecab184c6c",
      "name": "Cyclones",
      "market": "Iowa State",
      "rank": 8,
      "wins": 29,
      "losses": 8,
      "prev_rank": 4,
      "points": 1012,
      "fp_votes": 0
    },
    {
      "id": "faeb1160-5d15-4f26-99fc-c441cf21fc7f",
      "name": "Blue Devils",
      "market": "Duke",
      "rank": 9,
      "wins": 27,
      "losses": 9,
      "prev_rank": 13,
      "points": 982,
      "fp_votes": 0
    },
    {
      "id": "52df1e19-b142-4a76-a439-ad68455d0581",
      "name": "Wolfpack",
      "market": "North Carolina State",
      "rank": 10,
      "wins": 26,
      "losses": 15,
      "points": 928,
      "fp_votes": 0
    },
    {
      "id": "9b166a3f-e64b-4825-bb6b-92c6f0418263",
      "name": "Wildcats",
      "market": "Arizona",
      "rank": 11,
      "wins": 27,
      "losses": 9,
      "prev_rank": 9,
      "points": 828,
      "fp_votes": 0
    },
    {
      "id": "06f7c904-0ac7-4125-b0f4-f4871bb69057",
      "name": "Golden Eagles",
      "market": "Marquette",
      "rank": 12,
      "wins": 27,
      "losses": 10,
      "prev_rank": 8,
      "points": 825,
      "fp_votes": 0
    },
    {
      "id": "7d797407-623e-476d-b299-46de4275414d",
      "name": "Bluejays",
      "market": "Creighton",
      "rank": 13,
      "wins": 25,
      "losses": 10,
      "prev_rank": 11,
      "points": 797,
      "fp_votes": 0
    },
    {
      "id": "dcf5c2e7-c227-4c20-af26-715d5f859412",
      "name": "Tigers",
      "market": "Clemson",
      "rank": 14,
      "wins": 24,
      "losses": 12,
      "points": 740,
      "fp_votes": 0
    },
    {
      "id": "2f4d21f8-6d5f-48a5-abca-52a30583871a",
      "name": "Bulldogs",
      "market": "Gonzaga",
      "rank": 15,
      "wins": 27,
      "losses": 8,
      "prev_rank": 18,
      "points": 684,
      "fp_votes": 0
    },
    {
      "id": "db6e1cab-3fa3-4a93-a673-8b2a358ff4bf",
      "name": "Bears",
      "market": "Baylor",
      "rank": 16,
      "wins": 24,
      "losses": 11,
      "prev_rank": 14,
      "points": 535,
      "fp_votes": 0
    },
    {
      "id": "e6914f16-ca37-4d2e-ba26-a425910283e2",
      "name": "Aztecs",
      "market": "San Diego State",
      "rank": 17,
      "wins": 26,
      "losses": 11,
      "prev_rank": 24,
      "points": 505,
      "fp_votes": 0
    },
    {
      "id": "0c0608b3-f349-4f5e-9a10-7e6a744dd0d2",
      "name": "Tigers",
      "market": "Auburn",
      "rank": 18,
      "wins": 27,
      "losses": 8,
      "prev_rank": 7,
      "points": 467,
      "fp_votes": 0
    },
    {
      "id": "fae4855b-1b64-4b40-a632-9ed345e1e952",
      "name": "Jayhawks",
      "market": "Kansas",
      "rank": 19,
      "wins": 23,
      "losses": 11,
      "prev_rank": 17,
      "points": 265,
      "fp_votes": 0
    },
    {
      "id": "2267a1f4-68f6-418b-aaf6-2aa0c4b291f1",
      "name": "Wildcats",
      "market": "Kentucky",
      "rank": 20,
      "wins": 23,
      "losses": 10,
      "prev_rank": 12,
      "points": 242,
      "fp_votes": 0
    },
    {
      "id": "b18f34af-a7f1-4659-a2e5-fc11a31cd316",
      "name": "Gaels",
      "market": "Saint Mary's",
      "rank": 21,
      "wins": 26,
      "losses": 8,
      "prev_rank": 15,
      "points": 207,
      "fp_votes": 0
    },
    {
      "id": "7672ff16-8436-47e6-8546-0fb5494ec7ee",
      "name": "Aggies",
      "market": "Utah State",
      "rank": 22,
      "wins": 28,
      "losses": 7,
      "prev_rank": 20,
      "points": 186,
      "fp_votes": 0
    },
    {
      "id": "2d4f0015-adb4-4877-8c15-4a6eed7eed03",
      "name": "Cougars",
      "market": "Washington State",
      "rank": 23,
      "wins": 25,
      "losses": 10,
      "prev_rank": 25,
      "points": 135,
      "fp_votes": 0
    },
    {
      "id": "1c7ec608-3b36-4cee-adac-9265e3792597",
      "name": "Gamecocks",
      "market": "South Carolina",
      "rank": 24,
      "wins": 26,
      "losses": 8,
      "prev_rank": 16,
      "points": 117,
      "fp_votes": 0
    },
    {
      "id": "632616c5-2dbb-4017-a449-c9dfc303f026",
      "name": "Flyers",
      "market": "Dayton",
      "rank": 25,
      "wins": 25,
      "losses": 8,
      "points": 112,
      "fp_votes": 0
    }
  ],
  "candidates": [
    {
      "id": "ef184799-d79b-49d9-a662-991eaf4044cd",
      "name": "Aggies",
      "market": "Texas A&M",
      "wins": 21,
      "losses": 15,
      "votes": 87
    },
    {
      "id": "1da70895-f77f-44ef-b216-d63c02e696eb",
      "name": "Ducks",
      "market": "Oregon",
      "wins": 24,
      "losses": 12,
      "votes": 77
    },
    {
      "id": "9fccbf28-2858-4263-821c-fdefb3c7efa3",
      "name": "Buffaloes",
      "market": "Colorado",
      "wins": 26,
      "losses": 11,
      "votes": 75
    },
    {
      "id": "c31455b2-8a45-4248-aa8f-ce7eab1c6b02",
      "name": "Cougars",
      "market": "BYU",
      "wins": 23,
      "losses": 11,
      "votes": 71
    },
    {
      "id": "6ed15092-2670-450a-99c2-61d861e87644",
      "name": "Longhorns",
      "market": "Texas",
      "wins": 21,
      "losses": 13,
      "votes": 62
    },
    {
      "id": "524e3eec-7dde-45c7-b3cc-6308cec73350",
      "name": "Dukes",
      "market": "James Madison",
      "wins": 32,
      "losses": 4,
      "votes": 61
    },
    {
      "id": "aef5e386-d8e8-460c-8014-3a2f090fd988",
      "name": "Pirates",
      "market": "Seton Hall",
      "wins": 25,
      "losses": 12,
      "votes": 39
    },
    {
      "id": "f7e6acc3-0778-4de5-940a-d88e20df1159",
      "name": "Antelopes",
      "market": "Grand Canyon",
      "wins": 30,
      "losses": 5,
      "votes": 37
    },
    {
      "id": "c7569eae-5b93-4197-b204-6f3a62146b25",
      "name": "Badgers",
      "market": "Wisconsin",
      "wins": 22,
      "losses": 14,
      "votes": 27
    },
    {
      "id": "4b7dedc0-7b48-49a4-aad6-8a94a33274d2",
      "name": "Wildcats",
      "market": "Northwestern",
      "wins": 22,
      "losses": 12,
      "votes": 23
    },
    {
      "id": "f8c705b7-87d3-411a-9c8b-5124daab0469",
      "name": "Red Raiders",
      "market": "Texas Tech",
      "wins": 23,
      "losses": 11,
      "votes": 19
    },
    {
      "id": "2a997096-a381-469d-a7e9-9e031c8b071c",
      "name": "Sycamores",
      "market": "Indiana State",
      "wins": 32,
      "losses": 7,
      "votes": 18
    },
    {
      "id": "7aec5187-cb1b-45e5-8f7d-406d766cdc73",
      "name": "Hurricanes",
      "market": "Miami (FL)",
      "wins": 15,
      "losses": 17,
      "votes": 13
    },
    {
      "id": "a41d5a05-4c11-4171-a57e-e7a1ea325a6d",
      "name": "Spartans",
      "market": "Michigan State",
      "wins": 20,
      "losses": 15,
      "votes": 12
    },
    {
      "id": "fea46ac5-6dad-43cd-a770-75554dbcc118",
      "name": "Dukes",
      "market": "Duquesne",
      "wins": 25,
      "losses": 12,
      "votes": 9
    },
    {
      "id": "ca478771-aa3d-4231-81e0-b70f519134fb",
      "name": "Bulldogs",
      "market": "Yale",
      "wins": 23,
      "losses": 10,
      "votes": 7
    },
    {
      "id": "1b1977ec-b32f-4ce3-95a4-d07bab4816cd",
      "name": "Lobos",
      "market": "New Mexico",
      "wins": 26,
      "losses": 10,
      "votes": 6
    },
    {
      "id": "c70c23c4-ab09-4797-a1af-792c848ab17f",
      "name": "Razorbacks",
      "market": "Arkansas",
      "wins": 16,
      "losses": 17,
      "votes": 6
    },
    {
      "id": "1a470730-f328-4fb1-8bbf-36a069e4d6b2",
      "name": "Rams",
      "market": "Colorado State",
      "wins": 25,
      "losses": 11,
      "votes": 5
    },
    {
      "id": "2778d005-cc14-4e58-9bf2-3fc37bffb62f",
      "name": "Terrapins",
      "market": "Maryland",
      "wins": 16,
      "losses": 17,
      "votes": 5
    },
    {
      "id": "912f8837-1d81-4ef9-a576-a21f271d4c64",
      "name": "Gators",
      "market": "Florida",
      "wins": 24,
      "losses": 12,
      "votes": 4
    },
    {
      "id": "b03bb029-4499-4a2c-9074-5071ed360b21",
      "name": "Scarlet Knights",
      "market": "Rutgers",
      "wins": 15,
      "losses": 17,
      "votes": 2
    },
    {
      "id": "62a73b4a-e281-4483-a1f8-f1160a18e456",
      "name": "Wolf Pack",
      "market": "Nevada",
      "wins": 26,
      "losses": 8,
      "votes": 1
    },
    {
      "id": "aeaaef0d-5238-414e-ac04-c55a22cba208",
      "name": "Golden Grizzlies",
      "market": "Oakland",
      "wins": 24,
      "losses": 12,
      "votes": 1
    }
  ]
}

This code sample outlines the AP Top 25 Poll for the NCAA Men's Division I Basketball Tournament, providing a snapshot of rankings, team performance, and voting points for each team during the 2023 postseason. Each team is ranked by wins, losses, and previous rank, as well as the number of first-place votes received.

For instance, the UConn Huskies are ranked 1st with a 37-3 record and 58 first-place votes. Other ranked teams like Purdue and Houston also display critical stats, including total points and rank changes from previous weeks.

This feed allows you to pull detailed ranking data, helping users track the top-performing teams and monitor shifts in standings throughout the postseason.


AP and USA Today Rankings - Recommended Call Frequency

  • All AP and USA Today Rankings are updated within 15 minutes after their release to the public, typically on Sundays.
  • Pull every hour or less, depending on your use case.


Monitoring Standings and Rankings with the Daily Change Log

The Daily Change Log can be a helpful tool for tracking potential adjustments to standings and rankings within college football (though rare). For example, if a game statistic is revised due to a correction or a late reporting of results, the change log will include an entry for the update in its results node.

Steps:

  1. Identify Change Type: When you encounter an ID within the results node, it signifies that some data associated with the game has been updated. This doesn't necessarily mean the final score has changed, but rather that various game-related details have been modified.

  2. Pull Detailed Data: Use the game IDs to pull information from the Postgame Standings and Rankings feeds.

  3. Verify Changes: After pulling the detailed data from the Postgame Standings and Rankings feeds, compare the newly retrieved data against previously stored data to verify changes to the standings and update your records accordingly.

Note: While standings and rankings data typically remains stable once games are concluded and results are recorded, rare changes can still occur, such as adjustments following a review of play outcomes or corrections of data errors. You can continue monitoring the Daily Change Log to catch any updates that could impact standings, even though such adjustments are infrequent.

⏱️

Update Frequency

TTL / Cache: 300 seconds

Data Updates:

  • Entries populate live for changes to teams, players, game statistics, schedules, and standings.
  • Start time of the log is 05:00:00 UTC; end time is 04:59:59 UTC