College Football (CFB) API Documentation

This API provides access to a wide range of data related to college football, including play-by-play information, box scores, summaries, rankings, player and team statistics, injuries, team rosters, schedules, and more.

Retrieve Play by Play Data

GET /pbp/{gameId}

Retrieve Play by Play data for a specific game.

Parameters

Name	Type	Description
gameId	string	ID of the game

Response

• Status: 200 OK
• Content: JSON object representing the Play by Play data

Retrieve Box Score Data

GET /boxscore/{gameId}

Retrieve Box Score data for a specific game.

Parameters

Name	Type	Description
gameId	string	ID of the game

Response

• Status: 200 OK
• Content: JSON object representing the Box Score data

Retrieve Summary Data

GET /summary/{gameId}

Retrieve Summary data for a specific game.

Parameters

Name	Type	Description
gameId	string	ID of the game

Response

• Status: 200 OK
• Content: JSON object representing the Summary data

Retrieve Picks Data

GET /picks/{gameId}

Retrieve Picks data for a specific game.

Parameters

Name	Type	Description
gameId	string	ID of the game

Response

• Status: 200 OK
• Content: JSON object representing the Picks data

Retrieve Rankings

GET /rankings

Retrieve rankings data for a specific year and week.

Parameters

Name	Type	Description
year	number	Year
week	number	Week (default: 1)

Response

• Status: 200 OK
• Content: JSON object representing the rankings data

Retrieve Player Rankings

GET /player-rankings

Retrieve player rankings data for a specific year, page, and group.

Parameters

Name	Type	Description
year	number	Year
page	number	Page (default: 1)
group	string	Group (default: “HighSchool”)

Response

• Status: 200 OK
• Content: JSON object representing the player rankings data

Retrieve School Rankings

GET /school-rankings

Retrieve school rankings data for a specific year and page.

Parameters

Name	Type	Description
year	number	Year
page	number	Page (default: 1)

Response

• Status: 200 OK
• Content: JSON object representing the school rankings data

Retrieve School Commits Data

GET /school-commits

Retrieve school commits data for a specific year and school.

Parameters

Name	Type	Description
year	number	Year
school	string	School

Response

• Status: 200 OK
• Content: JSON object representing the school commits data

Retrieve Schedule Data

GET /schedule

Retrieve schedule data for a specific year, month, day, group, and seasontype.

Parameters

Name	Type	Description
year	number	Year
month	number	Month
day	number	Day
group	number	Group (default: 50)
seasontype	number	Season type (default: 2)

Response

• Status: 200 OK
• Content: JSON object representing the schedule data

Retrieve Scoreboard Data

GET /scoreboard

Retrieve scoreboard data for a specific year, month, day, group, seasontype, and limit.

Parameters

Name	Type	Description
year	string	Year
month	string	Month
day	string	Day
group	string	Group (default: 50)
seasontype	number	Season type (default: 1)
limit	number	Limit on the number of results

Response

• Status: 200 OK
• Content: JSON object representing the scoreboard data

Retrieve Conferences Data

GET /conferences

Retrieve conferences data for a specific year and group.

Parameters

Name	Type	Description
year	string	Year
group	string	Group (default: 50)

Response

• Status: 200 OK
• Content: JSON object representing the conferences data

Retrieve Standings Data

GET /standings

Retrieve standings data for a specific year and group.

Parameters

Name	Type	Description
year	string	Year
group	string	Group (default: 50)

Response

• Status: 200 OK
• Content: JSON object representing the standings data

Retrieve Team List Data

GET /team-list

Retrieve list of teams for a specific group.

Parameters

Name	Type	Description
group	number	Group (default: 50)

Response

• Status: 200 OK
• Content: JSON object representing the team list data

Retrieve Team Info Data

GET /team-info/:teamId

Retrieve information for a specific team.

Parameters

Name	Type	Description
teamId	string	ID of the team

Response

• Status: 200 OK
• Content: JSON object representing the team info data

Retrieve Team Players Data

GET /team-players/{teamId}

Retrieve players for a specific team.

Parameters

Name	Type	Description
teamId	string	ID of the team

Response

• Status: 200 OK
• Content: JSON object representing the team players data

Retrieve News Data

GET /news

Retrieve latest news data.

Response

• Status: 200 OK
• Content: JSON object representing the news data

Retrieve Team Statistics Data

GET /team-statistic

Retrieve statistics for a specific team.

Parameters

Name	Type	Description
teamId	string	ID of the team

Response

• Status: 200 OK
• Content: JSON object representing the team statistics data

Retrieve Injuries

GET /injuries

Retrieve injury data for the current season.

Response

• Status: 200 OK
• Content: JSON object representing the injuries data

Retrieve Team Roster Data

GET /team-roster

Retrieve roster for a specific team and season.

Parameters

Name	Type	Description
teamId	string	ID of the team
season	number	Season

Response

• Status: 200 OK
• Content: JSON object representing the team roster data

Retrieve Schedule by Team

GET /schedule-team

Retrieve schedule data for a specific team and season.

Parameters

Name	Type	Description
teamId	string	ID of the team
season	number	Season

Response

• Status: 200 OK
• Content: JSON object representing the team schedule data