API Docs

BuilderGraph exposes repository, contributor, ecosystem, spotlight, stats, and export endpoints over a read-only JSON API.

Base URL

All public endpoints are rooted at:

https://buildergraph.zach-76b.workers.dev/api/v1

Public Search Endpoints

List ecosystems

curl "https://buildergraph.zach-76b.workers.dev/api/v1/ecosystems?limit=25"

Search repositories

curl "https://buildergraph.zach-76b.workers.dev/api/v1/repos?q=ethereum&limit=25"

Search contributors

curl "https://buildergraph.zach-76b.workers.dev/api/v1/contributors?q=vitalik&limit=25"

Global stats

curl "https://buildergraph.zach-76b.workers.dev/api/v1/stats"

Latest published spotlights

curl "https://buildergraph.zach-76b.workers.dev/api/v1/spotlights?limit=5"

Authenticated Export Endpoints

Export endpoints require an active API key created after a successful checkout.

curl "https://buildergraph.zach-76b.workers.dev/api/v1/exports/repos?ecosystem=ethereum&format=json" \
  -H "X-API-Key: bg_live_..."
curl "https://buildergraph.zach-76b.workers.dev/api/v1/exports/contributors?format=csv" \
  -H "X-API-Key: bg_live_..."