Back to Learning Center

Public API

Access Capra Rating data programmatically. No authentication required.

No Auth Required

Fully public endpoints. No API keys or tokens needed.

CORS Enabled

Access from any domain. Perfect for client-side apps.

Rate Limited

100 requests per minute per IP address.

▶ Base URL

https://capraindex.com

▶ Endpoints

GET/api/public/rankings

Get top ranked assets by Capra Rating

Parameters

limit(number)default: 25— Max results (1-100)
type(string)default: ALL— ARTIST, ALBUM, or SONG
era(string)default: null— Filter by era name

Example

https://capraindex.com/api/public/rankings?limit=10&type=ARTIST
GET/api/public/assets

List all assets with pagination

Parameters

limit(number)default: 50— Max results (1-100)
offset(number)default: 0— Skip N results
type(string)default: ALL— ARTIST, ALBUM, or SONG
sort(string)default: cr— cr, name, or wins
order(string)default: desc— asc or desc

Example

https://capraindex.com/api/public/assets?limit=20&type=ARTIST&sort=cr
GET/api/public/assets/{id}

Get single asset by ID or slug

Parameters

id(string)required— UUID or URL slug

Example

https://capraindex.com/api/public/assets/kendrick-lamar
GET/api/public/search

Search assets by name

Parameters

q(string)required— Search query (min 2 chars)
limit(number)default: 20— Max results (1-50)
type(string)default: ALL— ARTIST, ALBUM, or SONG

Example

https://capraindex.com/api/public/search?q=drake&limit=5

▶ Response Format

All endpoints return JSON with a consistent structure:

{
  "success": true,
  "data": {
    "id": "d04075e1-d5fd-4803-9bfb-428fffc7205e",
    "name": "Kendrick Lamar",
    "slug": "kendrick-lamar",
    "type": "ARTIST",
    "capraRating": 1869,
    "tier": "Summit Class",
    "rank": 5,
    "wins": 142,
    "losses": 38,
    "winRate": 79,
    "era": ["Trap/SoundCloud Era (2012-Present)"],
    "imageUrl": "https://...",
    "bio": "..."
  },
  "meta": {
    "timestamp": "2026-01-13T06:00:00.000Z",
    "rateLimit": {
      "remaining": 97,
      "reset": "2026-01-13T06:01:00.000Z"
    }
  }
}

▶ Tier Reference

TierCR Range
Pantheon2400+
Summit Class1800-2399
Alpine Class1600-1799
Ascendant1400-1599
Base Camp1200-1399
Sub-TerraBelow 1200

▶ Use Cases

CR Badge Widgets

Embed real-time Capra Rating badges on artist websites or fan pages.

Ranking Displays

Show "Currently ranked #3 on The Capra Index" on external sites.

Data Analysis

Pull ranking data for research, charts, or cultural trend analysis.

Third-Party Apps

Build apps that integrate Capra Rating data into other platforms.

▶ Rate Limiting

The API is rate limited to 100 requests per minute per IP address.

Rate limit info is included in the meta.rateLimit field of every response:

  • remaining — Requests left in current window
  • reset — When the limit resets (ISO timestamp)

If you exceed the limit, you'll receive a 429 status code. Wait until the reset time to continue.

Need higher rate limits or custom integrations? Contact us.