API

Every ce.rodeo page gets its data from a public JSON API at https://api.ce.rodeo. No key required for reads. All endpoints are stable within a major version.

Reproduce any score

Read endpoints

GET /healthz

Service health. Returns db latency and the deployed commit SHA.

GET /v1/projects

List CE projects from v_project_index.

limit
int, default 100, max 500
q
string — substring match on slug or display_name
tag
namespace:value — e.g. role:oltp, alt:salesforce
category
string — one of databases, web-proxy, messaging, …
curl 'https://api.ce.rodeo/v1/projects?tag=role:crm&limit=5'
GET /v1/projects/:slug

One project by slug. Fields: id, slug, display_name, description, one_liner, use_case_md, category, is_ce, ce_successor_slug, ce_note (populated for license-flipped and proprietary projects), is_agent_enabling, pulse_grade, pulse_score, best_scout_grade, tag_chips, upvote_count, max_pulls, total_pulls.

curl 'https://api.ce.rodeo/v1/projects/valkey'
GET /v1/projects/:slug/images

All images we track for a project, ordered by pull_count desc. Thin — just id, ref, pull_count, last_pushed_at.

curl 'https://api.ce.rodeo/v1/projects/postgres/images'
GET /v1/projects/:slug/top-images

Top-N images for one project, ranked by current Rodeo score. Includes current grade+score, first-scan grade+score, CVE counts, publisher, size, arch count — the data behind the project page's 'Which image should you pull?' section.

limit
int, default 5, max 20
curl 'https://api.ce.rodeo/v1/projects/nginx/top-images?limit=5'
GET /v1/publishers

Publisher leaderboard. v3 (default since the 2026-11-04 switchover) picks the single newest-pushed image per product and uses its 48h-grace grade, then orders by the Wilson lower bound of per_product_quality (ordering_score). v2 is kept behind ?variant=v2 for comparability — it ranked by per-product quality × breadth. Operator publishers (publisher_flags.is_operator = true) are returned with rank=null and sorted separately. Each row carries: publisher, is_operator, rank, ordering_score, per_product_quality, quality_wilson_lb, breadth_bonus, avg_score, coverage_pct, low_coverage, docker_official, graded_a/ab/b/c/d/f, products_60d, products_registered, products_a/b/c/d/f, projects_served, images_tracked, images_scanned, rebuilt_last_90d, total_pulls.

limit
int, default 25, max 100
variant
string: "v3" (default) or "v2" (legacy)
curl 'https://api.ce.rodeo/v1/publishers?limit=10'
GET /v1/publishers/:name

Full publisher dossier — every image we track for the namespace with current + first-scan grade/score, CVE counts, rubric_breakdown per image, plus the publisher's global rank. Powers the /publishers/:name page. Blocked publishers return HTTP 410 with {error: 'publisher_blocked', reason}.

curl 'https://api.ce.rodeo/v1/publishers/readystack'
GET /v1/scout/watch

Images whose grade dropped vs the prior snapshot inside the window. The 'what should I patch today?' feed. Each event carries image + project + was/now grades + timestamps, plus the top CVE that caused the drop (worst_cve_id + severity + fix version if known, Critical > High) and a suggested patch target (patch_to_ref + namespace + grade — a sibling image on the same project currently grading A or B).

hours
int, default 168, max 720
curl 'https://api.ce.rodeo/v1/scout/watch?hours=24'
GET /v1/images/:id/snapshots

Grade history for an image — up to 180 of the most recent scout_snapshots rows. Each row includes rubric_breakdown (the arithmetic that produced the grade) and the Grype DB vintage. Add ?download=1 to get a Content-Disposition attachment header for one-click save.

curl 'https://api.ce.rodeo/v1/images/<uuid>/snapshots?download=1' > snapshots.json
GET /v1/images/:id/cves

Full Grype matches array for the latest scan of this image: CVE id, severity, CVSS, fix availability, affected package. Add ?download=1 for a downloadable attachment with a filename derived from the image ref.

curl 'https://api.ce.rodeo/v1/images/<uuid>/cves?download=1' > cves.json
GET /v1/comments/:kind/:id

Comments on a project / release / image. Kind is one of project | release | image.

GET /v1/people/:handle

Public profile for one pseudonymous identity. Returns {identity: {handle, tier, joined_at, bio, …}, barn: [favorites], comments: [recent], stats: {upvotes_received, comments_total, …}}.

curl 'https://api.ce.rodeo/v1/people/balmy-ladyslipper'
GET /v1/methodology/changelog

Timeline of every rubric change, policy-table edit, publisher-rank version bump, and other scoring-affecting event. Returns {changelog: [{id, effective_at, title, body}]}.

curl 'https://api.ce.rodeo/v1/methodology/changelog'
GET /v1/index/status

Operational status of the indexing pipeline: migrations applied, last successful run of each scanner service, matview refresh timestamps, and headline row counts. Returns {schema, pipelines, counts, as_of}.

curl 'https://api.ce.rodeo/v1/index/status'
GET /v1/images/:id/sbom

Syft SBOM for the latest scan of this image, in Syft-JSON format. Includes sbom_digest, grype_db_version, and the computed_at timestamp of the snapshot. Add ?download=1 for a downloadable attachment.

curl 'https://api.ce.rodeo/v1/images/<uuid>/sbom'

Write endpoints (require the ce_rodeo_id cookie)

GET /v1/me

Your identity. Returns 404 for a request without the ce_rodeo_id cookie; the cookie is issued by the web flow on first interaction (upvote, fave, comment) and can then be re-read here.

POST /v1/me/profile

Set your bio + tech_stack_philosophy.

POST /v1/me/handle

Claim your own handle, replacing the server-generated one. Collides with existing handles return 409.

handle
string, 3..32 chars, kebab-case
POST /v1/me/signout

Clear the ce_rodeo_id cookie on this device. The identity row is retained server-side.

POST /v1/me/pin/email

Send a magic link to pin your identity to an email.

email
string
GET /v1/me/pin/verify

Magic-link callback that completes the email-pin flow. Browser-only — hit by clicking the pin link in the email.

token
string, from email
POST /v1/pow/challenge

Issue a hashcash PoW challenge (required at tier 1 for comment submits).

POST /v1/upvote

Toggle upvote on a target.

target_kind
project | release | image | comment
target_id
uuid
POST /v1/fave

Toggle favorite on a target.

target_kind
project | release | image
target_id
uuid
note
string, optional, max 240 chars
POST /v1/comment

Post a comment. Tier 1 identities must include a solved PoW.

target_kind
project | release | image
target_id
uuid
body
string, 1..2500 chars
parent_id
uuid, optional
is_review
bool, optional
pow
{challenge_id, nonce} if tier 1

Rate limits

OPERATION TIER 1 TIER 2 TIER 3
Comment5/hr20/hr100/hr
Upvote60/hr120/hr300/hr
Fave60/hr120/hr300/hr

Tier 1 is the fresh-visitor default; tier 2 unlocks on email pin via /v1/me/pin/email; tier 3 is OPERATOR status, promoted after 50+ upvoted comments with zero mod strikes.