College Football Data API


Keywords
Swagger, College, Football, Data, API, cfb, cfb-analytics, college-football, sports-analytics, sports-data
Install
pip install cfbd==5.1.2a1

Documentation

cfbd

This is an API for accessing all sorts of college football data. Please note that API keys should be supplied with "Bearer " prepended (e.g. "Bearer your_key"). API keys can be acquired from the CollegeFootballData.com website.

This Python package is automatically generated by the Swagger Codegen project:

  • API version: 4.6.0
  • Package version: 4.6.0
  • Build package: io.swagger.codegen.languages.PythonClientCodegen

Requirements.

Python 2.7 and 3.4+

Installation & Usage

pip install

pip install cfbd

(you may need to run pip with root permission: sudo pip install cfbd)

Then import the package:

import cfbd 

Setuptools

Install via Setuptools.

python setup.py install --user

(or sudo python setup.py install to install the package for all users)

Then import the package:

import cfbd

Getting Started

Please follow the installation procedure and then run the following:

from __future__ import print_function
import time
import cfbd
from cfbd.rest import ApiException
from pprint import pprint

# Configure API key authorization: ApiKeyAuth
configuration = cfbd.Configuration()
configuration.api_key['Authorization'] = 'YOUR_API_KEY'
configuration.api_key_prefix['Authorization'] = 'Bearer'

# create an instance of the API class
api_instance = cfbd.BettingApi(cfbd.ApiClient(configuration))
game_id = 56 # int | Game id filter (optional)
year = 56 # int | Year/season filter for games (optional)
week = 56 # int | Week filter (optional)
season_type = 'regular' # str | Season type filter (regular or postseason) (optional) (default to regular)
team = 'team_example' # str | Team (optional)
home = 'home_example' # str | Home team filter (optional)
away = 'away_example' # str | Away team filter (optional)
conference = 'conference_example' # str | Conference abbreviation filter (optional)

try:
    # Betting lines
    api_response = api_instance.get_lines(game_id=game_id, year=year, week=week, season_type=season_type, team=team, home=home, away=away, conference=conference)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling BettingApi->get_lines: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to https://api.collegefootballdata.com

Class Method HTTP request Description
BettingApi get_lines GET /lines Betting lines
CoachesApi get_coaches GET /coaches Coaching records and history
ConferencesApi get_conferences GET /conferences Conferences
DraftApi get_draft_picks GET /draft/picks List of NFL Draft picks
DraftApi get_nfl_positions GET /draft/positions List of NFL positions
DraftApi get_nfl_teams GET /draft/teams List of NFL teams
DrivesApi get_drives GET /drives Drive data and results
GamesApi get_advanced_box_score GET /game/box/advanced Advanced box scores
GamesApi get_calendar GET /calendar Season calendar
GamesApi get_game_media GET /games/media Game media information and schedules
GamesApi get_game_weather GET /games/weather Game weather information (Patreon only)
GamesApi get_games GET /games Games and results
GamesApi get_player_game_stats GET /games/players Player game stats
GamesApi get_scoreboard GET /scoreboard Live game results (Patreon only)
GamesApi get_team_game_stats GET /games/teams Team game stats
GamesApi get_team_records GET /records Team records
MetricsApi get_fgep GET /metrics/fg/ep Field Goal Expected Points
MetricsApi get_game_ppa GET /ppa/games Team Predicated Points Added (PPA/EPA) by game
MetricsApi get_player_game_ppa GET /ppa/players/games Player Predicated Points Added (PPA/EPA) broken down by game
MetricsApi get_player_season_ppa GET /ppa/players/season Player Predicated Points Added (PPA/EPA) broken down by season
MetricsApi get_predicted_points GET /ppa/predicted Predicted Points (i.e. Expected Points or EP)
MetricsApi get_pregame_win_probabilities GET /metrics/wp/pregame Pregame win probability data
MetricsApi get_team_ppa GET /ppa/teams Predicted Points Added (PPA/EPA) data by team
MetricsApi get_win_probability_data GET /metrics/wp Win probability chart data
PlayersApi get_player_season_stats GET /stats/player/season Player stats by season
PlayersApi get_player_usage GET /player/usage Player usage metrics broken down by season
PlayersApi get_returning_production GET /player/returning Team returning production metrics
PlayersApi get_transfer_portal GET /player/portal Transfer portal by season
PlayersApi player_search GET /player/search Search for player information
PlaysApi get_live_plays GET /live/plays Live metrics and PBP (Patreon only)
PlaysApi get_play_stat_types GET /play/stat/types Types of player play stats
PlaysApi get_play_stats GET /play/stats Play stats by play
PlaysApi get_play_types GET /play/types Play types
PlaysApi get_plays GET /plays Play by play data
RankingsApi get_rankings GET /rankings Historical polls and rankings
RatingsApi get_conference_sp_ratings GET /ratings/sp/conferences Historical SP+ ratings by conference
RatingsApi get_elo_ratings GET /ratings/elo Historical Elo ratings
RatingsApi get_fpi_ratings GET /ratings/fpi Historical FPI ratings
RatingsApi get_sp_ratings GET /ratings/sp Historical SP+ ratings
RatingsApi get_srs_ratings GET /ratings/srs Historical SRS ratings
RecruitingApi get_recruiting_groups GET /recruiting/groups Recruit position group ratings
RecruitingApi get_recruiting_players GET /recruiting/players Player recruiting ratings and rankings
RecruitingApi get_recruiting_teams GET /recruiting/teams Team recruiting rankings and ratings
StatsApi get_advanced_team_game_stats GET /stats/game/advanced Advanced team metrics by game
StatsApi get_advanced_team_season_stats GET /stats/season/advanced Advanced team metrics by season
StatsApi get_stat_categories GET /stats/categories Team stat categories
StatsApi get_team_season_stats GET /stats/season Team statistics by season
TeamsApi get_fbs_teams GET /teams/fbs FBS team list
TeamsApi get_roster GET /roster Team rosters
TeamsApi get_talent GET /talent Team talent composite rankings
TeamsApi get_team_matchup GET /teams/matchup Team matchup history
TeamsApi get_teams GET /teams Team information
VenuesApi get_venues GET /venues Arena and venue information

Documentation For Models

Documentation For Authorization

ApiKeyAuth

  • Type: API key
  • API key parameter name: Authorization
  • Location: HTTP header

Author

admin@collegefootballdata.com