Public API

Read-only REST. Public access is rate-limited per IP. Authenticated callers (Bearer token, paid API tier) get higher limits and full AI Jury verdicts.

Base URL

https://gotnerfed.com/api/v1

Rate limits (per minute)

• Public: 10/min
• Personal $9: 60/min
• Teams $29: 240/min
• API $99: 1,200/min, 10k events/mo
• Enterprise $499: 6,000/min, unlimited

Rate limit metadata is returned in X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset headers on every response.

Endpoints

GET /api/v1/receipts

List receipts. Optional query params:

• ?vendor=cursor — filter by tool slug
• ?severity=critical — filter by severity
• ?since=2026-01-01 — only receipts on or after this date
• ?limit=50 — max 200, default 50

GET /api/v1/receipts/{id}

Single receipt with full detail (impact estimate, delta, vendor response, full or aggregate jury).

GET /api/v1/vendors

List all watched vendors with current Nerf Index, band, defining stat, recent counts.

GET /api/v1/vendors/{slug}

Full vendor detail: stats + 30/60/90-day forecast + last 10 receipts.

Authentication

Public endpoints work without a key. To upgrade tier limits and unlock raw AI Jury verdicts, paid customers send:

Authorization: Bearer YOUR_API_KEY

API keys ship alongside Better-Auth in v0.2 (waitlist closing on 100). Founding-tier waitlist signup at /pricing.

Examples

# All critical receipts in 2026
curl https://gotnerfed.com/api/v1/receipts?severity=critical&since=2026-01-01

# Cursor's vendor profile + forecast
curl https://gotnerfed.com/api/v1/vendors/cursor

# Vendor leaderboard
curl https://gotnerfed.com/api/v1/vendors

# Single receipt with full jury (paid, Bearer token required)
curl -H "Authorization: Bearer YOUR_KEY" \
  https://gotnerfed.com/api/v1/receipts/cursor-2025-06-credit-rebill

Stability

This is v1. Breaking changes will roll out as v2; v1 stays online for at least 12 months after v2 ships. Subscribe to the RSS feed for changelog notifications about the API itself.