Frequently Asked Questions

What is PyPI Stats?

PyPI Stats is a service that provides download statistics for Python packages from the Python Package Index (PyPI). We collect and process download data to help developers understand package usage patterns.

How accurate is the data?

Our data comes directly from PyPI's download logs, so it represents actual downloads from PyPI's CDN. However, this may not capture all downloads if users are using mirrors or other distribution methods.

How often is the data updated?

We process new data daily from PyPI's BigQuery dataset. Recent statistics (day, week, month) are updated more frequently.

What do the different download categories mean?

  • Overall: Total downloads, with options for including or excluding mirror downloads
  • Python Major: Downloads by Python major version (2.x vs 3.x)
  • Python Minor: Downloads by specific Python versions (2.7, 3.6, 3.7, etc.)
  • System: Downloads by operating system (Windows, Linux, macOS)

Is the API free to use?

Yes, all our API endpoints are free to use. We don't require authentication for basic usage, though we may implement rate limiting to ensure fair usage.

How do I use the API?

Our API provides RESTful endpoints that return JSON data. You can find detailed documentation on our API page.

Why don't I see data for my package?

If your package doesn't appear in our database, it might be because:

  • The package has very few downloads
  • The package is relatively new and hasn't been processed yet
  • There might be an issue with the package name format

Can I contribute to PyPI Stats?

Yes! PyPI Stats is open source. You can contribute by reporting bugs, suggesting features, or submitting pull requests on our GitHub repository.

PyPI Stats - Download statistics for Python packages