---
id: pypistats
version: "1.14.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# pypistats — Python interface to PyPI Stats API https://pypistats.org/api

License: permissive · Maintenance: active · Downloads: 107.4K/mo

## What it is and what it does

pypistats is a Python client for the PyPI Stats API that retrieves aggregate download statistics for packages on PyPI without requiring direct BigQuery access. It works as both a command-line tool and a library, querying data available for the last 180 days and presenting results in multiple formats (JSON, Markdown, HTML, TSV, plain text tables).

The tool supports several query types: recent downloads (last day/week/month), downloads by Python version (major or minor), downloads by system, and overall statistics. It can accept a package name directly or read from a local pyproject.toml or setup.cfg file. Results are formatted with color-coded terminal output by default and can be sorted by download count or date.

Use it for:

- Monitor your own package's download trends over the last 180 days to gauge adoption and usage patterns.
- Compare download statistics across Python versions to understand which versions your users are running.
- Generate download reports in Markdown or HTML for inclusion in documentation, GitHub issues, or release notes.
- Analyze ecosystem trends by querying statistics for multiple packages to identify popular dependencies.
- Automate download metrics collection in CI/CD pipelines to track package health over time.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Queries the PyPI Stats API to retrieve download statistics for Python packages from the last 180 days, available as a command-line tool or Python library.

Yes. The package is actively maintained, has no known vulnerabilities, installs with low friction, and solves a real need for developers who want to track PyPI download statistics without setting up BigQuery. The MIT license is permissive. Install it if you need programmatic or command-line access to PyPI Stats data.

## Install

pip install pypistats
uv add pypistats
poetry add pypistats

## Installing pypistats

Before you install: Low friction installation with six lightweight runtime dependencies. The package is actively maintained with a recent release and steady commit activity, supporting current Python versions (3.10–3.15).

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions—suitable for both commercial and personal projects.

Quickstart:

pip install pypistats

from pypistats.api import overall
stats = overall('pillow')
print(stats)

Requires Python 3.10 or later; queries depend on network access to pypistats.org API.

Verify before relying:

- Whether the package caches API responses or always fetches fresh data from the network.
- Rate limiting or quota constraints imposed by the PyPI Stats API that users should be aware of.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 107.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pypi package download statistics, pypi stats api client, python package download analytics, pypi download trends, package popularity metrics, pypi stats command line, download statistics by python version, pypi-analytics, download-metrics

[View on SkillFed](https://skillfed.io/packages/pypistats) · [View on PyPI](https://pypi.org/project/pypistats/)