Skip to main content

A library to manage and update NFL data in a relational database.

Project description

Module nfldb provides command line tools and a library for maintaining and querying a relational database of play-by-play NFL data. The data is imported from nflgame, which in turn gets its data from a JSON feed on NFL.com’s live GameCenter pages. This data includes, but is not limited to, game schedules, scores, rosters and play-by-play data for every preseason, regular season and postseason game dating back to 2009.

In theory, both nfldb and nflgame provide access to the same data. The difference is in the execution. In order to search data in nflgame, a large JSON file needs to be read from disk and loaded into Python data structures for each game. Conversely, nfldb’s data is stored in a relational database, which can be searched and retrieved faster than nflgame by a few orders of magnitude. Moreover, the relational organization of data in nfldb allows for a convenient query interface to search NFL play data.

The database can be updated with real time data from active games by running the nfldb-update script included with this module as often as you’re comfortable pinging NFL.com. (N.B. The JSON data itself only updates every 15 seconds, so running nfldb-update faster than that would be wasteful.) Roster updates are done automatically at a minimum interval of 12 hours.

nfldb has comprehensive API documentation and a wiki with examples.

nfldb can be used in conjunction with nflvid to search and watch NFL game footage.

Project details


Download files

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

Source Distribution

nfldb-0.0.2.tar.gz (1.1 MB view details)

Uploaded Source

Built Distribution

nfldb-0.0.2.linux-x86_64.exe (1.1 MB view details)

Uploaded Source

File details

Details for the file nfldb-0.0.2.tar.gz.

File metadata

  • Download URL: nfldb-0.0.2.tar.gz
  • Upload date:
  • Size: 1.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for nfldb-0.0.2.tar.gz
Algorithm Hash digest
SHA256 8a414537bd22852c532e52cf5eb6125cd83c2f381b6b2ecb40de7afd758e60b6
MD5 416ba13d4958c0f299224d57dc4e9a83
BLAKE2b-256 be996efea4d2159e70bf0c8cdfbddc90224bf1c5e0e333dbdba4cebc7d269732

See more details on using hashes here.

File details

Details for the file nfldb-0.0.2.linux-x86_64.exe.

File metadata

File hashes

Hashes for nfldb-0.0.2.linux-x86_64.exe
Algorithm Hash digest
SHA256 84a8d978c26bdf21e6293fc70894eb176d856b8163f0a5d85031219702be16cb
MD5 c4ca4834f48200564f9929ecfce323a2
BLAKE2b-256 39dae82ab068be20aca6c41e7846720d1ebe6fad6214017ceb965b5dd378597d

See more details on using hashes here.

Supported by

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