PyPI
Badges for Python packages — version, downloads, license, and Python version.
Display live stats for any package on PyPI.
Version (branded)
Monthly downloads
License (outline)
Python version
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.
GET/pypi/dm/:package.svg
Path Parameters
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/pypi/dm/requests.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/pypi/dm/requests.svg?mode=light"></picture>
URL formats
| Period | Endpoint |
|---|---|
| Daily | /pypi/dd/{package} |
| Weekly | /pypi/dw/{package} |
| Monthly | /pypi/dm/{package} |
Examples
Monthly (default)
Monthly (secondary)
Weekly (outline)
Monthly (branded)
Copy-paste examples
Secondary — monthly download count from pypistats
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/pypi/dm/requests.svg?variant=secondary&mode=dark"><img alt="pypi downloads" src="https://shieldcn.dev/pypi/dm/requests.svg?variant=secondary&mode=light"></picture>Branded — PyPI brand color
PyPI License
This section covers the pypi/license badge endpoint.
GET/pypi/license/:package.svg
Path Parameters
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/pypi/license/flask.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/pypi/license/flask.svg?mode=light"></picture>
URL format
/pypi/license/{package}.svgExamples
Default variant
Secondary variant
Outline variant
Ghost variant
Copy-paste examples
Outline — subtle license badge for package metadata
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/pypi/license/flask.svg?variant=outline&mode=dark"><img alt="pypi license" src="https://shieldcn.dev/pypi/license/flask.svg?variant=outline&mode=light"></picture>Ghost — minimal metadata badge for footer rows
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/pypi/license/flask.svg?variant=ghost&mode=dark"><img alt="pypi license" src="https://shieldcn.dev/pypi/license/flask.svg?variant=ghost&mode=light"></picture>Python Version
This section covers the pypi/python badge endpoint.
GET/pypi/python/:package.svg
Path Parameters
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/pypi/python/django.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/pypi/python/django.svg?mode=light"></picture>
URL format
/pypi/python/{package}.svgExamples
Default variant
Secondary variant
Outline variant
Branded variant
Copy-paste examples
Secondary — required Python version
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/pypi/python/django.svg?variant=secondary&mode=dark"><img alt="python version" src="https://shieldcn.dev/pypi/python/django.svg?variant=secondary&mode=light"></picture>Branded — PyPI brand color
PyPI Version
This section covers the pypi/version badge endpoint.
Show the current published version of a Python package.
GET/pypi/:package.svg
Path Parameters
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/pypi/requests.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/pypi/requests.svg?mode=light"></picture>
URL formats
/pypi/{package}.svg/pypi/v/{package}.svgExamples
Default variant
Branded (PyPI blue)
Secondary variant
Outline variant