SCANNING● LIVE DATAUTC 2026-06-29 00:00:00
VENDORS 23RECEIPTS 32CRITICAL 57D 0 NEWv0.9.4-rc1
gotnerfedgotnerfed
gotnerfed◆API · PROGRAMMATIC ACCESS · 10K EVENTS/MO

Public API, full firehose.

Read-only REST over the entire receipts feed, vendor profiles, forecasts, and AI Jury verdicts. Public access is rate-limited per IP. Authenticated callers (Bearer token, paid tier) get higher limits and full Jury rationales.

Base URLhttps://gotnerfed.com/api/v1
Rate limits · per minute · per IP / per key
TierRequests / minEvents / moRetentionJury detail
PUBLICNo authfree
10—30 daysAggregate counts
PERSONALSigned-in$9 / mo
60—1 yearAggregate counts
TEAMSCSV export$29 / mo
240—3 yearsAggregate counts
APIBearer key$99 / mo
1,20010,000ForeverFull verdicts
ENTERPRISECustom$499 / mo
6,000UnlimitedForeverFull verdicts + raw

Every response carries X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers. 429 on overage.

Authentication

Bearer token, paid tiers

Public endpoints work without a key - aggregate jury counts only. To upgrade tier limits and unlock raw AI Jury rationales, include the header:

Authorization: Bearer YOUR_API_KEY

Manage your keys at /account/api-keys (API tier $99/mo and above). Founding-tier signup at /pricing.

Endpoints
GET/api/v1/receiptsTier PUBLIC+

List receipts (paginated). The JSON firehose. Free tier returns aggregate jury counts; API/Enterprise tiers get full per-LLM verdicts.

Query params · all optional
?vendor=cursorFilter by tool slug
?severity=criticalOne of minor · major · critical
?since=2026-01-01ISO date - only receipts on or after
?limit=50Max 200, default 50
?cursor=…Opaque pagination cursor from previous response
# All critical receipts in 2026 curl "https://gotnerfed.com/api/v1/receipts?severity=critical&since=2026-01-01"
GET/api/v1/receipts/{id}Tier PUBLIC+

Single receipt with full detail: impact estimate, before/after delta, vendor response tone, and the AI Jury (full per-LLM rationales on API tier and above).

curl -H "Authorization: Bearer YOUR_KEY" \ https://gotnerfed.com/api/v1/receipts/cursor-2025-06-credit-rebill
GET/api/v1/receipts.csvTier TEAMS+

CSV export of the receipts feed. Teams tier and above only - public + personal tiers receive 403. Retention window follows your tier.

curl -H "Authorization: Bearer YOUR_KEY" \ "https://gotnerfed.com/api/v1/receipts.csv?vendor=cursor"
GET/api/v1/vendorsTier PUBLIC+

All watched vendors with current Nerf Index, band, defining stat, and recent receipt counts (7d / 30d / 90d).

curl https://gotnerfed.com/api/v1/vendors
GET/api/v1/vendors/{slug}Tier PUBLIC+

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

curl https://gotnerfed.com/api/v1/vendors/cursor
GET/api/v1/healthTier PUBLIC

Liveness check. Returns { ok: true, ts } when the scanner cron and database are healthy. Not rate-limited.

Stability · versioning · changelog
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 or watch /changelog for API-level updates - every breaking change ships with at least 30 days of deprecation notice in the response headers.