PyPI
Badges for Python packages — version, downloads, license, and Python version.
Display live stats for any package on PyPI.
Available badges
| Badge | Endpoint | Description |
|---|---|---|
| Version | /pypi/{package} | Latest version |
| Downloads | /pypi/dm/{package} | Download counts (day/week/month) |
| License | /pypi/license/{package} | Package license |
| Python Version | /pypi/python/{package} | Required Python version |
Quick examples
Data source
- Version, license, python: pypi.org
- Downloads: pypistats.org
No API key required. Cached 1 hour.
Endpoint details
Use these sections when you need the exact URL shape or a focused example for a specific badge type.
PyPI Downloads
This section covers the pypi/downloads badge endpoint.
Show daily, weekly, or monthly download counts.
Path Parameters
URL formats
| Period | Endpoint |
|---|---|
| Daily | /pypi/dd/{package} |
| Weekly | /pypi/dw/{package} |
| Monthly | /pypi/dm/{package} |
Examples
Copy-paste examples
Secondary — monthly download count from pypistats
Branded — PyPI brand color
PyPI License
This section covers the pypi/license badge endpoint.
Path Parameters
URL format
/pypi/license/{package}.svgExamples
Copy-paste examples
Outline — subtle license badge for package metadata
Ghost — minimal metadata badge for footer rows
Python Version
This section covers the pypi/python badge endpoint.
Path Parameters
URL format
/pypi/python/{package}.svgExamples
Copy-paste examples
Secondary — required Python version
Branded — PyPI brand color
PyPI Version
This section covers the pypi/version badge endpoint.
Show the current published version of a Python package.
Path Parameters
URL formats
/pypi/{package}.svg/pypi/v/{package}.svgExamples
