API Documentation | VersTracker

API Documentation JSON API for programmatic access to Homebrew package data

« Back to VersTracker | llms.txt (for AI agents) | Browse Packages

Overview
The VersTracker API provides read-only access to 16239 Homebrew packages. All endpoints return JSON and are rate-limited to 100 requests per hour per IP address.

Base URL: https://verstracker.com/api/v1

List Packages

GET/api/v1/packages

Returns a paginated list of packages with optional filtering.

Parameter	Type	Description
q	string	Search query (min 2 characters)
category	string	Filter by category slug (e.g., `developer-tools`)
tags	string	Filter by tags, comma-separated (e.g., `cli,json`)
type	string	Filter by type: `formula`, `cask`, or `all`
sort	string	Sort by: `stars`, `name`, `updated`, `new`
updated_since	string	ISO date (e.g., `2025-12-01`)
per_page	integer	Results per page (1-100, default 50)
page	integer	Page number

Example:

GET /api/v1/packages?q=docker&category=devops&sort=stars&per_page=10

Get Single Package

GET/api/v1/packages/{token}

Returns full package data including extended description, key features, use cases, alternatives, and version history.

GET /api/v1/packages/sq

Response includes:

Basic info: token, name, description, type, category, tags
Extended content: extended_description, key_features, use_cases
Alternatives with comparison notes
Version history (last 20 versions)
GitHub stats: stars, forks, primary language
Links: homepage, documentation, Twitter, Discord
Install command

List Categories

GET/api/v1/categories

Returns all categories with package counts, sorted by count descending.

{ "data": [ {"name": "developer-tools", "slug": "developer-tools", "count": 44}, {"name": "devops", "slug": "devops", "count": 15}, ... ] }

List Tags

GET/api/v1/tags

Returns all tags with package counts, sorted by frequency.

{ "data": [ {"name": "cli", "count": 34}, {"name": "productivity", "count": 28}, ... ] }

Rate Limiting All API endpoints are rate-limited to 100 requests per hour per IP address. Rate limit information is included in response headers:

X-RateLimit-Limit - Maximum requests per window
X-RateLimit-Remaining - Requests remaining

Response Format List endpoints return paginated responses:

{ "data": [...], "meta": { "current_page": 1, "last_page": 136, "per_page": 50, "total": 6804 }, "links": { "first": "https://verstracker.com/api/v1/packages?page=1", "last": "https://verstracker.com/api/v1/packages?page=136", "prev": null, "next": "https://verstracker.com/api/v1/packages?page=2" } }

For AI Agents See /llms.txt for a plain-text version of this documentation optimized for LLMs and AI agents.