jal-co/shieldcn23

GitHub Downloads

Display download counts for GitHub release assets — all assets or specific files, across all releases or a specific tag.

Show download counts for release assets with granular control over scope.

GET/github/downloads/:owner/:repo.svg

Path Parameters

required
required
![badge](https://shieldcn.dev/github/downloads/atom/atom.png)
badge preview

URL formats

All assets, all releases

/github/downloads/{owner}/{repo}.svg

Total downloads across every asset in every release.

All assets, latest release

/github/downloads/{owner}/{repo}/latest.svg

Total downloads across all assets in the latest release only.

All assets, specific tag

/github/downloads/{owner}/{repo}/{tag}.svg

Total downloads across all assets for a specific release tag.

Specific asset, all releases

/github/downloads-asset/{owner}/{repo}/{assetName}.svg

Downloads of a single asset file summed across all releases.

Specific asset, latest release

/github/downloads-asset/{owner}/{repo}/{assetName}/latest.svg

Downloads of a single asset in the latest release only.

Specific asset, specific tag

/github/downloads-asset/{owner}/{repo}/{assetName}/{tag}.svg

Downloads of a single asset in a specific release tag.

Examples

downloads
All assets, all releases
downloads latest
All assets, latest release
downloads branded
Branded variant
specific asset
Specific asset

Copy-paste examples

github downloads

Default — total downloads across all releases and assets

![github downloads](https://shieldcn.dev/github/downloads/atom/atom.svg)
github downloads latest

Branded — downloads for the latest release

![github downloads latest](https://shieldcn.dev/github/downloads/atom/atom/latest.svg?variant=branded)
github asset downloads

Specific asset — downloads of atom-amd64.deb across all releases

![github asset downloads](https://shieldcn.dev/github/downloads-asset/atom/atom/atom-amd64.deb.svg)

Legacy endpoint

The older /github/assets-dl/{owner}/{repo} and /github/dt/{owner}/{repo} endpoints still work and return downloads for the latest release (or a specific tag). The new /github/downloads/ endpoints offer more flexibility.

Data source

Uses the GitHub Releases API. Uses the token pool for distributed rate limiting. Cached 1 hour. For "all releases" badges, paginates through up to 50 pages (5,000 releases).