REST API

API dokumentation

Integrera live Minecraft-server-, spelare-, hud- och communitydata från mcstat.org i dina egna appar, bots och instrumentpaneler.

Bas-URL

Alla API-förfrågningar börjar med denna bas-URL

https://mcstat.org/api/v1

Visa som Markdown

Rå Markdown-dokumentation för AI:er, botar och verktyg

API-nycklar

Hantera och övervaka dina API-nycklar

Skapa, rotera och visa analyser för dina API-nycklar i instrumentpanelen.

Öppna API Key Dashboard

API-lekplats

Testa slutpunkter direkt i webbläsaren

Bot-kontroll

Den här sandlådan kräver ingen API-nyckel; mänsklig verifiering krävs för att minska missbruk.

Slutpunkt

GET

/api/v1/servers

Fråga parametrar

page

integer

limit

integer

sort

string

search

string

country

string

version

string

tag

string

mode

string

minPlayers

integer

maxPlayers

integer

minUptime

number

minVotes

integer

minRating

number

onlineOnly

boolean

Begär URL

https://mcstat.org/api/v1/servers

Kör en begäran för att se svaret

Autentisering

Alla dokumenterade offentliga API-slutpunkter kräver en API-nyckel. Skicka din nyckel i X-API-Key-huvudet.

Rubrik för begäran

Lägg till denna rubrik för att autentisera

X-API-Key: mcs_your_key_here

Eller som frågeparameter

Eller skicka som frågeparameter

?api_key=mcs_your_key_here

Prisgränser

Förfrågningar autentiseras med API-nyckel. En saknad eller ogiltig nyckel returnerar HTTP 401, en inaktiverad nyckel returnerar HTTP 403 och en överskriden gräns returnerar HTTP 429.

Utan API-nyckel

Inte tillåtet

Med API-nyckel

60 förfrågningar per minut, 1 000 per dag och 30 000 per månad som standard. Om du överskrider en gräns returneras HTTP 429 med X-RateLimit-*-rubriker som visar dina gränser och ett försök igen efter att fönstret återställs. Högre gränser kan beviljas per nyckel på begäran.

Rate Limit Headers:Ett 429-svar har X-RateLimit-Minute, X-RateLimit-Limit-Day, X-RateLimit-Remaining-Day, X-RateLimit-Limit-Month, X-RateLimit-Remainth-Month och Retry-After. Framgångsrika svar har en Cache-Control-rubrik så att du säkert kan cacheresultat på klientsidan.

Svarsformat

Varje framgångsrikt svar är JSON med ett booleskt och ett -objekt. Fel använder samma kuvert med : false.

Framgångssvar

JSON

{
  "success": true,
  "data": {
    "resource": {
      "id": "...",
      "name": "Example"
    }
  }
}

Felsvar

JSON

{
  "success": false,
  "error": "Too many requests"
}

Fel

Standard HTTP-statuskoder används. Vanliga fall:

Kod	Mening
`400`	Felaktig begäran — ogiltiga parametrar
`401`	Obehörig — saknas eller ogiltig API-nyckel
`403`	Förbjudet – API-nyckel inaktiverad
`404`	Hittade inte – resursen finns inte
`429`	För många förfrågningar – hastighetsgränsen har överskridits
`500`	Internt serverfel – försök igen senare

Serverslutpunkter

Bläddra, filtrera och inspektera Minecraft-servrar som spåras av mcstat.org.

GET

/api/v1/servers

Lista servrar

Paginerad lista över offentliga servrar med rika filter.

Exempelbegäran

cURL

curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/servers"

Fråga parametrar

Namn	Typ	krävs	standard	Beskrivning
`page`	`integer`	Nej	`1`	Sidnummer, från 1.
`limit`	`integer`	Nej	`20`	Objekt per sida.
`sort`	`string`	Nej	`recent`	Sorteringsordning.
`search`	`string`	Nej	`—`	Fritextfråga.
`country`	`string`	Nej	`—`	ISO-landsnamnsfilter.
`version`	`string`	Nej	`—`	Filter för Minecraft-version.
`tag`	`string`	Nej	`—`	Filtrera efter tagg.
`mode`	`string`	Nej	`—`	Spellägesfilter.
`minPlayers`	`integer`	Nej	`—`	Minsta antal spelare för närvarande.
`maxPlayers`	`integer`	Nej	`—`	Maximalt antal spelare för närvarande.
`minUptime`	`number`	Nej	`—`	Minsta drifttidsprocent.
`minVotes`	`integer`	Nej	`—`	Minsta totala röstantalet.
`minRating`	`number`	Nej	`—`	Minsta betyg (1–5).
`onlineOnly`	`boolean`	Nej	`—`	Inkludera endast servrar som rapporterar online.

Exempel svar

JSON

{
  "success": true,
  "data": {
    "servers": [
      {
        "id": "JS6o0w88QP6oZHDj",
        "slug": "mchypixelnet",
        "name": "Hypixel Network",
        "shortDescription": "Home of over 35 unique games…",
        "ip": "mc.hypixel.net",
        "port": 25565,
        "iconUrl": "https://mcstat.org/images/server-icon/mchypixelnet.webp",
        "bannerUrl": "https://mcstat.org/media/banners/mchypixelnet.webp",
        "motdImageUrl": "https://mcstat.org/images/server-motd/mchypixelnet.svg",
        "motd": "Hypixel Network",
        "website": null,
        "discordUrl": null,
        "visibility": "PUBLIC",
        "isOnline": true,
        "currentPlayers": 48230,
        "maxPlayers": 200000,
        "version": "Requires MC 1.8 / 1.21",
        "latency": 42,
        "lastPing": "2026-05-24T22:00:00Z",
        "country": "United States",
        "tags": [
          "bedwars",
          "pvp",
          "skyblock"
        ],
        "gameMode": null,
        "uptime": 100,
        "trend": 3.4,
        "totalVotes": 12345,
        "rating": 4.6,
        "createdAt": "2026-04-28T05:44:26Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 24,
      "total": 1240,
      "totalPages": 52
    }
  }
}

GET

/api/v1/servers/{slug}

Serverdetalj

Fullständig serverprofil: statistikhistorik, drifttid, röstdiagram, rangordning.

Exempelbegäran

cURL

curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/servers/hypixel-net"

Fråga parametrar

Namn	Typ	krävs	standard	Beskrivning
`slug`	`string`	Ja	`—`	Serverslug (från /servers lista).
`period`	`string`	Nej	`24h`	Tidsfönster: 24h, 7d, 30d, 90d, all-time.

Exempel svar

JSON

{
  "success": true,
  "data": {
    "server": {
      "id": "JS6o0w88QP6oZHDj",
      "slug": "mchypixelnet",
      "name": "Hypixel Network",
      "ip": "mc.hypixel.net",
      "port": 25565,
      "iconUrl": "https://mcstat.org/images/server-icon/mchypixelnet.webp",
      "bannerUrl": "https://mcstat.org/media/banners/mchypixelnet.webp",
      "motd": "Hypixel Network",
      "motdRaw": "§aHypixel §7Network",
      "motdImageUrl": "https://mcstat.org/images/server-motd/mchypixelnet.svg",
      "website": null,
      "discordUrl": null,
      "storeUrl": null,
      "youtubeUrl": null,
      "currentPlayers": 48230,
      "maxPlayers": 200000,
      "isOnline": true,
      "country": "United States",
      "version": "Requires MC 1.8 / 1.21",
      "protocol": 767,
      "uptime": 100,
      "rating": 4.6,
      "totalVotes": 12345,
      "tags": [
        "bedwars",
        "pvp"
      ],
      "owner": null,
      "latestStats": {
        "onlinePlayers": 48230,
        "tps": 20,
        "timestamp": "2026-05-24T22:00:00Z"
      },
      "statsHistory": [
        {
          "timestamp": "2026-05-24T21:00:00Z",
          "onlinePlayers": 47000
        }
      ],
      "periodStats": {
        "24h": {
          "avgPlayers": 46500,
          "peakPlayers": 49100,
          "minPlayers": 42000,
          "uptimePct": 99.95
        }
      },
      "voteStats": {
        "24h": 412,
        "7d": 2890,
        "30d": 11200,
        "90d": 30150
      },
      "dailyVotes": [
        {
          "day": "2026-05-23",
          "votes": 405
        }
      ]
    }
  }
}

GET

/api/v1/servers/{slug}/voters

Serverväljare

Senaste väljare (autentiserade och anonyma) för den givna servern.

Exempelbegäran

cURL

curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/servers/hypixel-net/voters"

Fråga parametrar

Namn	Typ	krävs	standard	Beskrivning
`slug`	`string`	Ja	`—`	Serverslug (från /servers lista).
`page`	`integer`	Nej	`1`	Sidnummer, från 1.
`limit`	`integer`	Nej	`7`	Objekt per sida.

Exempel svar

JSON

{
  "success": true,
  "data": {
    "voters": [
      {
        "id": "TanfrbogDfzGdrgD",
        "minecraftUsername": "Notch",
        "votedAt": "2026-05-24 22:10:06.544",
        "type": "auth",
        "playerId": "xq5-Lw8xk7pEdKyn",
        "minecraftUuid": "069a79f4-3e42-4b0c-8f1a-9c2b1d5e6f70",
        "skinUrl": "http://textures.minecraft.net/texture/cbea0a15a5ce…",
        "linkedSkinPngPath": "https://mcstat.org/media/skins/published/player-skin-notch.png",
        "skinModel": "classic",
        "siteUsername": "notch"
      }
    ],
    "total": 12345,
    "page": 1,
    "totalPages": 515,
    "latestVoteAt": "2026-05-24 22:10:06.544"
  }
}

GET

/api/v1/servers/{slug}/reviews

Serverrecensioner

Paginerade spelarrecensioner och betyg för en server.

Exempelbegäran

cURL

curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/servers/hypixel-net/reviews"

Fråga parametrar

Namn	Typ	krävs	standard	Beskrivning
`slug`	`string`	Ja	`—`	Serverslug (från /servers lista).
`page`	`integer`	Nej	`1`	Sidnummer, från 1.
`limit`	`integer`	Nej	`5`	Objekt per sida.

Exempel svar

JSON

{
  "success": true,
  "data": {
    "reviews": [
      {
        "id": "5g4VgYUiN4n28qcX",
        "serverId": "JS6o0w88QP6oZHDj",
        "userId": null,
        "minecraftUsername": "chibibara",
        "rating": 3,
        "content": "Great community!",
        "createdAt": "2026-05-24T22:00:00Z",
        "updatedAt": "2026-05-24T22:00:00Z",
        "user": {
          "id": null,
          "username": "chibibara",
          "avatar": null,
          "role": "USER"
        },
        "playerId": "suTEw8opOK2bGP-L",
        "playerMainNickname": "chibibara",
        "playerMinecraftUuid": "019f1b29-fcbe-705b-8efb-8c08b4e0fd9c",
        "playerSkinUrl": null,
        "playerSkinModel": "classic",
        "playerLinkedSkinPngPath": "https://mcstat.org/media/skins/published/default-steve.png"
      }
    ],
    "total": 128,
    "page": 1,
    "totalPages": 26,
    "avgRating": 4.2,
    "latestReviewAt": "2026-05-24T22:00:00Z"
  }
}

GET

/api/v1/servers/{slug}/updates

Serveruppdateringar

Godkända nyhets- och uppdateringsinlägg för en server.

Exempelbegäran

cURL

curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/servers/hypixel-net/updates"

Fråga parametrar

Namn	Typ	krävs	standard	Beskrivning
`slug`	`string`	Ja	`—`	Serverslug (från /servers lista).
`page`	`integer`	Nej	`1`	Sidnummer, från 1.
`limit`	`integer`	Nej	`3`	Objekt per sida.

Exempel svar

JSON

{
  "success": true,
  "data": {
    "updates": [
      {
        "id": "Xk3pQ2mNbV8zR1sd",
        "serverId": "JS6o0w88QP6oZHDj",
        "userId": "Nf3kPq8sT2wVxJ7b",
        "title": "Season 5 is live!",
        "content": "New map, new kits, double XP weekend.",
        "status": "APPROVED",
        "createdAt": "2026-05-24T22:00:00Z",
        "updatedAt": "2026-05-24T22:00:00Z"
      }
    ],
    "total": 12,
    "page": 1,
    "totalPages": 4,
    "latestUpdateAt": "2026-05-24T22:00:00Z"
  }
}

GET

/api/v1/servers/top

Toppservrar

Trendlista optimerad för användning av hemsida/widget.

Exempelbegäran

cURL

curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/servers/top"

Fråga parametrar

Namn	Typ	krävs	standard	Beskrivning
`sort`	`string`	Nej	`votes`	Sorteringsordning.
`limit`	`integer`	Nej	`10`	Objekt per sida.
`country`	`string`	Nej	`—`	ISO-landsnamnsfilter.
`gameMode`	`string`	Nej	`—`	Spellägesfilter.

Exempel svar

JSON

{
  "success": true,
  "data": {
    "servers": [
      {
        "id": "JS6o0w88QP6oZHDj",
        "slug": "mchypixelnet",
        "name": "Hypixel Network",
        "ip": "mc.hypixel.net",
        "iconUrl": "https://mcstat.org/images/server-icon/mchypixelnet.webp",
        "bannerUrl": "https://mcstat.org/media/banners/mchypixelnet.webp",
        "motdImageUrl": "https://mcstat.org/images/server-motd/mchypixelnet.svg",
        "currentPlayers": 48230,
        "maxPlayers": 200000,
        "isOnline": true,
        "country": "United States",
        "totalVotes": 12345,
        "uptime": 100,
        "trend": 3.4,
        "recentVotes": 412,
        "hotScore": 9821
      }
    ],
    "total": 1240,
    "sort": "hot"
  }
}

GET

/api/v1/servers/countries

Serverländer

Sammanlagt antal servrar grupperade efter land.

Exempelbegäran

cURL

curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/servers/countries"

Fråga parametrar

Inga parametrar

Exempel svar

JSON

{
  "success": true,
  "data": {
    "countries": [
      {
        "country": "United States",
        "serverCount": 2840
      }
    ]
  }
}

GET

/api/v1/servers/versions

Serverversioner

Sammanlagt antal servrar grupperade efter Minecraft-version.

Exempelbegäran

cURL

curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/servers/versions"

Fråga parametrar

Inga parametrar

Exempel svar

JSON

{
  "success": true,
  "data": {
    "versions": [
      {
        "version": "Paper 1.21.11",
        "serverCount": 980
      }
    ]
  }
}

Spelarens slutpunkter

Slå upp spelarprofiler, sessioner, nivåer och historik.

GET

/api/v1/players

Lista spelare

Paginerad offentlig spelarkatalog.

Exempelbegäran

cURL

curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/players"

Fråga parametrar

Namn	Typ	krävs	standard	Beskrivning
`page`	`integer`	Nej	`1`	Sidnummer, från 1.
`limit`	`integer`	Nej	`—`	Objekt per sida.
`sort`	`string`	Nej	`recent`	Sorteringsordning.
`search`	`string`	Nej	`—`	Fritextfråga.

Exempel svar

JSON

{
  "success": true,
  "data": {
    "players": [
      {
        "id": "h6tC6lGfBEDulI8o",
        "minecraftUuid": "069a79f4-3e42-4b0c-8f1a-9c2b1d5e6f70",
        "mainNickname": "Notch",
        "skinUrl": "http://textures.minecraft.net/texture/98d4f27b450d…",
        "linkedSkinPngPath": "https://mcstat.org/media/skins/published/player-skin-notch.png",
        "skinModel": "classic",
        "country": "United States",
        "tierOverall": "HT1",
        "tierPoints": 9820,
        "tierRank": 12,
        "lastTierSyncAt": "2026-05-24T20:00:00Z",
        "createdAt": "2026-04-01T10:00:00Z",
        "totalPlayTime": 184320,
        "sessionCount": 412
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 24,
      "total": 1240,
      "totalPages": 52
    }
  }
}

GET

/api/v1/players/{id}

Spelardetalj

Profil, senaste sessioner, spelade servrar, K/D, prestationer.

Exempelbegäran

cURL

curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/players/069a79f4-44e9-4726-a5be-fca90e38aaf5"

Fråga parametrar

Namn	Typ	krävs	standard	Beskrivning
`id`	`string`	Ja	`—`	Spelar-id, UUID eller smeknamn.

Exempel svar

JSON

{
  "success": true,
  "data": {
    "player": {
      "id": "h6tC6lGfBEDulI8o",
      "minecraftUuid": "069a79f4-3e42-4b0c-8f1a-9c2b1d5e6f70",
      "mainNickname": "Notch",
      "nicknameHistory": [
        "Notch"
      ],
      "country": null,
      "skinModel": "classic",
      "skinUrl": "http://textures.minecraft.net/texture/98d4f27b450d…",
      "linkedSkinId": "Wi_n1dUvFqgJs0aP",
      "linkedSkinPngPath": "https://mcstat.org/media/skins/published/player-skin-notch.png",
      "linkedSkin": {
        "id": "Wi_n1dUvFqgJs0aP",
        "slug": "player-skin-notch",
        "pngPath": "https://mcstat.org/media/skins/published/player-skin-notch.png",
        "model": "classic",
        "name": "Notch's Skin"
      },
      "tierOverall": "MCStat Mythic",
      "tierPoints": 9820,
      "tierRank": 12,
      "createdAt": "2026-04-01T10:00:00Z",
      "updatedAt": "2026-05-24T22:00:00Z",
      "totalPlayTime": 184320,
      "sessionCount": 412,
      "rankScore": 9820,
      "rank": 12,
      "recentSessions": [
        {
          "id": "oWZiF6jq_UnEs7Y3",
          "server": {
            "id": "JS6o0w88QP6oZHDj",
            "slug": "mchypixelnet",
            "name": "Hypixel Network",
            "iconUrl": "https://mcstat.org/images/server-icon/mchypixelnet.webp"
          },
          "joinedAt": "2026-05-24T20:00:00Z",
          "leftAt": "2026-05-24T21:00:00Z",
          "totalPlayTime": 3600
        }
      ],
      "serversPlayed": [
        {
          "id": "JS6o0w88QP6oZHDj",
          "slug": "mchypixelnet",
          "name": "Hypixel Network",
          "iconUrl": "https://mcstat.org/images/server-icon/mchypixelnet.webp"
        }
      ],
      "latestStats": {
        "statsJson": {
          "kills": 18230,
          "deaths": 9850,
          "wins": 1240
        },
        "timestamp": "2026-05-24T21:00:00Z",
        "server": {
          "slug": "mchypixelnet",
          "name": "Hypixel Network"
        }
      },
      "statsHistory": [
        {
          "statsJson": {
            "kills": 18000,
            "deaths": 9700
          },
          "timestamp": "2026-05-24T20:00:00Z",
          "serverName": "Hypixel Network"
        }
      ],
      "kdRatio": 1.85,
      "totalKills": 18230,
      "totalDeaths": 9850,
      "totalWins": 1240,
      "activityData": [
        {
          "date": "2026-05-24",
          "count": 3
        }
      ],
      "achievements": {
        "earned": [
          {
            "id": "top10",
            "label": "Top 10",
            "labelTr": "İlk 10",
            "labelRu": "Топ 10",
            "icon": "medal"
          }
        ],
        "nextGoals": [
          {
            "id": "explorer_25",
            "label": "Globe Trotter",
            "labelTr": "Dünya Gezgini",
            "labelRu": "Путешественник",
            "icon": "plane"
          }
        ]
      },
      "votedServers": [
        {
          "serverId": "JS6o0w88QP6oZHDj",
          "serverSlug": "mchypixelnet",
          "serverName": "Hypixel Network",
          "serverIconUrl": "https://mcstat.org/images/server-icon/mchypixelnet.webp",
          "votedAt": "2026-05-24T22:10:00Z"
        }
      ],
      "reviews": [
        {
          "id": "Rv8xKp2mNq7wTz1a",
          "rating": 5,
          "content": "Great server!",
          "createdAt": "2026-05-20T10:00:00Z",
          "server": {
            "id": "JS6o0w88QP6oZHDj",
            "slug": "mchypixelnet",
            "name": "Hypixel Network",
            "iconUrl": "https://mcstat.org/images/server-icon/mchypixelnet.webp"
          }
        }
      ]
    }
  }
}

Sök

Enhetlig sökning över servrar och spelare.

GET

/api/v1/search

Global sökning

Sök servrar och spelare i ett anrop.

Exempelbegäran

cURL

curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/search"

Fråga parametrar

Namn	Typ	krävs	standard	Beskrivning
`q`	`string`	Ja	`—`	Sökfråga (2–100 tecken).
`type`	`string`	Nej	`all`	Resultattyp: all, servers, players.
`limit`	`integer`	Nej	`10`	Objekt per sida.

Exempel svar

JSON

{
  "success": true,
  "data": {
    "results": {
      "servers": [
        {
          "id": "JS6o0w88QP6oZHDj",
          "slug": "mchypixelnet",
          "name": "Hypixel Network",
          "iconUrl": "https://mcstat.org/images/server-icon/mchypixelnet.webp",
          "bannerUrl": "https://mcstat.org/media/banners/mchypixelnet.webp",
          "currentPlayers": 48230,
          "maxPlayers": 200000,
          "isOnline": true,
          "rating": 3.4
        }
      ],
      "players": [
        {
          "id": "h6JDPuUGKI3Mfw3m",
          "minecraftUuid": "de5f2979-1168-43d6-b5f3-e18f975a806b",
          "mainNickname": "Notch",
          "createdAt": "2026-04-01T10:00:00Z",
          "updatedAt": "2026-05-24T22:00:00Z"
        }
      ]
    },
    "query": "hypixel"
  }
}

Live och global statistik

Uppdelningar av global aktivitet, region och land i realtid.

GET

/api/v1/live

Livestatistik

Globala onlinesummor, toppservrar, senaste aktivitet, region- och landuppdelning.

Exempelbegäran

cURL

curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/live"

Fråga parametrar

Inga parametrar

Exempel svar

JSON

{
  "success": true,
  "data": {
    "stats": {
      "totalPlayers": 184320,
      "totalServers": 12480,
      "onlineServers": 9821,
      "newPlayersToday": 412,
      "peakToday": 202700,
      "generatedAt": "2026-05-24T22:00:00Z",
      "latestPingAt": "2026-05-24T21:59:48Z",
      "statsAgeSeconds": 18,
      "stale": false
    },
    "topServers": [
      {
        "id": "mchypixelnet",
        "name": "Hypixel Network",
        "players": 48230,
        "maxPlayers": 200000,
        "isOnline": true,
        "country": "United States",
        "trend": "up",
        "change": 240
      }
    ],
    "recentActivity": [
      {
        "type": "vote",
        "actor": "Notch",
        "target": "Hypixel Network",
        "time": "2026-05-24T22:00:00Z"
      }
    ],
    "regions": [
      {
        "id": "na",
        "name": "North America",
        "players": 80120,
        "servers": 4120
      }
    ],
    "countryPlayers": {
      "United States": 60120,
      "Germany": 18230
    }
  }
}

GET

/api/v1/live/history

Live historia

Timmar med totalt antal onlinespelare under de senaste 7 dagarna.

Exempelbegäran

cURL

curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/live/history"

Fråga parametrar

Inga parametrar

Exempel svar

JSON

{
  "success": true,
  "data": {
    "history": [
      {
        "timestamp": "2026-05-23T22:00:00Z",
        "totalPlayers": 174200
      }
    ]
  }
}

Topplistor

Toppspelare rankade efter sessioner, servrar eller nivåpoäng.

GET

/api/v1/leaderboards

Topplistor

Toppspelare för det valda måttet, period, nivå och prestationsfilter.

Exempelbegäran

cURL

curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/leaderboards"

Fråga parametrar

Namn	Typ	krävs	standard	Beskrivning
`metric`	`string`	Nej	`best`	Rankningsmått: best, sessions, servers.
`period`	`string`	Nej	`all-time`	Tidsfönster: 24h, 7d, 30d, 90d, all-time.
`page`	`integer`	Nej	`1`	Sidnummer, från 1.
`limit`	`integer`	Nej	`20`	Objekt per sida.
`tier`	`string`	Nej	`—`	Tier-filter.
`achievement`	`string`	Nej	`—`	Prestationsfilter.
`search`	`string`	Nej	`—`	Fritextfråga.

Exempel svar

JSON

{
  "success": true,
  "data": {
    "leaderboard": {
      "metric": "best",
      "period": "all-time",
      "serverId": null,
      "generatedAt": "2026-05-24T22:00:00Z",
      "entries": [
        {
          "rank": 1,
          "player": {
            "id": "Vz2BaB2r6eC9TL_o",
            "mainNickname": "Notch",
            "minecraftUuid": "069a79f4-3e42-4b0c-8f1a-9c2b1d5e6f70",
            "tierOverall": "MCStat Mythic",
            "tierPoints": 224606,
            "tierRank": 1,
            "skinModel": "classic",
            "skinUrl": "http://textures.minecraft.net/texture/d71c3adef2ec…",
            "linkedSkinPngPath": "https://mcstat.org/media/skins/published/player-skin-notch.png"
          },
          "value": 224606,
          "formattedValue": "224,606 score"
        }
      ]
    },
    "pagination": {
      "page": 1,
      "limit": 24,
      "total": 1240,
      "totalPages": 52
    }
  }
}

Skinn & Capes

Sök efter community-uppladdade skinn och capes.

GET

/api/v1/skins

Lista skinn

Bläddra i community skin-uppladdningar med sortering/filter.

Exempelbegäran

cURL

curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/skins"

Fråga parametrar

Namn	Typ	krävs	standard	Beskrivning
`page`	`integer`	Nej	`1`	Sidnummer, från 1.
`limit`	`integer`	Nej	`24`	Objekt per sida.
`sort`	`string`	Nej	`recent`	Sorteringsordning.
`model`	`string`	Nej	`—`	Hudmodell: klassisk eller slimmad.
`search`	`string`	Nej	`—`	Fritextfråga.
`tag`	`string`	Nej	`—`	Filtrera efter tagg.
`owner`	`string`	Nej	`—`	Ägarens användarnamn filter.

Exempel svar

JSON

{
  "success": true,
  "data": {
    "skins": [
      {
        "id": "Wi_n1dUvFqgJs0aP",
        "slug": "cool-knight",
        "name": "Cool Knight",
        "model": "classic",
        "tags": [
          "medieval",
          "armor"
        ],
        "pngPath": "https://mcstat.org/media/skins/published/cool-knight.png",
        "viewCount": 3120,
        "likeCount": 124,
        "favoriteCount": 88,
        "downloadCount": 980,
        "usageCount": 12,
        "isFeatured": false,
        "createdAt": "2026-05-01T10:00:00Z",
        "ownerId": "Nf3kPq8sT2wVxJ7b",
        "owner": {
          "id": "Nf3kPq8sT2wVxJ7b",
          "username": "notch",
          "avatar": "https://mcstat.org/media/avatars/notch.webp"
        }
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 24,
      "total": 1240,
      "totalPages": 52
    }
  }
}

GET

/api/v1/skins/{slug}

Huddetaljer

Fullskalemetadata plus tittarens gilla/favoritstatus.

Exempelbegäran

cURL

curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/skins/hypixel-net"

Fråga parametrar

Namn	Typ	krävs	standard	Beskrivning
`slug`	`string`	Ja	`—`	Serverslug (från /servers lista).

Exempel svar

JSON

{
  "success": true,
  "data": {
    "skin": {
      "id": "Wi_n1dUvFqgJs0aP",
      "slug": "cool-knight",
      "name": "Cool Knight",
      "description": "Custom medieval knight skin",
      "tags": [
        "medieval",
        "armor"
      ],
      "model": "classic",
      "pngPath": "https://mcstat.org/media/skins/published/cool-knight.png",
      "viewCount": 3120,
      "likeCount": 124,
      "favoriteCount": 88,
      "downloadCount": 980,
      "playersUsing": [
        {
          "id": "h6tC6lGfBEDulI8o",
          "mainNickname": "Notch",
          "minecraftUuid": "069a79f4-3e42-4b0c-8f1a-9c2b1d5e6f70",
          "skinUrl": "http://textures.minecraft.net/texture/98d4f27b450d…",
          "skinModel": "classic",
          "tierOverall": "MCStat Mythic",
          "linkedSkinPngPath": "https://mcstat.org/media/skins/published/cool-knight.png"
        }
      ],
      "playersUsingCount": 1,
      "owner": {
        "id": "Nf3kPq8sT2wVxJ7b",
        "username": "notch",
        "avatar": "https://mcstat.org/media/avatars/notch.webp"
      },
      "viewer": {
        "liked": false,
        "favorited": false,
        "isOwner": false
      }
    }
  }
}

GET

/api/v1/capes

Lista uddar

Bläddra i community cape-uppladdningar med sortering/filter.

Exempelbegäran

cURL

curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/capes"

Fråga parametrar

Namn	Typ	krävs	standard	Beskrivning
`page`	`integer`	Nej	`1`	Sidnummer, från 1.
`limit`	`integer`	Nej	`24`	Objekt per sida.
`sort`	`string`	Nej	`recent`	Sorteringsordning.
`search`	`string`	Nej	`—`	Fritextfråga.
`tag`	`string`	Nej	`—`	Filtrera efter tagg.
`owner`	`string`	Nej	`—`	Ägarens användarnamn filter.

Exempel svar

JSON

{
  "success": true,
  "data": {
    "capes": [
      {
        "id": "De-jbTlj_PTnJJ5N",
        "slug": "royal-red",
        "name": "Royal Red",
        "tags": [
          "red",
          "royal"
        ],
        "pngPath": "https://mcstat.org/media/capes/published/royal-red.png",
        "viewCount": 210,
        "likeCount": 18,
        "favoriteCount": 6,
        "downloadCount": 44,
        "isFeatured": false,
        "createdAt": "2026-05-02T10:00:00Z",
        "ownerId": "Nf3kPq8sT2wVxJ7b",
        "owner": {
          "id": "Nf3kPq8sT2wVxJ7b",
          "username": "notch",
          "avatar": "https://mcstat.org/media/avatars/notch.webp"
        }
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 24,
      "total": 1240,
      "totalPages": 52
    }
  }
}

GET

/api/v1/capes/{slug}

Kappdetaljer

Fullständig kapp-metadata plus tittarens gilla-/favoritstatus.

Exempelbegäran

cURL

curl -X GET \
  -H "X-API-Key: mcs_your_key_here" \
  "https://mcstat.org/api/v1/capes/hypixel-net"

Fråga parametrar

Namn	Typ	krävs	standard	Beskrivning
`slug`	`string`	Ja	`—`	Serverslug (från /servers lista).

Exempel svar

JSON

{
  "success": true,
  "data": {
    "cape": {
      "id": "De-jbTlj_PTnJJ5N",
      "slug": "royal-red",
      "name": "Royal Red",
      "description": "Deep red royal cape",
      "tags": [
        "red",
        "royal"
      ],
      "pngPath": "https://mcstat.org/media/capes/published/royal-red.png",
      "viewCount": 210,
      "likeCount": 18,
      "favoriteCount": 6,
      "downloadCount": 44,
      "playersUsing": [
        {
          "id": "h6tC6lGfBEDulI8o",
          "mainNickname": "Notch",
          "minecraftUuid": "069a79f4-3e42-4b0c-8f1a-9c2b1d5e6f70",
          "skinUrl": "http://textures.minecraft.net/texture/98d4f27b450d…",
          "skinModel": "classic",
          "linkedSkinPngPath": "https://mcstat.org/media/skins/published/player-skin-notch.png",
          "tierOverall": "MCStat Mythic"
        }
      ],
      "playersUsingCount": 1,
      "owner": {
        "id": "Nf3kPq8sT2wVxJ7b",
        "username": "notch",
        "avatar": "https://mcstat.org/media/avatars/notch.webp"
      },
      "viewer": {
        "liked": false,
        "favorited": false,
        "isOwner": false
      }
    }
  }
}