Rankings API & Widget
Access community-voted Bayesian casino rankings via a free JSON API or embed a live widget on your site.
Overview
CasinoRankr's public API exposes our community-powered Bayesian rankings for sweepstakes casinos, crypto casinos, mystery boxes, and sportsbook coverage. Ranking rows are 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. Categories without verified ranking rows return an explicit empty-data status instead of placeholder rankings.
Two endpoints are available: a JSON API for developers integrating rankings into their own applications, and an HTML widget you can embed via iframe on any website.
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: 122 live public listings, 16,417 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.)
- 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-boxes | sportsbooks |
| 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",
"bayesianScore": 4.67,
"rawCommunityRating": 4.67,
"approvalPercentage": 84,
"sampleConfidence": "High confidence",
"totalVotes": 828,
"category": "sweepstakes",
"thumbnail": "/cf-img/3iOpT6vVD_wPuT56Yqn1Nw/0bec5f89-0371-418b-9c72-b5355d891300/public"
},
{
"rank": 2,
"name": "Zula Casino",
"slug": "zulacasino",
"bayesianScore": 4.57,
"rawCommunityRating": 4.58,
"approvalPercentage": 79,
"sampleConfidence": "High confidence",
"totalVotes": 595,
"category": "sweepstakes",
"thumbnail": "/cf-img/3iOpT6vVD_wPuT56Yqn1Nw/26ab3456-796e-45f2-391e-0e2649ab6c00/public"
}
],
"meta": {
"generatedAt": "2026-06-19T19:15:37.933Z",
"lastVerified": "2026-06-18T00:13:41.294165+00:00",
"rankingMetric": "bayesian_score",
"ratingScale": "0-5",
"priorMean": 4,
"priorWeight": 10,
"category": "sweepstakes",
"rowCount": 2,
"categoryTotalVotes": 11781,
"livePublicListings": 122,
"poweredBy": "CasinoRankr.com",
"attribution_url": "https://casinorankr.com/data"
}
},
"requestId": "abc-123"
}Empty Dataset Response
{
"success": true,
"data": {
"rankings": [],
"meta": {
"category": "sportsbooks",
"status": "coverage_expanding",
"rowCount": 0,
"categoryTotalVotes": 0,
"rankingMetric": "bayesian_score"
}
},
"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 are cached for 1 hour (Cache-Control: max-age=3600); most consumers only need 1 request per hour
- 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.