Wrapper for hidden ESPN API

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for zstocker from gravatar.com zstocker

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: MIT License (MIT)
  • Author: Zach
  • Requires: Python >=3.11
Classifiers
Report project as malware

Project description

espn-api

work in progress for hitting hidden espn api, right now there is nfl and nba functions, stay tuned for more

Table of Contents

NFL

includes information on apis available for the nfl

Data Files

pyespn.nfl.data.nfl_teams_data ⇒

This is a list of ids/teams in json format

example

from pyespn.nfl.data import nfl_teams_data

print(nfl_teams_data)

Team Data

functions under here get team data

pyespn.nfl.get_team_info(team_id) ⇒

Gets team info from espn api

Param Type Description
team_id number id for team

example

from pyespn.nfl import get_team_info

team_id = 30 # JAX

team_info = get_team_info(team_id=team_id)

print(team_info)

Player Data

these functions pull player data

pyespn.nfl.get_player_info(player_id) ⇒

Gets player info from espn api

Param Type Description
player_id number id for player

example

from pyespn.nfl import get_player_info

player_id = 278 # Jimmy Smith, Goat

player_info = get_player_info(player_id=player_id)

print(player_info)

pyespn.nfl.get_nfl_players_historical_stats(player_id) ⇒

Gets all players stats for career

Param Type Description
player_id number id for player

example

from pyespn.nfl import get_nfl_players_historical_stats

player_id = 278 # Jimmy Smith, Goat

player_info = get_nfl_players_historical_stats(player_id=player_id)

print(player_info)

Draft Data

these functions pull data for the draft

pyespn.nfl.get_draft_pick_data(team_id) ⇒

Gets team info from espn api

Param Type Description
pick_round number round of pick
pick number pick number in round (not overall)
season number season of draft

example

from pyespn.nfl import get_draft_pick_data

season = 2020
pick = 1
pick_round = 1

draft_pick_info = get_draft_pick_data(pick_round=pick_round,
                                      pick=pick,
                                      season=season)

print(draft_pick_info)

Game/Event Data

functions under here retrieve event/game info. game id is required and is the same from espn front page

pyespn.nfl.get_game_info(team_id, season) ⇒

returns a teams overall against the spread for a season

Param Type Description
team_id number id for team
season number year of season 
from pyespn.nfl import get_game_info

event_id = 401671889 # 2025 Super Bowl

game_info = get_game_info(event_id=event_id)

print(game_info)

Betting Data

functions under here get betting data, against the spread and futures

pyespn.nfl.get_year_nfl_super_bowl_futures(season, provider) ⇒

returns futures for superbowl winner for a given year

Param Type Description
season number Year of season
provider string Betting provider. Options:
- DraftKings
- SugarHouse
- Caesars Sportsbook (New Jersey)
- PointsBet
- Caesars Sportsbook (Colorado)
- Holland Casino
- Caesars Sportsbook (Tennessee)
- FanDuel
- Unibet
- Bet365 
from pyespn.nfl import get_year_nfl_super_bowl_futures

season = 2023
provider = 'DraftKings'

futures_record = get_year_nfl_super_bowl_futures(season=season,
                                                 provider=provider)

print(futures_record)

pyespn.nfl.get_year_nfc_division_champ_futures(season, provider) ⇒

returns afc division champions futures

Param Type Description
season number Year of season
division string Division. Options:
- north
- south
- west
- east
- conf
provider string Betting provider. Options:
- DraftKings
- SugarHouse
- Caesars Sportsbook (New Jersey)
- PointsBet
- Caesars Sportsbook (Colorado)
- Holland Casino
- Caesars Sportsbook (Tennessee)
- FanDuel
- Unibet
- Bet365 
from pyespn.nfl import get_year_afc_division_champ_futures

season = 2023
division = 'south'
provider = 'DraftKings'

futures_record = get_year_afc_division_champ_futures(season=season,
                                                     division=division,
                                                     provider=provider)

print(futures_record)

pyespn.nfl.get_year_nfc_division_champ_futures(season, provider) ⇒

returns nfc division champions futures

Param Type Description
season number Year of season
division string Division. Options:
- north
- south
- west
- east
- conf
provider string Betting provider. Options:
- DraftKings
- SugarHouse
- Caesars Sportsbook (New Jersey)
- PointsBet
- Caesars Sportsbook (Colorado)
- Holland Casino
- Caesars Sportsbook (Tennessee)
- FanDuel
- Unibet
- Bet365 
from pyespn.nfl import get_year_nfc_division_champ_futures

season = 2023
division = 'south'
provider = 'DraftKings'

futures_record = get_year_nfc_division_champ_futures(season=season,
                                                     division=division,
                                                     provider=provider)

print(futures_record)

pyespn.nfl.get_team_year_ats_overall(team_id, season) ⇒

returns a teams overall against the spread for a season

Param Type Description
team_id number id for team
season number year of season 
from pyespn.nfl import get_team_year_ats_overall

team_id = 30 # JAX
season = 2020

ats_record = get_team_year_ats_overall(team_id=team_id,
                                       season=season)

print(ats_record)

pyespn.nfl.get_team_year_ats_underdog(team_id, season) ⇒

returns a teams against the spread for a season as an underdog

Param Type Description
team_id number id for team
season number year of season 
from pyespn.nfl import get_team_year_ats_underdog

team_id = 30 # JAX
season = 2020

ats_record = get_team_year_ats_underdog(team_id=team_id,
                                        season=season)

print(ats_record)

pyespn.nfl.get_team_year_ats_away(team_id, season) ⇒

returns a teams against the spread for a season as the away team

Param Type Description
team_id number id for team
season number year of season 
from pyespn.nfl import get_team_year_ats_away

team_id = 30 # JAX
season = 2020

ats_record = get_team_year_ats_away(team_id=team_id,
                                    season=season)

print(ats_record)

pyespn.nfl.get_team_year_ats_home(team_id, season) ⇒

returns a teams against the spread for a season as the home team

Param Type Description
team_id number id for team
season number year of season 
from pyespn.nfl import get_team_year_ats_home

team_id = 30 # JAX
season = 2020

ats_record = get_team_year_ats_home(team_id=team_id,
                                    season=season)

print(ats_record)

pyespn.nfl.get_team_year_ats_home_favorite(team_id, season) ⇒

returns a teams against the spread for a season as the home team and favorite

Param Type Description
team_id number id for team
season number year of season 
from pyespn.nfl import get_team_year_ats_home_favorite

team_id = 30 # JAX
season = 2020

ats_record = get_team_year_ats_home_favorite(team_id=team_id,
                                             season=season)

print(ats_record)

pyespn.nfl.get_team_year_ats_away_underdog(team_id, season) ⇒

returns a teams against the spread for a season as the away team and underdog

Param Type Description
team_id number id for team
season number year of season 
from pyespn.nfl import get_team_year_ats_away_underdog

team_id = 30 # JAX
season = 2020

ats_record = get_team_year_ats_away_underdog(team_id=team_id,
                                             season=season)

print(ats_record)

pyespn.nfl.get_team_year_ats_home_underdog(team_id, season) ⇒

returns a teams against the spread for a season as the home team and underdog

Param Type Description
team_id number id for team
season number year of season 
from pyespn.nfl import get_team_year_ats_home_underdog

team_id = 30 # JAX
season = 2020

ats_record = get_team_year_ats_home_underdog(team_id=team_id,
                                             season=season)

print(ats_record)

NBA

Data Files

pyespn.nba.data.nfl_teams_data ⇒

This is a list of ids/teams in json format

example

from pyespn.nba.data import nba_teams_data

print(nba_teams_data)

Team Data

pyespn.nba.get_team_info(team_id) ⇒

Gets team info from espn api

Param Type Description
team_id number id for team

example

from pyespn.nba import get_team_info

team_id = 26 # Jazz

team_info = get_team_info(team_id=team_id)

print(team_info)

Player Data

these functions pull player data

pyespn.nba.get_player_info(player_id) ⇒

Gets player info from espn api

Param Type Description
player_id number id for player

example

from pyespn.nba import get_player_info

player_id = 4397002 # Ayo

player_info = get_player_info(player_id=player_id)

print(player_info)

pyespn.nba.get_nba_players_historical_stats(player_id) ⇒

Gets all players stats for career

Param Type Description
player_id number id for player

example

from pyespn.nba import get_nba_players_historical_stats

player_id = 4397002 # Ayo

player_info = get_nba_players_historical_stats(player_id=player_id)

print(player_info)

Game/Event Data

functions under here retrieve event/game info. game id is required and is the same from espn front page

pyespn.nba.get_game_info(team_id, season) ⇒

returns a teams overall against the spread for a season

Param Type Description
team_id number id for team
season number year of season 
from pyespn.nba import get_game_info

event_id = 401705402 # a game

game_info = get_game_info(event_id=event_id)

print(game_info)

Betting Data

functions under here get betting data, against the spread

pyespn.nba.get_year_nba_champ_futures(season, provider) ⇒

returns futures for finals winner for a given year

Param Type Description
season number Year of season
provider string Betting provider. Options:
- DraftKings
- SugarHouse
- Caesars Sportsbook (New Jersey)
- PointsBet
- Caesars Sportsbook (Colorado)
- Holland Casino
- Caesars Sportsbook (Tennessee)
- FanDuel
- Unibet
- Bet365 
from pyespn.nba import get_year_nba_champ_futures

season = 2023
provider = 'DraftKings'

futures_record = get_year_nba_champ_futures(season=season,
                                            provider=provider)

print(futures_record)

pyespn.nba.get_year_east_champ_futures(season, provider) ⇒

returns futures for east conf finals winner for a given year

Param Type Description
season number Year of season
provider string Betting provider. Options:
- DraftKings
- SugarHouse
- Caesars Sportsbook (New Jersey)
- PointsBet
- Caesars Sportsbook (Colorado)
- Holland Casino
- Caesars Sportsbook (Tennessee)
- FanDuel
- Unibet
- Bet365 
from pyespn.nba import get_year_east_champ_futures

season = 2023
provider = 'DraftKings'

futures_record = get_year_east_champ_futures(season=season,
                                            provider=provider)

print(futures_record)

pyespn.nba.get_year_west_champ_futures(season, provider) ⇒

returns futures for west conf finals winner for a given year

Param Type Description
season number Year of season
provider string Betting provider. Options:
- DraftKings
- SugarHouse
- Caesars Sportsbook (New Jersey)
- PointsBet
- Caesars Sportsbook (Colorado)
- Holland Casino
- Caesars Sportsbook (Tennessee)
- FanDuel
- Unibet
- Bet365 
from pyespn.nba import get_year_west_champ_futures

season = 2023
provider = 'DraftKings'

futures_record = get_year_west_champ_futures(season=season,
                                             provider=provider)

print(futures_record)

pyespn.nba.get_team_year_ats_overall(team_id, season) ⇒

returns a teams overall against the spread for a season

Param Type Description
team_id number id for team
season number year of season 
from pyespn.nba import get_team_year_ats_overall

team_id = 26 # Jazz
season = 2020

ats_record = get_team_year_ats_overall(team_id=team_id,
                                       season=season)

print(ats_record)

pyespn.nba.get_team_year_ats_underdog(team_id, season) ⇒

returns a teams against the spread for a season as an underdog

Param Type Description
team_id number id for team
season number year of season 
from pyespn.nba import get_team_year_ats_underdog

team_id = 26 # Jazz
season = 2020

ats_record = get_team_year_ats_underdog(team_id=team_id,
                                        season=season)

print(ats_record)

pyespn.nba.get_team_year_ats_away(team_id, season) ⇒

returns a teams against the spread for a season as the away team

Param Type Description
team_id number id for team
season number year of season 
from pyespn.nba import get_team_year_ats_away

team_id = 30 # JAX
season = 2020

ats_record = get_team_year_ats_away(team_id=team_id,
                                    season=season)

print(ats_record)

pyespn.nba.get_team_year_ats_home(team_id, season) ⇒

returns a teams against the spread for a season as the home team

Param Type Description
team_id number id for team
season number year of season 
from pyespn.nba import get_team_year_ats_home

team_id = 26 # Jazz
season = 2020

ats_record = get_team_year_ats_home(team_id=team_id,
                                    season=season)

print(ats_record)

pyespn.nba.get_team_year_ats_home_favorite(team_id, season) ⇒

returns a teams against the spread for a season as the home team and favorite

Param Type Description
team_id number id for team
season number year of season 
from pyespn.nba import get_team_year_ats_home_favorite

team_id = 26 # Jazz
season = 2020

ats_record = get_team_year_ats_home_favorite(team_id=team_id,
                                             season=season)

print(ats_record)

pyespn.nba.get_team_year_ats_away_underdog(team_id, season) ⇒

returns a teams against the spread for a season as the away team and underdog

Param Type Description
team_id number id for team
season number year of season 
from pyespn.nba import get_team_year_ats_away_underdog

team_id = 26 # Jazz
season = 2020

ats_record = get_team_year_ats_away_underdog(team_id=team_id,
                                             season=season)

print(ats_record)

pyespn.nba.get_team_year_ats_home_underdog(team_id, season) ⇒

returns a teams against the spread for a season as the home team and underdog

Param Type Description
team_id number id for team
season number year of season 
from pyespn.nba import get_team_year_ats_home_underdog

team_id = 26 # Jazz
season = 2020

ats_record = get_team_year_ats_home_underdog(team_id=team_id,
                                             season=season)

print(ats_record)

Draft Data

these functions pull data for the draft

pyespn.nba.get_draft_pick_data(team_id) ⇒

Gets team info from espn api

Param Type Description
pick_round number round of pick
pick number pick number in round (not overall)
season number season of draft

example

from pyespn.nba import get_draft_pick_data

season = 2021
pick = 8
pick_round = 2

draft_pick_info = get_draft_pick_data(pick_round=pick_round,
                                      pick=pick,
                                      season=season)

print(draft_pick_info)

College Football | CFB

coming..

College Basketball | CBB

coming ...

MLB

coming ...

EPL

coming ..

F1

coming ...

Project details

Verified details

These details have been verified by PyPI
Maintainers
Avatar for zstocker from gravatar.com zstocker

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: MIT License (MIT)
  • Author: Zach
  • Requires: Python >=3.11
Classifiers

Release history Release notifications | RSS feed

0.3.3

0.3.2

0.3.1

0.3.0

0.2.2

0.2.1

0.2.0

0.1.7

0.1.5

0.1.4

0.1.2

This version

0.1.1

0.1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pyespn-0.1.1-py3-none-any.whl (19.8 kB view details)

Uploaded Python 3

File details

Details for the file pyespn-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: pyespn-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 19.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.11

File hashes

Hashes for pyespn-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 05245a9d97cd1a851a5b8b09ee12f9b3ef390036bd6267752f638289f430c611
MD5 7f19a57398d19717cc6f82aeaf2fc01a
BLAKE2b-256 1dac2403e8c7ed16ea52895ea925f8dc0782eb815685822f1d5a1878327818d9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page