Skip to main content

ESPN API

Project description

codecov Join the chat at https://gitter.im/ff-espn-api/community PyPI version

ESPN API

This package uses ESPN's Fantasy API to extract data from any public or private league for Fantasy Football and Basketball (NHL, MLB, and WNBA are in development).
Please feel free to make suggestions, bug reports, and pull request for features or fixes!

This package was inspired and based off of rbarton65/espnff.

Installing

With Git:

git clone https://github.com/cwendt94/espn-api
cd espn-api
python3 setup.py install

With pip:

pip install espn_api

Usage

For Getting Started and API details head over to the Wiki!

# Football API
from espn_api.football import League
# Basketball API
from espn_api.basketball import League
# Hockey API
from espn_api.hockey import League
# Baseball API
from espn_api.baseball import League
# Init
league = League(league_id=222, year=2019)

Run Tests

python3 setup.py nosetests

Discussions (new)

If you have any questions about the package, ESPN API data, or want to talk about a feature please start a discussion!

Issue Reporting

If you find a bug follow the steps below for reporting.

  1. Open a new issue with a brief description of the bug for the title. In the title also add which sport (Football or Basketball)

  2. Run the application in debug mode to view ESPN API request's and response's

    # ... import statement above
    league = League(league_id=1245, year=2019, debug=True)
    

    The application will print all requests and the response from ESPN's API in the console. I would suggest piping the console output to a text file as it will be a lot of data.

  3. Find the last log before the crash and copy it in the issue descrption with the line number of the crash or possible bug.

  4. Submit the new issue!

I will try to comment on the issue as soon as possible with my thoughts and possible fix!

Project details


Release history Release notifications | RSS feed

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

espn_api-0.45.1-py3-none-any.whl (67.7 kB view details)

Uploaded Python 3

File details

Details for the file espn_api-0.45.1-py3-none-any.whl.

File metadata

  • Download URL: espn_api-0.45.1-py3-none-any.whl
  • Upload date:
  • Size: 67.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for espn_api-0.45.1-py3-none-any.whl
Algorithm Hash digest
SHA256 42293d24def0ddac3e194463781e92c7d6b1a4519b63ee9c2eb2314923ce6f03
MD5 187d0cd115d7178bb355500c4825b050
BLAKE2b-256 213859e3790cf8f34f65692705809f2b782e018d3708129ac51e569e583fa785

See more details on using hashes here.

Provenance

The following attestation bundles were made for espn_api-0.45.1-py3-none-any.whl:

Publisher: package-release.yml on cwendt94/espn-api

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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