Rankings API & Widget

Access community-voted Bayesian casino rankings via a free JSON API or embed a live widget on your site.

FreeCORS EnabledNo Auth Required

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 real player votes using a Bayesian rating system that accounts for vote volume and prevents manipulation. 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.

Rankings API

Endpoint

GET https://casinorankr.com/api/public/rankings

Parameters

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

200 OK

{
  "success": true,
  "data": {
    "rankings": [
      {
        "rank": 1,
        "name": "Stake US",
        "slug": "stake-us",
        "bayesianScore": 4.67,
        "rawCommunityRating": 4.67,
        "approvalPercentage": 84,
        "sampleConfidence": "High Confidence",
        "totalVotes": 823,
        "category": "sweepstakes",
        "thumbnail": "/cf-img/3iOpT6vVD_wPuT56Yqn1Nw/0bec5f89-0371-418b-9c72-b5355d891300/public"
      },
      {
        "rank": 2,
        "name": "Zula Casino",
        "slug": "zulacasino",
        "bayesianScore": 4.58,
        "rawCommunityRating": 4.59,
        "approvalPercentage": 79,
        "sampleConfidence": "High Confidence",
        "totalVotes": 593,
        "category": "sweepstakes",
        "thumbnail": "/cf-img/3iOpT6vVD_wPuT56Yqn1Nw/26ab3456-796e-45f2-391e-0e2649ab6c00/public"
      }
    ],
    "meta": {
      "generatedAt": "2026-05-04T05:04:03.287Z",
      "lastVerified": "2026-05-03T22:23:29.569928+00:00",
      "rankingMetric": "bayesian_score",
      "ratingScale": "0-5",
      "priorMean": 4,
      "priorWeight": 10,
      "category": "sweepstakes",
      "rowCount": 2,
      "categoryTotalVotes": 15646,
      "livePublicListings": 125,
      "poweredBy": "CasinoRankr.com",
      "attribution_url": "https://casinorankr.com/data"
    }
  },
  "requestId": "abc-123"
}

Empty Dataset Response

200 OK

{
  "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

HTML

<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.

JavaScript

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:

HTML

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.