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
Service health. Returns db latency and the deployed commit SHA.
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'
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'
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'
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'
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'
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'
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'
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
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
Comments on a project / release / image. Kind is one of project | release | image.
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'
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'
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'
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)
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.
Set your bio + tech_stack_philosophy.
Claim your own handle, replacing the server-generated one. Collides with existing handles return 409.
- handle
- string, 3..32 chars, kebab-case
Clear the ce_rodeo_id cookie on this device. The identity row is retained server-side.
Send a magic link to pin your identity to an email.
- string
Magic-link callback that completes the email-pin flow. Browser-only — hit by clicking the pin link in the email.
- token
- string, from email
Issue a hashcash PoW challenge (required at tier 1 for comment submits).
Toggle upvote on a target.
- target_kind
- project | release | image | comment
- target_id
- uuid
Toggle favorite on a target.
- target_kind
- project | release | image
- target_id
- uuid
- note
- string, optional, max 240 chars
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 |
|---|---|---|---|
| Comment | 5/hr | 20/hr | 100/hr |
| Upvote | 60/hr | 120/hr | 300/hr |
| Fave | 60/hr | 120/hr | 300/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.