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

CFBD/cfbd-python