Octo

A lightweight API for structured GitHub profile data. Built on Cloudflare Workers.

Base URL: https://octo.aayush.page

Endpoints

GET /contributions/:username

Returns the contribution calendar for a GitHub user.

Parameter	In	Description
y	query	Year (defaults to current, min 2005)

{
  "total": 1024,
  "year": "2025",
  "contributions": [
    { "date": "2025-01-01", "count": 5, "level": 2 }
  ]
}

GET /pinned/:username

Returns the pinned repositories for a GitHub user.

[
  {
    "repo": "octo",
    "url": "https://github.com/aayush/octo",
    "description": "GitHub profile data API",
    "language": "TypeScript",
    "stars": 10,
    "forks": 2
  }
]

Stack

• Hono on Cloudflare Workers
• HTML parsing via node-html-parser
• Edge caching (1h TTL), rate limiting (60 req/min per IP), CORS

Development

pnpm install
pnpm dev

Deployment

pnpm deploy

Type generation

Sync Cloudflare binding types from wrangler.jsonc:

pnpm cf-typegen