# GitHub Stars History API

> GitHub Stars History API is a paid API for AI agents from x402-deployer.x402-deployer.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns the current star count and a time-series of cumulative stars vs. date for any public GitHub repository, sampled across up to 10 pages of stargazers.

## Facts

- Endpoint: POST https://x402-deployer.x402-deployer.workers.dev/github-stars-history
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-deployer-x402-deployer-workers-dev-e19be2a9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7cbe1kTb7rPP6tutbJreQ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402-deployer-x402-deployer-workers-dev-e19be2a9 -d '<json body>'
```

Example prompt: Can you pull the GitHub stars history for the repo 'owner=vercel, name=next.js' using 10 sampled pages, so I can see how its popularity has grown over time?

## When to prefer this

Use this endpoint when you need historical star growth data or a popularity timeline for a public GitHub repository, not just the current star count. It is ideal for trend analysis, charting repo growth, or comparing how quickly different projects gained traction. Prefer this over scraping GitHub directly or calling the GitHub API yourself, as it handles pagination and timestamp extraction automatically.

## Known failure modes

- Repository not found or private — returns 404 or empty result
- GitHub unauthenticated rate limit exceeded (60 req/h) — returns 429 or error
- Invalid owner/repo format — returns validation error
- pages parameter out of range (not 1-10) — returns error
- GitHub API unavailable — propagates upstream error

## How this service works

GitHub stars history / star growth chart / repo popularity over time / trending tracker. Current star count plus a sampled cumulative-stars-vs-date series for any public GitHub repo. Walks 1-10 evenly-spaced pages of /stargazers using application/vnd.github.star+json so each sample carries a starred_at timestamp. Free public API, no auth (subject to GitHub's 60 req/h unauthenticated limit).

## Output

Returns the repository's current total star count plus a chronological array of {date, cumulative_stars} data points sampled evenly across up to 10 pages of stargazers, each derived from the starred_at timestamp in the GitHub API response.

## Example request

```json
{
 "input": {
  "body": {
   "repo": "torvalds/linux",
   "pages": 5
  },
  "type": "http",
  "method": "POST",
  "bodyType": "json"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-deployer-x402-deployer-workers-dev-e19be2a9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-deployer.x402-deployer.workers.dev](https://www.zero.xyz/host/x402-deployer.x402-deployer.workers.dev/llms.txt)