Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Integration Guides

Standings and Rankings

Use this guide to effectively access NCAA Football (NCAAFB) standings and rankings. It also covers the Daily Change Log endpoint which can be used to track standings revisions.

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.



Difference Between Standings and Rankings

In college football, standings and rankings/polls serve different purposes:

  • Standings reflect a team's performance within a conference, based on their win-loss record and conference record. These determine eligibility for conference championships and bowl games.
  • Rankings/Polls are subjective assessments of teams by sports writers, coaches, and analysts. Key rankings include the AP Poll, Coaches Poll, and College Football Playoff (CFP) Rankings. These are based on factors like win-loss record, strength of schedule, performance, and voter opinions. Rankings influence postseason matchups and national championship contenders.


Accessing Standings

You can access standings using the Postgame Standings feed. This endpoint provides standings information for each team, updated postgame.

Recommended Call Frequency:

  • Standings are updated on a two-minute timer after each game is moved to complete.
  • Pull every hour or less, depending on your use case.
  • Pull 2-5 mins after a game is moved to 'complete' to receive the quickest updates.

Understanding Postgame Standings Data

{
  "season": {
    "id": "f58c6dbf-9dfe-487e-8b0b-af66af887206",
    "year": 2023,
    "type": "REG",
    "name": "REG"
  },
  "divisions": [
    {
      "id": "43d3cede-6b8f-4158-bc7f-c3c7365e5b32",
      "name": "I-A",
      "alias": "FBS",
      "conferences": [
        {
          "id": "cddff7c9-65e1-4fe0-b052-87fd4213fbfe",
          "name": "Big Ten",
          "alias": "BIG-TEN",
          "teams": [
            {
              "id": "1cdf66a2-f157-4b4f-ad37-bd31e268f0ae",
              "name": "Spartans",
              "market": "Michigan State",
              "alias": "MSU",
              "rank": {
                "conference": 13,
                "division": 98,
                "subdivision": 6
              },
              "streak": {
                "type": "loss",
                "length": 1,
                "desc": "Lost 1"
              },
              "strength_of_schedule": {
                "sos": 0.652,
                "wins": 103,
                "total": 158
              },
              "strength_of_victory": {
                "sov": 0.449,
                "wins": 22,
                "total": 49
              },
              "wins": 4,
              "losses": 8,
              "ties": 0,
              "win_pct": 0.333,
              "points_for": 191,
              "points_against": 340,
              "records": [
                {
                  "category": "d2",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "division",
                  "wins": 3,
                  "losses": 8,
                  "ties": 0,
                  "win_pct": 0.273,
                  "points_for": 146,
                  "points_against": 326
                },
                {
                  "category": "road",
                  "wins": 1,
                  "losses": 4,
                  "ties": 0,
                  "win_pct": 0.2,
                  "points_for": 79,
                  "points_against": 139
                },
                {
                  "category": "home",
                  "wins": 3,
                  "losses": 4,
                  "ties": 0,
                  "win_pct": 0.429,
                  "points_for": 112,
                  "points_against": 201
                },
                {
                  "category": "fbs",
                  "wins": 3,
                  "losses": 8,
                  "ties": 0,
                  "win_pct": 0.273,
                  "points_for": 146,
                  "points_against": 326
                },
                {
                  "category": "naia",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "fcs",
                  "wins": 1,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 1,
                  "points_for": 45,
                  "points_against": 14
                },
                {
                  "category": "conference",
                  "wins": 2,
                  "losses": 7,
                  "ties": 0,
                  "win_pct": 0.222,
                  "points_for": 108,
                  "points_against": 278
                },
                {
                  "category": "d3",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "uscaa",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                }
              ]
            },
            {
              "id": "2d824a5f-e706-45b8-9d20-434ed5dd5c2f",
              "name": "Fighting Illini",
              "market": "Illinois",
              "alias": "ILL",
              "rank": {
                "conference": 11,
                "division": 87,
                "subdivision": 6
              },
              "streak": {
                "type": "loss",
                "length": 2,
                "desc": "Lost 2"
              },
              "strength_of_schedule": {
                "sos": 0.552,
                "wins": 85,
                "total": 154
              },
              "strength_of_victory": {
                "sov": 0.5,
                "wins": 32,
                "total": 64
              },
              "wins": 5,
              "losses": 7,
              "ties": 0,
              "win_pct": 0.417,
              "points_for": 294,
              "points_against": 353,
              "records": [
                {
                  "category": "road",
                  "wins": 2,
                  "losses": 3,
                  "ties": 0,
                  "win_pct": 0.4,
                  "points_for": 109,
                  "points_against": 143
                },
                {
                  "category": "fcs",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "conference",
                  "wins": 3,
                  "losses": 6,
                  "ties": 0,
                  "win_pct": 0.333,
                  "points_for": 218,
                  "points_against": 274
                },
                {
                  "category": "home",
                  "wins": 3,
                  "losses": 4,
                  "ties": 0,
                  "win_pct": 0.429,
                  "points_for": 185,
                  "points_against": 210
                },
                {
                  "category": "d3",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "d2",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "division",
                  "wins": 5,
                  "losses": 7,
                  "ties": 0,
                  "win_pct": 0.417,
                  "points_for": 294,
                  "points_against": 353
                },
                {
                  "category": "naia",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "fbs",
                  "wins": 5,
                  "losses": 7,
                  "ties": 0,
                  "win_pct": 0.417,
                  "points_for": 294,
                  "points_against": 353
                },
                {
                  "category": "uscaa",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                }
              ]
            },
            {
              "id": "485dd62f-108c-4e32-b171-27f5d493552d",
              "name": "Boilermakers",
              "market": "Purdue",
              "alias": "PUR",
              "rank": {
                "conference": 12,
                "division": 81,
                "subdivision": 7
              },
              "streak": {
                "type": "win",
                "length": 1,
                "desc": "Won 1"
              },
              "strength_of_schedule": {
                "sos": 0.59,
                "wins": 92,
                "total": 156
              },
              "strength_of_victory": {
                "sov": 0.42,
                "wins": 21,
                "total": 50
              },
              "wins": 4,
              "losses": 8,
              "ties": 0,
              "win_pct": 0.333,
              "points_for": 287,
              "points_against": 365,
              "records": [
                {
                  "category": "home",
                  "wins": 3,
                  "losses": 4,
                  "ties": 0,
                  "win_pct": 0.429,
                  "points_for": 207,
                  "points_against": 233
                },
                {
                  "category": "conference",
                  "wins": 3,
                  "losses": 6,
                  "ties": 0,
                  "win_pct": 0.333,
                  "points_for": 208,
                  "points_against": 274
                },
                {
                  "category": "fcs",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "d3",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "road",
                  "wins": 1,
                  "losses": 4,
                  "ties": 0,
                  "win_pct": 0.2,
                  "points_for": 80,
                  "points_against": 132
                },
                {
                  "category": "naia",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "uscaa",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "d2",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "fbs",
                  "wins": 4,
                  "losses": 8,
                  "ties": 0,
                  "win_pct": 0.333,
                  "points_for": 287,
                  "points_against": 365
                },
                {
                  "category": "division",
                  "wins": 4,
                  "losses": 8,
                  "ties": 0,
                  "win_pct": 0.333,
                  "points_for": 287,
                  "points_against": 365
                }
              ]
            },
            {
              "id": "709c25ab-2674-4d9f-9571-69c5ee9363b6",
              "name": "Golden Gophers",
              "market": "Minnesota",
              "alias": "MIN",
              "rank": {
                "conference": 10,
                "division": 52,
                "subdivision": 5
              },
              "streak": {
                "type": "win",
                "length": 1,
                "desc": "Won 1"
              },
              "strength_of_schedule": {
                "sos": 0.571,
                "wins": 96,
                "total": 168
              },
              "strength_of_victory": {
                "sov": 0.494,
                "wins": 38,
                "total": 77
              },
              "wins": 6,
              "losses": 7,
              "ties": 0,
              "win_pct": 0.462,
              "points_for": 272,
              "points_against": 347,
              "records": [
                {
                  "category": "division",
                  "wins": 6,
                  "losses": 7,
                  "ties": 0,
                  "win_pct": 0.462,
                  "points_for": 272,
                  "points_against": 347
                },
                {
                  "category": "home",
                  "wins": 5,
                  "losses": 3,
                  "ties": 0,
                  "win_pct": 0.625,
                  "points_for": 180,
                  "points_against": 183
                },
                {
                  "category": "fcs",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "uscaa",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "conference",
                  "wins": 3,
                  "losses": 6,
                  "ties": 0,
                  "win_pct": 0.333,
                  "points_for": 169,
                  "points_against": 262
                },
                {
                  "category": "d2",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "d3",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "road",
                  "wins": 1,
                  "losses": 4,
                  "ties": 0,
                  "win_pct": 0.2,
                  "points_for": 92,
                  "points_against": 164
                },
                {
                  "category": "naia",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "fbs",
                  "wins": 6,
                  "losses": 7,
                  "ties": 0,
                  "win_pct": 0.462,
                  "points_for": 272,
                  "points_against": 347
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}


  1. Season and Division Information

    • The data specifies the season (2023) and type (regular season), providing context for the standings and rankings within this particular year.

    • Divisions and conferences are clearly outlined, such as the I-AA (FCS) division and the Coastal Athletic Association (CAA), organizing teams within their respective categories.

  2. Team Data

    • Each team includes an ID, name, market, and relevant statistics:

      • Record (Wins, Losses): Indicates the team's overall performance with specific details like total wins, losses, and win percentage, essential for determining standings.

      • Rank: Shows the team's ranking within the conference, division, and subdivision, which helps in understanding their relative position.

      • Streaks: Displays the team's current streak, such as a "Lost 1" streak, indicating recent performance trends.

      • Points For and Against: These metrics reflect the team's offensive and defensive effectiveness, useful for tiebreakers and assessing overall strength.

  3. Categories: The category field within a team's records provides a breakdown of performance in various contexts:

    • Division: Performance against teams within the same division, crucial for divisional standings and playoff implications.

    • Conference: Reflects the team's record against all teams within their conference, impacting conference rankings.

    • Home and Road: Displays how the team performs at home versus on the road, indicating home-field advantage or challenges in away games.

    • Other Categories: Includes specific records against different levels of competition, such as FBS or NAIA, showing how the team fares against various types of opponents.

    • Win Percentage and Points: These metrics within each category provide insight into how effectively the team performs in different scenarios, contributing to a comprehensive evaluation of their season.

  4. Strength Metrics

    • Strength of Schedule (SOS) and Strength of Victory (SOV): These analytical metrics assess the quality of the team's opponents and victories. A higher SOS indicates tougher opponents, while a higher SOV reflects the strength of the teams they've defeated. These metrics are important for understanding the context of the team's performance beyond just their win-loss record.

You might consider displaying NCAAFB 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 road records.



Accessing Rankings

You can access NCAAFB rankings using the following feeds:

We support rankings from five different polls:

  • AP25: The Associated Press
  • EU25: Amway Coaches
  • CFP25: College Football Playoff
  • FCS25: FCS Media
  • FCSC25: AFCA FCS Coaches

Recommended Call Frequency:

  • Rankings are updated within 15 minutes after their release to the public, typically on Sundays.
  • The CFP rankings begin after week 10, and are typically released on Tuesdays.
  • Pull every hour or less on these days during the season, depending on your use case.

Understandings Rankings Data

The following example illustrates week 5 of the 2023 seasons for the Rankings (By Week) feed.

{
  "poll": {
    "id": "aef92d2e-6f2d-462a-972b-f38859ddb96f",
    "alias": "AP25",
    "name": "Associated Press Top 25"
  },
  "season": 2023,
  "week": 5,
  "effective_time": "2023-09-24T18:11:00+00:00",
  "rankings": [
    {
      "id": "2eef738d-c637-4b12-b8df-4b79efcce71e",
      "name": "Bulldogs",
      "market": "Georgia",
      "rank": 1,
      "wins": 4,
      "losses": 0,
      "ties": 0,
      "prev_rank": 1,
      "points": 1562,
      "fp_votes": 55
    },
    {
      "id": "d3e8c416-e643-4d5e-be9e-c598a150b234",
      "name": "Wolverines",
      "market": "Michigan",
      "rank": 2,
      "wins": 4,
      "losses": 0,
      "ties": 0,
      "prev_rank": 2,
      "points": 1445,
      "fp_votes": 1
    },
    {
      "id": "ae68bc50-4135-47b5-b2f1-03d0669e54c8",
      "name": "Longhorns",
      "market": "Texas",
      "rank": 3,
      "wins": 4,
      "losses": 0,
      "ties": 0,
      "prev_rank": 3,
      "points": 1401,
      "fp_votes": 2
    },
    {
      "id": "9a6d6f3f-021e-4ddd-8fac-ac4766239d87",
      "name": "Buckeyes",
      "market": "Ohio State",
      "rank": 4,
      "wins": 4,
      "losses": 0,
      "ties": 0,
      "prev_rank": 6,
      "points": 1370,
      "fp_votes": 1
    },
    {
      "id": "1c792ab1-d640-48f2-b796-6a81c7b14eaf",
      "name": "Seminoles",
      "market": "Florida State",
      "rank": 5,
      "wins": 4,
      "losses": 0,
      "ties": 0,
      "prev_rank": 4,
      "points": 1351,
      "fp_votes": 3
    },
    {
      "id": "eeb3ce19-6ddd-4c91-afab-811c6cc81974",
      "name": "Nittany Lions",
      "market": "Penn State",
      "rank": 6,
      "wins": 4,
      "losses": 0,
      "ties": 0,
      "prev_rank": 7,
      "points": 1244
    },
    {
      "id": "7293edba-9810-444b-9df1-709c24d1c522",
      "name": "Huskies",
      "market": "Washington",
      "rank": 7,
      "wins": 4,
      "losses": 0,
      "ties": 0,
      "prev_rank": 8,
      "points": 1228,
      "fp_votes": 1
    },
    {
      "id": "8f496f34-14e3-4ca7-958b-53f6da0b74d6",
      "name": "Trojans",
      "market": "USC",
      "rank": 8,
      "wins": 4,
      "losses": 0,
      "ties": 0,
      "prev_rank": 5,
      "points": 1169
    },
    {
      "id": "5c218a3b-a013-4037-97b6-603c9502b701",
      "name": "Ducks",
      "market": "Oregon",
      "rank": 9,
      "wins": 4,
      "losses": 0,
      "ties": 0,
      "prev_rank": 10,
      "points": 1076
    },
    {
      "id": "28e1dbb0-1295-42ca-bda1-fddb122aed2b",
      "name": "Utes",
      "market": "Utah",
      "rank": 10,
      "wins": 4,
      "losses": 0,
      "ties": 0,
      "prev_rank": 11,
      "points": 981
    },
    {
      "id": "d7f19bff-74e7-4b71-a221-12dfeb144fd8",
      "name": "Fighting Irish",
      "market": "Notre Dame",
      "rank": 11,
      "wins": 4,
      "losses": 1,
      "ties": 0,
      "prev_rank": 9,
      "points": 904
    },
    {
      "id": "19775492-f1eb-4bc5-9e15-078ebd689c0f",
      "name": "Crimson Tide",
      "market": "Alabama",
      "rank": 12,
      "wins": 3,
      "losses": 1,
      "ties": 0,
      "prev_rank": 13,
      "points": 862
    },
    {
      "id": "ffca4209-dbfa-4597-b25a-ed19bb351037",
      "name": "Tigers",
      "market": "LSU",
      "rank": 13,
      "wins": 3,
      "losses": 1,
      "ties": 0,
      "prev_rank": 12,
      "points": 813
    },
    {
      "id": "242f21d8-7372-4359-a04f-4d467ead22d6",
      "name": "Sooners",
      "market": "Oklahoma",
      "rank": 14,
      "wins": 4,
      "losses": 0,
      "ties": 0,
      "prev_rank": 16,
      "points": 716
    },
    {
      "id": "79368b86-8bb0-4c66-8189-b836d039c207",
      "name": "Tar Heels",
      "market": "North Carolina",
      "rank": 15,
      "wins": 4,
      "losses": 0,
      "ties": 0,
      "prev_rank": 17,
      "points": 659
    },
    {
      "id": "1ff5428d-2e8c-4b0f-a5a6-ebff126111a2",
      "name": "Cougars",
      "market": "Washington State",
      "rank": 16,
      "wins": 4,
      "losses": 0,
      "ties": 0,
      "prev_rank": 21,
      "points": 652
    },
    {
      "id": "deb0920f-c4ca-414d-be4b-ca779e353bf0",
      "name": "Blue Devils",
      "market": "Duke",
      "rank": 17,
      "wins": 4,
      "losses": 0,
      "ties": 0,
      "prev_rank": 18,
      "points": 648
    },
    {
      "id": "2f475a40-df87-43a7-b8a9-c36a43edff21",
      "name": "Hurricanes",
      "market": "Miami (FL)",
      "rank": 18,
      "wins": 4,
      "losses": 0,
      "ties": 0,
      "prev_rank": 20,
      "points": 523
    },
    {
      "id": "6fddb136-b83b-4f5f-8574-54e5581aeaae",
      "name": "Beavers",
      "market": "Oregon State",
      "rank": 19,
      "wins": 3,
      "losses": 1,
      "ties": 0,
      "prev_rank": 14,
      "points": 366
    },
    {
      "id": "e3df6700-2881-4b02-a170-f397bb5718a9",
      "name": "Rebels",
      "market": "Ole Miss",
      "rank": 20,
      "wins": 3,
      "losses": 1,
      "ties": 0,
      "prev_rank": 15,
      "points": 349
    },
    {
      "id": "9ecb9f6b-df4a-4a92-aaa4-5d50a5286bdd",
      "name": "Volunteers",
      "market": "Tennessee",
      "rank": 21,
      "wins": 3,
      "losses": 1,
      "ties": 0,
      "prev_rank": 23,
      "points": 260
    },
    {
      "id": "c765cbff-99d8-4c43-8f6b-e49577ca18fa",
      "name": "Gators",
      "market": "Florida",
      "rank": 22,
      "wins": 3,
      "losses": 1,
      "ties": 0,
      "prev_rank": 25,
      "points": 235
    },
    {
      "id": "772536c7-c3e8-40d1-ac6e-232d719dc052",
      "name": "Tigers",
      "market": "Missouri",
      "rank": 23,
      "wins": 4,
      "losses": 0,
      "ties": 0,
      "points": 197
    },
    {
      "id": "d0212bdb-5dd4-4604-a221-9adf26e6fd4a",
      "name": "Jayhawks",
      "market": "Kansas",
      "rank": 24,
      "wins": 4,
      "losses": 0,
      "ties": 0,
      "points": 132
    },
    {
      "id": "558f07ed-85b3-447d-bdd2-9cd98ca3a547",
      "name": "Bulldogs",
      "market": "Fresno State",
      "rank": 25,
      "wins": 4,
      "losses": 0,
      "ties": 0,
      "points": 64
    }
  ],
  "candidates": [
    {
      "id": "0dd26ea7-79fb-4ea8-bf48-7c31108e14a3",
      "name": "Wildcats",
      "market": "Kansas State",
      "wins": 3,
      "losses": 1,
      "ties": 0,
      "votes": 57
    },
    {
      "id": "5941ffa3-cdd5-459b-ab61-fef120b929b2",
      "name": "Wildcats",
      "market": "Kentucky",
      "wins": 4,
      "losses": 0,
      "ties": 0,
      "votes": 41
    },
    {
      "id": "1e8edb90-ea5e-4663-9a65-a30e51583711",
      "name": "Cardinals",
      "market": "Louisville",
      "wins": 4,
      "losses": 0,
      "ties": 0,
      "votes": 32
    },
    {
      "id": "a18d7cf8-1263-45f2-a938-04032d2f7cf5",
      "name": "Buffaloes",
      "market": "Colorado",
      "wins": 3,
      "losses": 1,
      "ties": 0,
      "prev_rank": 19,
      "votes": 32
    },
    {
      "id": "398eda2b-ba77-469f-94df-18fd1d9087d8",
      "name": "Bruins",
      "market": "UCLA",
      "wins": 3,
      "losses": 1,
      "ties": 0,
      "prev_rank": 22,
      "votes": 28
    },
    {
      "id": "e2a7ee48-c096-4aac-a7a2-4f1f35baa835",
      "name": "Terrapins",
      "market": "Maryland",
      "wins": 4,
      "losses": 0,
      "ties": 0,
      "votes": 20
    },
    {
      "id": "a09e634d-39a8-4aa8-81a4-7337580a31f4",
      "name": "Horned Frogs",
      "market": "TCU",
      "wins": 3,
      "losses": 1,
      "ties": 0,
      "votes": 17
    },
    {
      "id": "6551124f-312e-49c8-87c4-d1cba14133c7",
      "name": "Green Wave",
      "market": "Tulane",
      "wins": 3,
      "losses": 1,
      "ties": 0,
      "votes": 11
    },
    {
      "id": "6fad29be-d988-4014-9640-ad26a14d3bd1",
      "name": "Orange",
      "market": "Syracuse",
      "wins": 4,
      "losses": 0,
      "ties": 0,
      "votes": 8
    },
    {
      "id": "7dbca160-b9d8-4da4-8176-2445cb4b34d2",
      "name": "Badgers",
      "market": "Wisconsin",
      "wins": 3,
      "losses": 1,
      "ties": 0,
      "votes": 6
    },
    {
      "id": "9f40a53c-d4bc-4d58-8208-2227634f9454",
      "name": "Falcons",
      "market": "Air Force",
      "wins": 4,
      "losses": 0,
      "ties": 0,
      "votes": 6
    },
    {
      "id": "95404613-f4f0-4280-ac27-85419215f8d1",
      "name": "Tigers",
      "market": "Clemson",
      "wins": 2,
      "losses": 2,
      "ties": 0,
      "votes": 5
    },
    {
      "id": "d5199a36-7f26-4c3b-be48-9599039e232c",
      "name": "Aggies",
      "market": "Texas A&M",
      "wins": 3,
      "losses": 1,
      "ties": 0,
      "votes": 5
    }
  ]
}

  1. Team Rankings:

    • Each team's ranking data includes the team's ID, name, market (which is typically the school or team’s location), and current rank within the poll. This rank indicates their position relative to other teams in the nation.

    • Wins, Losses: These statistics show the team's current performance record, crucial for determining their rank.

    • Previous Rank: Displays the team's rank in the previous week, providing insight into how their position has changed.

    • Points and First-Place Votes (fp_votes): Points are used to rank teams, typically reflecting the collective votes from the poll voters. First-place votes indicate how many voters placed this team at the top, offering additional context on how strongly they are viewed by voters.

  2. Ranking Candidates:

    • In addition to the top 25 teams, the data also lists candidates for the rankings—teams that received votes but did not make it into the top 25.

    • Each candidate includes details such as wins, losses, and the number of votes received. This information highlights teams that are on the cusp of being ranked and could potentially move into the top 25 with future performances.

Purpose and Usage:

  • This data is crucial for understanding the weekly shifts in college football rankings, as it reflects both objective performance metrics (like wins and losses) and subjective assessments (like points and first-place votes) by the poll voters.

  • The rankings play a significant role in determining postseason opportunities and national championships.



Monitoring Standings and Rankings Using the Daily Change Log

The Daily Change Log endpoint can be a helpful tool for tracking potential adjustments to standings and rankings in NCAAFB (though rare). For example, if a game result or statistic that could impact standings 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 feed, 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.