PyPI StatsPyPI Stats
CompareTrendingPricingDashboardGuide
PyPI Stats — Download analytics for Python packages
APIGitHub
Download data sourced from BigQuery (Google). Counts may include CI/CD and mirror traffic.

Guide

Everything you need to know about using PyPI Stats.

Getting Started

Search for any Python package using the search bar. You'll see a detailed dashboard with download trends, version breakdowns, and ecosystem data.

If a package isn't in our database yet, we'll automatically start loading its data from Google BigQuery. This usually takes a few minutes — just refresh the page shortly.

Create an account to save packages to your dashboard, set up alerts, and unlock Pro features like extended history and CSV exports.

Understanding the Dashboard

Each package dashboard includes:

  • Download Trend — Daily download counts over your selected time range. Shows the overall trajectory of package adoption.
  • Version Breakdown — Which versions are being installed. Useful for tracking migration from old to new releases.
  • Python Versions — Distribution of Python versions used by installers. Helps decide which Python versions to support.
  • Operating Systems — Linux, Windows, macOS breakdown. Values shown as “Unknown” mean the download metadata wasn't recorded by the installer.
  • Installers — pip, uv, poetry, and other tools. Shows how people are installing the package.

Health Score

The health score is a 0–100 rating composed of four equally-weighted components (25 points each):

Consistency (0–25)

How stable are daily downloads over 90 days. Low variance scores higher. A package with steady, predictable downloads is a safer dependency.

Popularity (0–25)

Total downloads over 90 days. Scored as: 1M+ = 25, 100K+ = 20, 10K+ = 15, 1K+ = 10, otherwise 5.

Metadata (0–25)

5 points each for having: a summary, author, license, homepage, and latest version. Well-maintained packages tend to have complete metadata.

Growth (0–25)

Week-over-week download change. 10%+ growth = 25, any growth = 20, minor decline = 15, major decline = 5.

Trending

The trending page ranks packages by week-over-week download growth. A package needs at least 1,000 downloads in the past week to qualify — this filters out noise from tiny packages with volatile numbers.

Trending is a great way to discover new libraries gaining traction in the Python ecosystem before they become mainstream.

Comparing Packages

The compare tool lets you view download trends for multiple packages side-by-side on the same chart.

Free accounts can compare up to 2 packages. Pro accounts can compare up to 10 — useful for evaluating alternatives (e.g., Flask vs FastAPI vs Django) or tracking a suite of related packages.

Alerts

Alerts notify you via email when something notable happens with a package you're watching. Three alert types are available:

  • Download Spike — Triggers when week-over-week downloads increase beyond your threshold (default: 20%). Useful for detecting viral adoption or dependency chain effects.
  • Download Drop — Triggers when downloads decrease beyond your threshold. Can signal deprecation, breaking changes, or ecosystem shifts.
  • New Version — Triggers when a new version of the package is published. Stay on top of updates without manually checking PyPI.

Alerts are checked daily. Create them from your dashboard.

Weekly Digest

Pro and Enterprise users can enable a weekly digest email that summarizes how their saved packages performed over the past week. It includes download counts and week-over-week percentage changes for each saved package.

Enable it from your dashboard. Digests are sent every Monday at 9:00 AM UTC.

Exclude CI/CD Toggle

Pro and Enterprise users can toggle “Exclude CI/CD” on package dashboards to filter out downloads from known automated tools and mirrors, including bandersnatch, devpi, Bazel, Nexus, Artifactory, and Homebrew.

Note: most CI/CD pipelines use standard pip or uv to install packages, making them indistinguishable from human installs at the data level. This filter removes what's identifiable, but won't capture all automated traffic.

API

PyPI Stats provides a public REST API for programmatic access to download data, package metadata, and health scores. See the API documentation for endpoints, rate limits, and authentication details.

Frequently Asked Questions