REST · Bearer auth

API

Query the validated corpus, run semantic search against the embedding graph, register webhooks for new attestations, and create bounties — all via a single REST endpoint.

View tiers → Endpoints Health check

Base URL

https://api.research-radar.com

Authentication

Bearer token in the Authorization header. Keys are tier-prefixed:

curl https://api.research-radar.com/v1/validations?limit=10 \
  -H "Authorization: Bearer rr_live_scout_..."

Tiers

Tier	Rate	What's included
`free`	30/min	Reproductions, releases, items, lineage, public badges & BibTeX
`scout`	600/min	+ semantic views (hubs, NO-GO revisit, trending), webhook subscriptions
`operator`	6,000/min	+ vector semantic search, combination graph, full corpus queries
`enterprise`	custom	+ private topic radar, SSO, dedicated support

To request a key, email aeyoung.ts@gmail.com. Self-service signup ships in v1.1.

Core endpoints

All routes mounted at /v1.

Reproductions

`GET /validations`	paginated; filter by passed/minScore
`GET /validations/{runId}`	single validation report
`GET /validations/{runId}/badge.svg`	embeddable SVG · public
`GET /validations/{runId}/bibtex`	citation entry · public
`GET /builds/{runId}`	the underlying build

Corpus & lineage

`GET /items`	raw research items, with triage
`GET /items/{id}/lineage`	full pipeline journey for an item
`GET /combinations`	cross-paper synthesis builds
`GET /releases`	published open-source repos

Semantic (scout/operator)

`GET /semantic/hubs`	items with the most semantic connections
`GET /semantic/uncombined`	pending synthesis pairs
`GET /semantic/nogo-revisit`	NO-GO items whose neighborhood has shifted
`GET /semantic/trending`	topics accelerating across sources
`GET /semantic/similar?query=…`	vector search · operator only

On-chain mirror

`GET /attestations/{paperId}`	all attestations for a paper
`GET /attestations/{paperId}/{buildHash}`	specific attestation
`GET /bounties/{paperId}`	USDC bounty for a paper
`POST /bounties`	create bounty (returns unsigned tx)

Webhooks (scout+)

Subscribe to events: validation.passed, validation.failed, combination.created, attestation.published, bounty.released. Payload signed with HMAC-SHA256 in X-RR-Signature.

POST /v1/webhooks
{
  "url": "https://your-app.com/hook",
  "events": ["validation.passed", "attestation.published"]
}

Errors

Code	HTTP	Meaning
`unauthorized`	401	Missing or invalid bearer token
`forbidden`	403	Tier does not include this endpoint
`not_found`	404	Resource does not exist
`rate_limit_exceeded`	429	Per-minute cap exceeded
`invalid_request`	400	Malformed request

SDK status

TypeScript and Python SDKs are in design. The OpenAPI 3.1 spec is available on request. Contact aeyoung.ts@gmail.com.