Rankings API & Widget
Access source-aware community ranking, watchlist, and coverage data through a free JSON API. Ranked categories are also available as an embeddable widget.
Overview
CasinoRankr's public API exposes our community-powered Bayesian rankings for sweepstakes casinos, crypto casinos, mystery boxes, sportsbooks, and prediction-market coverage. Categories with fewer than five visible listings return a coverage directory. Categories with at least five listings but fewer than 500 current-visible votes, or a median below three votes per operator, return an A–Z watchlist without positions. Only categories above both sample boundaries return ordered rows calculated from rate-limited community votes using a Bayesian rating system that accounts for vote volume and reduces volatility from small samples. Paid placements do not buy ranking position. Source failures are labeled stale or unavailable; unavailable counters are null rather than zero.
Two endpoints are available: a JSON API for developers integrating rankings into their own applications, and an HTML widget for the four casino/sportsbook categories the widget currently supports. Prediction markets remain a noindex coverage surface and return no ordered rows.
Data Scope and Citation
The API and exports use the same canonical public metrics as the Data Hub and LLM reference files. Current snapshot values: 225 live public listings, 16,463 all-time community votes, and 50 tracked US states. Washington, DC is monitored separately where operator terms mention it.
Community votes are rate-limited sentiment signals. One account vote is not necessarily one real-world person, and votes do not prove safety, legality, payout reliability, licensing, or account outcomes.
Public pages and live APIs use the current canonical public-stats model. Data exports and examples should be treated as snapshots and cited with their generatedAt, lastVerified, URL, and access date.
Source: CasinoRankr Data Hub, [dataset or page title], [URL], accessed [date]. Include the metric label, generatedAt or lastVerified value when citing exported data.- OpenAPI: https://casinorankr.com/api/openapi.json (Machine-readable endpoint and response-schema reference.)
- Public rankings widget: https://casinorankr.com/api/public/widget?category=sweepstakes&limit=5&theme=dark (Embeddable HTML widget with visible CasinoRankr source credit.)
- Top 10 chart embed: https://casinorankr.com/api/public/charts/top-10?category=sweepstakes&theme=dark (Embeddable HTML chart for top ranked public operators.)
- Monthly transparency report: https://casinorankr.com/api/public/data/transparency-report?format=json (Forward-only aggregate trust metrics with series inception, period status, as-of timestamp, and explicit unavailable states.)
- Community vote statistics export: https://casinorankr.com/api/public/data/community-votes?format=json (Category-level vote statistics with sample-confidence labels and limitations.)
- State availability export: https://casinorankr.com/api/public/data/states?format=json (Sweepstakes casino availability tracker data with source URLs and cautious status labels.)
- Redemption thresholds export: https://casinorankr.com/api/public/data/redemption-thresholds?format=json (Structured redemption-threshold rows where source fields are available.)
- Review evidence coverage export: https://casinorankr.com/api/public/data/review-evidence-coverage?format=json (Per-listing source counts, fact-check flags, and conservative coverage labels.)
- Public rankings API: https://casinorankr.com/api/public/rankings?category=sweepstakes&limit=10 (Live community-ranked rows with Bayesian score metadata.)
- Rankings export: https://casinorankr.com/api/public/data/rankings?category=sweepstakes&format=json (Downloadable JSON or CSV ranking snapshot with generatedAt and lastVerified fields.)
- Payout speed data export: https://casinorankr.com/api/public/data/payout-speed-index?format=json (Exact payout speed rows with speed tiers, redemption windows, and community signal.)
- Trust data export: https://casinorankr.com/api/public/data/trust-index?format=json (Exact trust rows with trust tiers, red-flag indicators, and community signal.)
- Per-operator research export (JSON): https://casinorankr.com/api/public/data/community-votes/research-2026-06?format=json (Frozen per-operator community vote snapshot. CC-BY-4.0. Directional sentiment only.)
- Per-operator research export (CSV): https://casinorankr.com/api/public/data/community-votes/research-2026-06?format=csv (CSV version of the per-operator research snapshot.)Rankings API
GET https://casinorankr.com/api/public/rankingsParameters
| Param | Type | Description |
|---|---|---|
| category* | string | sweepstakes | crypto | mystery | mystery-boxes | sportsbooks | prediction-markets |
| limit | integer | Number of results (1–25, default 10) |
| state | string | US state code (e.g. CA, NY) - filters out casinos banned in that state |
Example Request
curl "https://casinorankr.com/api/public/rankings?category=sweepstakes&limit=2"Example Response
{
"success": true,
"data": {
"rankings": [
{
"rank": 1,
"name": "Stake US",
"slug": "stake-us",
"approvalPercentage": 84,
"sampleConfidence": "High confidence",
"totalVotes": 829,
"category": "sweepstakes",
"thumbnail": "/cf-img/3iOpT6vVD_wPuT56Yqn1Nw/0bec5f89-0371-418b-9c72-b5355d891300/public",
"bayesianScore": 4.67,
"rawCommunityRating": 4.67
},
{
"rank": 2,
"name": "Zula Casino",
"slug": "zulacasino",
"approvalPercentage": 79,
"sampleConfidence": "High confidence",
"totalVotes": 596,
"category": "sweepstakes",
"thumbnail": "/cf-img/3iOpT6vVD_wPuT56Yqn1Nw/26ab3456-796e-45f2-391e-0e2649ab6c00/public",
"bayesianScore": 4.57,
"rawCommunityRating": 4.58
}
],
"entries": [
{
"rank": 1,
"name": "Stake US",
"slug": "stake-us",
"approvalPercentage": 84,
"sampleConfidence": "High confidence",
"totalVotes": 829,
"category": "sweepstakes",
"thumbnail": "/cf-img/3iOpT6vVD_wPuT56Yqn1Nw/0bec5f89-0371-418b-9c72-b5355d891300/public",
"bayesianScore": 4.67,
"rawCommunityRating": 4.67
},
{
"rank": 2,
"name": "Zula Casino",
"slug": "zulacasino",
"approvalPercentage": 79,
"sampleConfidence": "High confidence",
"totalVotes": 596,
"category": "sweepstakes",
"thumbnail": "/cf-img/3iOpT6vVD_wPuT56Yqn1Nw/26ab3456-796e-45f2-391e-0e2649ab6c00/public",
"bayesianScore": 4.57,
"rawCommunityRating": 4.58
}
],
"meta": {
"generatedAt": "2026-07-20T03:57:05.629Z",
"lastVerified": "2026-07-19T07:23:33.923318+00:00",
"rankingMetric": "bayesian_score",
"ratingScale": "0-5",
"priorMean": 4,
"priorWeight": 10,
"category": "sweepstakes",
"status": "rankings_available",
"presentationMode": "ranking",
"itemListOrder": "ordered",
"dataStatus": "available",
"voteDataStatus": "available",
"rowCount": 2,
"categoryTotalVotes": 12303,
"categoryAllTimeVotes": 12303,
"categoryCurrentVisibleVotes": 12304,
"categoryLiveListings": 97,
"livePublicListings": 225,
"poweredBy": "CasinoRankr.com",
"attribution_url": "https://casinorankr.com/data"
}
},
"requestId": "abc-123"
}categoryTotalVotes remains the backward-compatible all-time vertical total. New consumers should read categoryAllTimeVotes and categoryCurrentVisibleVotes explicitly, along with dataStatus. A legitimate measured zero is returned as 0; an unavailable source is returned as null.
Empty Dataset Response
{
"success": true,
"data": {
"rankings": [],
"meta": {
"category": "sportsbooks",
"status": "coverage_expanding",
"presentationMode": "coverage",
"dataStatus": "unavailable",
"rowCount": 0,
"categoryTotalVotes": null,
"categoryAllTimeVotes": null,
"categoryCurrentVisibleVotes": null,
"rankingMetric": null
}
},
"requestId": "abc-123"
}Embeddable Widget
Drop a live-updating rankings widget onto any page. Supports dark and light themes, category filtering, and US state restriction filtering.
iframe Embed
<iframe
src="https://casinorankr.com/api/public/widget?category=sweepstakes&limit=5&theme=dark"
width="320"
height="440"
style="border:none;border-radius:12px"
title="Top Sweepstakes Casinos: CasinoRankr"
loading="lazy"
></iframe>Widget Parameters
| Param | Type | Description |
|---|---|---|
| category* | string | sweepstakes | crypto | mystery-boxes | sportsbooks |
| limit | integer | Number of casinos (1–10, default 5) |
| theme | string | dark (default) | light |
| state | string | US state code - filters restricted casinos |
JavaScript Snippet
Prefer JS? This snippet creates the iframe dynamically and sizes it to fit content.
<div id="casinorankr-widget"></div>
<script>
(function() {
var d = document, el = d.getElementById("casinorankr-widget");
if (!el) return;
var f = d.createElement("iframe");
f.src = "https://casinorankr.com/api/public/widget?category=sweepstakes&limit=5&theme=dark";
f.width = "320";
f.height = "440";
f.style.border = "none";
f.style.borderRadius = "12px";
f.title = "Top Sweepstakes Casinos: CasinoRankr";
f.loading = "lazy";
el.appendChild(f);
})();
</script>Rate Limits
- 100 requests per hour per IP address (sliding window)
- Exceeding the limit returns HTTP 429 with a Retry-After header
- Responses carrying live public counters use the shared 5-minute cache contract (Cache-Control: max-age=300, s-maxage=300)
- No authentication or API key required
Attribution
Please cite CasinoRankr as the data source so readers can verify where the rankings came from. The widget includes visible source credit inside the iframe. If using the JSON API, place branded source credit near the data:
Rankings data: <a href="https://casinorankr.com/data" rel="nofollow noopener noreferrer">CasinoRankr data</a>Publishers may use rel="nofollow", rel="sponsored", rel="ugc", or another appropriate qualification at their discretion. Attribution is for transparency and source credit, not ranking manipulation. Use branded anchors such as “CasinoRankr” or “CasinoRankr data” rather than keyword-rich commercial anchors.