API docs

BuilderGraph exposes repository, contributor-activity, ecosystem, spotlight, stats, and export endpoints over a JSON API. Paid access uses subscription API keys. A machine-readable OpenAPI spec is served at /openapi.json.

base url

Public endpoints are rooted at:

https://api.buildergraph.dev/api/v1

public lookup endpoints

Public endpoints are intended for single-entity lookup and exploration. Bulk exports and commercial access require an API key.

GETlist ecosystems

curl "https://api.buildergraph.dev/api/v1/ecosystems?limit=25"

GETsearch repositories

curl "https://api.buildergraph.dev/api/v1/repos?q=ethereum&limit=25"

GETsearch contributor activity

curl "https://api.buildergraph.dev/api/v1/contributors?q=vitalik&limit=25"

GETglobal stats

curl "https://api.buildergraph.dev/api/v1/stats"

GETlatest published spotlights

curl "https://api.buildergraph.dev/api/v1/spotlights?limit=5"

authenticated export endpoints

Export endpoints require an active subscription API key created after checkout.

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

curl "https://api.buildergraph.dev/api/v1/exports/contributors?format=csv" \
  -H "X-API-Key: bg_live_..."

mcp discovery beta

BuilderGraph exposes a JSON-RPC 2.0 MCP endpoint at /api/mcp. Discovery is available as a beta surface over the same data exposed by the REST API. Use a subscription API key for authenticated calls.

# List tools via JSON-RPC
curl -X POST "https://api.buildergraph.dev/api/mcp" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Call a tool with a subscription key
curl -X POST "https://api.buildergraph.dev/api/mcp" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: bg_live_..." \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_repos","arguments":{"q":"solana","limit":10}}}'

spec, health, and key management

The full surface is described by the OpenAPI document at https://api.buildergraph.dev/openapi.json, and service health is reported at /api/health. View, regenerate, or revoke API keys and track monthly usage from your account and dashboard. Metered per-call payments are not an active paid product — authenticated access uses subscription API keys.