Homebrew

Badges for Homebrew formulae and casks — version, installs.

Display live stats for Homebrew formulae and casks.

homebrew
Formula (branded)
homebrew cask
Cask (branded)
homebrew downloads
Downloads (branded)
homebrew
Formula (secondary)
homebrew cask downloads
Cask downloads
homebrew
Formula (outline)

Available badges

BadgeEndpointDescription
Formula Version/homebrew/{formula}Latest stable version
Cask Version/homebrew/cask/{cask}Latest cask version
Installs/homebrew/installs/{formula}[/{days}]Install count (30/90/365 days)
Formula Downloads/homebrew/dm/{formula}Monthly/quarterly/yearly downloads
Cask Downloads/homebrew/cask-dm/{cask}Monthly/quarterly/yearly cask downloads

Quick examples

![version](https://shieldcn.dev/homebrew/node.svg)
![cask](https://shieldcn.dev/homebrew/cask/firefox.svg)
![downloads](https://shieldcn.dev/homebrew/dm/node.svg)
![cask downloads](https://shieldcn.dev/homebrew/cask-dm/firefox.svg)
GET/homebrew/:formula.svg

Path Parameters

required
![badge](https://shieldcn.dev/homebrew/node.png)
badge preview

Data source

Uses Homebrew Formulae API. 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.

Homebrew Downloads

This section covers the homebrew/downloads badge endpoint.

Show install counts for Homebrew formulae and casks over different time periods.

GET/homebrew/dm/:formula.svg

Path Parameters

required
![badge](https://shieldcn.dev/homebrew/dm/node.png)
badge preview

URL formats

Formula downloads

/homebrew/dm/{formula}.svg
/homebrew/dq/{formula}.svg
/homebrew/dy/{formula}.svg

Monthly (dm), quarterly (dq), or yearly (dy) install counts for a formula.

Cask downloads

/homebrew/cask-dm/{cask}.svg
/homebrew/cask-dq/{cask}.svg
/homebrew/cask-dy/{cask}.svg

Monthly (cask-dm), quarterly (cask-dq), or yearly (cask-dy) install counts for a cask.

Examples

formula monthly
Formula monthly (branded)
formula yearly
Formula yearly
cask monthly
Cask monthly (branded)
cask yearly
Cask yearly (outline)

Copy-paste examples

Default — monthly installs for a formula

![homebrew downloads](https://shieldcn.dev/homebrew/dm/node.svg)

Branded — monthly installs for a cask

![homebrew cask downloads](https://shieldcn.dev/homebrew/cask-dm/firefox.svg?variant=branded)

Yearly installs for a formula

![homebrew yearly](https://shieldcn.dev/homebrew/dy/node.svg)

Interval reference

CodePeriodDescription
dmMonthlyLast 30 days
dqQuarterlyLast 90 days
dyYearlyLast 365 days