REST API

API dokumentáció

Integrálja az mcstat.org élő Minecraft szerver-, lejátszó-, felület- és közösségi adatait saját alkalmazásaiba, robotjaiba és irányítópultaiba.

Alap URL

Minden API-kérés ezzel az alap URL-lel kezdődik

https://mcstat.org/api/v1

Megtekintés Markdownként

Nyers Markdown dokumentáció MI-knek, botoknak és eszközöknek

API kulcsok

Kezelje és figyelje az API-kulcsokat

Létrehozhatja, elforgathatja és megtekintheti az API-kulcsokhoz tartozó elemzéseket az irányítópulton.

Nyissa meg az API Key Dashboard-ot

API játszótér

Tesztelje a végpontokat közvetlenül a böngészőben

Bot-ellenőrzés

Ez a tesztkörnyezet nem igényel API-kulcsot; az visszaélések csökkentéséhez emberi ellenőrzés szükséges.

Végpont

GET

/api/v1/servers

Lekérdezési paraméterek

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

URL kérése

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

Futtasson egy kérést a válasz megtekintéséhez

Hitelesítés

Minden dokumentált nyilvános API-végponthoz API-kulcs szükséges. Küldje el kulcsát az X-API-Key fejlécben.

Kérelem fejléce

Adja hozzá ezt a fejlécet a hitelesítéshez

X-API-Key: mcs_your_key_here

Vagy lekérdezési paraméterként

Vagy adja át lekérdezési paraméterként

?api_key=mcs_your_key_here

Díjkorlátok

A kéréseket API-kulcs hitelesíti. A hiányzó vagy érvénytelen kulcs a HTTP 401-et, a letiltott kulcs a HTTP 403-at, a korlát túllépése pedig a HTTP 429-et adja vissza.

API kulcs nélkül

Nem engedélyezett

API kulccsal

Alapértelmezés szerint 60 kérés percenként, 1000 naponta és 30 000 havonta. A korlát túllépése a HTTP 429-et adja vissza X-RateLimit-* fejlécekkel, amelyek a korlátokat mutatják, és egy Retry-After, amely jelzi, ha az ablak visszaáll. Kérésre kulcsonként magasabb határérték adható.

Díjkorlát fejlécek:A 429-es válasz X-RateLimit-Limit-Minute, X-RateLimit-Limit-Day, X-RateLimit-Remaining-Day, X-RateLimit-Limit-Month, X-RateLimit-Remaining-Month és Retry-After tartalmaz. A sikeres válaszok Cache-Control fejlécet tartalmaznak, így biztonságosan tárolhatja az eredményeket az ügyféloldalon.

Válasz formátum

Minden sikeres válasz JSON egy logikai értékkel és egy objektummal. A hibák ugyanazt a borítékot használják a következővel: : false.

Sikerreakció

JSON

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

Hiba válasz

JSON

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

Hibák

Szabványos HTTP állapotkódok használatosak. Gyakori esetek:

kód	Jelentése
`400`	Hibás kérés – érvénytelen paraméterek
`401`	Jogosulatlan – hiányzó vagy érvénytelen API-kulcs
`403`	Tiltott — API kulcs letiltva
`404`	Nem található – az erőforrás nem létezik
`429`	Túl sok kérés – túllépte a sebességkorlátot
`500`	Belső szerverhiba – próbálja újra később

Szervervégpontok

Böngésszen, szűrjön és ellenőrizze az mcstat.org által nyomon követett Minecraft szervereket.

GET

/api/v1/servers

Szerverek listázása

A nyilvános szerverek oldalszámozott listája gazdag szűrőkkel.

Példa kérés

cURL

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

Lekérdezési paraméterek

Név	Írja be	szükséges	alapértelmezett	Leírás
`page`	`integer`	Nem	`1`	1-től kezdődő oldalszám.
`limit`	`integer`	Nem	`20`	Elemek oldalanként.
`sort`	`string`	Nem	`recent`	Rendezési sorrend.
`search`	`string`	Nem	`—`	Szabad szöveges lekérdezés.
`country`	`string`	Nem	`—`	ISO országnév szűrő.
`version`	`string`	Nem	`—`	Minecraft verzió szűrő.
`tag`	`string`	Nem	`—`	Szűrés címke szerint.
`mode`	`string`	Nem	`—`	Játékmód szűrő.
`minPlayers`	`integer`	Nem	`—`	Minimális jelenlegi játékosok száma.
`maxPlayers`	`integer`	Nem	`—`	Maximális jelenlegi játékosok száma.
`minUptime`	`number`	Nem	`—`	Minimális üzemidő százalék.
`minVotes`	`integer`	Nem	`—`	Minimális összes szavazatszám.
`minRating`	`number`	Nem	`—`	Minimális értékelés (1–5).
`onlineOnly`	`boolean`	Nem	`—`	Csak az online jelentést készítő szervereket tartalmazza.

Példa válasz

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}

Szerver részletei

Teljes szerverprofil: statisztikák előzményei, üzemidő, szavazatdiagram, rangok.

Példa kérés

cURL

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

Lekérdezési paraméterek

Név	Írja be	szükséges	alapértelmezett	Leírás
`slug`	`string`	Igen	`—`	Szerver slug (a /servers listából).
`period`	`string`	Nem	`24h`	Időablak: 24h, 7d, 30d, 90d, all-time.

Példa válasz

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

Szerver szavazók

Legutóbbi szavazók (hitelesített és névtelen) az adott szerverre.

Példa kérés

cURL

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

Lekérdezési paraméterek

Név	Írja be	szükséges	alapértelmezett	Leírás
`slug`	`string`	Igen	`—`	Szerver slug (a /servers listából).
`page`	`integer`	Nem	`1`	1-től kezdődő oldalszám.
`limit`	`integer`	Nem	`7`	Elemek oldalanként.

Példa válasz

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

Szerver értékelések

Lapozható játékosértékelések és -pontszámok egy szerverhez.

Példa kérés

cURL

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

Lekérdezési paraméterek

Név	Írja be	szükséges	alapértelmezett	Leírás
`slug`	`string`	Igen	`—`	Szerver slug (a /servers listából).
`page`	`integer`	Nem	`1`	1-től kezdődő oldalszám.
`limit`	`integer`	Nem	`5`	Elemek oldalanként.

Példa válasz

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

Szerver frissítések

Jóváhagyott hír- és frissítésbejegyzések egy szerverhez.

Példa kérés

cURL

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

Lekérdezési paraméterek

Név	Írja be	szükséges	alapértelmezett	Leírás
`slug`	`string`	Igen	`—`	Szerver slug (a /servers listából).
`page`	`integer`	Nem	`1`	1-től kezdődő oldalszám.
`limit`	`integer`	Nem	`3`	Elemek oldalanként.

Példa válasz

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

Legjobb szerverek

Kezdőlap/widget használatra optimalizált felkapott lista.

Példa kérés

cURL

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

Lekérdezési paraméterek

Név	Írja be	szükséges	alapértelmezett	Leírás
`sort`	`string`	Nem	`votes`	Rendezési sorrend.
`limit`	`integer`	Nem	`10`	Elemek oldalanként.
`country`	`string`	Nem	`—`	ISO országnév szűrő.
`gameMode`	`string`	Nem	`—`	Játékmód szűrő.

Példa válasz

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

Szerver országok

A szerverek összesített száma ország szerint csoportosítva.

Példa kérés

cURL

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

Lekérdezési paraméterek

Nincsenek paraméterek

Példa válasz

JSON

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

GET

/api/v1/servers/versions

Szerver verziók

A szerverek összesített száma Minecraft verzió szerint csoportosítva.

Példa kérés

cURL

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

Lekérdezési paraméterek

Nincsenek paraméterek

Példa válasz

JSON

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

Játékos végpontok

Nézze meg a játékosprofilokat, a munkameneteket, a szinteket és az előzményeket.

GET

/api/v1/players

Játékosok listázása

Lapszámozott nyilvános játékoskönyvtár.

Példa kérés

cURL

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

Lekérdezési paraméterek

Név	Írja be	szükséges	alapértelmezett	Leírás
`page`	`integer`	Nem	`1`	1-től kezdődő oldalszám.
`limit`	`integer`	Nem	`—`	Elemek oldalanként.
`sort`	`string`	Nem	`recent`	Rendezési sorrend.
`search`	`string`	Nem	`—`	Szabad szöveges lekérdezés.

Példa válasz

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}

Játékos részletek

Profil, legutóbbi munkamenetek, lejátszott szerverek, K/D, eredmények.

Példa kérés

cURL

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

Lekérdezési paraméterek

Név	Írja be	szükséges	alapértelmezett	Leírás
`id`	`string`	Igen	`—`	Játékosazonosító, UUID vagy becenév.

Példa válasz

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"
          }
        }
      ]
    }
  }
}

Keresés

Egységes keresés szerverek és játékosok között.

GET

/api/v1/search

Globális keresés

Keressen szervereket és játékosokat egyetlen hívással.

Példa kérés

cURL

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

Lekérdezési paraméterek

Név	Írja be	szükséges	alapértelmezett	Leírás
`q`	`string`	Igen	`—`	Keresési lekérdezés (2–100 karakter).
`type`	`string`	Nem	`all`	Eredmény típusa: all, servers, players.
`limit`	`integer`	Nem	`10`	Elemek oldalanként.

Példa válasz

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

Élő és globális statisztikák

Valós idejű globális tevékenység, régió- és országbontás.

GET

/api/v1/live

Élő statisztika

Globális online összesítések, legjobb szerverek, legutóbbi tevékenységek, régiók és országok bontása.

Példa kérés

cURL

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

Lekérdezési paraméterek

Nincsenek paraméterek

Példa válasz

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

Élő történelem

Az összes online játékos óránkénti csoportjai az elmúlt 7 napban.

Példa kérés

cURL

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

Lekérdezési paraméterek

Nincsenek paraméterek

Példa válasz

JSON

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

Ranglisták

A legjobb játékosok munkamenetek, szerverek vagy szintpontok szerint rangsorolva.

GET

/api/v1/leaderboards

Ranglisták

A kiválasztott mutató, időszak, szint és teljesítményszűrők legjobb játékosai.

Példa kérés

cURL

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

Lekérdezési paraméterek

Név	Írja be	szükséges	alapértelmezett	Leírás
`metric`	`string`	Nem	`best`	Rangsorolási mérőszám: best, sessions, servers.
`period`	`string`	Nem	`all-time`	Időablak: 24h, 7d, 30d, 90d, all-time.
`page`	`integer`	Nem	`1`	1-től kezdődő oldalszám.
`limit`	`integer`	Nem	`20`	Elemek oldalanként.
`tier`	`string`	Nem	`—`	Szintű szűrő.
`achievement`	`string`	Nem	`—`	Eredményszűrő.
`search`	`string`	Nem	`—`	Szabad szöveges lekérdezés.

Példa válasz

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

Skinek és köpenyek

Keressen a közösség által feltöltött skinekben és köpenyekben.

GET

/api/v1/skins

Skinek listázása

Böngésszen a közösségi skin-feltöltések között a rendezés/szűrő segítségével.

Példa kérés

cURL

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

Lekérdezési paraméterek

Név	Írja be	szükséges	alapértelmezett	Leírás
`page`	`integer`	Nem	`1`	1-től kezdődő oldalszám.
`limit`	`integer`	Nem	`24`	Elemek oldalanként.
`sort`	`string`	Nem	`recent`	Rendezési sorrend.
`model`	`string`	Nem	`—`	Bőrmodell: klasszikus vagy vékony.
`search`	`string`	Nem	`—`	Szabad szöveges lekérdezés.
`tag`	`string`	Nem	`—`	Szűrés címke szerint.
`owner`	`string`	Nem	`—`	Tulajdonos felhasználónév szűrő.

Példa válasz

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}

Bőrrészlet

A teljes bőr metaadatai, valamint a néző tetszése/kedvenc állapota.

Példa kérés

cURL

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

Lekérdezési paraméterek

Név	Írja be	szükséges	alapértelmezett	Leírás
`slug`	`string`	Igen	`—`	Szerver slug (a /servers listából).

Példa válasz

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

Sorolja fel a köpenyeket

Böngésszen a közösségi köpenyfeltöltések között a rendezés/szűrő segítségével.

Példa kérés

cURL

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

Lekérdezési paraméterek

Név	Írja be	szükséges	alapértelmezett	Leírás
`page`	`integer`	Nem	`1`	1-től kezdődő oldalszám.
`limit`	`integer`	Nem	`24`	Elemek oldalanként.
`sort`	`string`	Nem	`recent`	Rendezési sorrend.
`search`	`string`	Nem	`—`	Szabad szöveges lekérdezés.
`tag`	`string`	Nem	`—`	Szűrés címke szerint.
`owner`	`string`	Nem	`—`	Tulajdonos felhasználónév szűrő.

Példa válasz

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}

Köpeny részletei

Teljes köpeny-metaadatok, valamint a néző kedvelés/kedvenc állapota.

Példa kérés

cURL

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

Lekérdezési paraméterek

Név	Írja be	szükséges	alapértelmezett	Leírás
`slug`	`string`	Igen	`—`	Szerver slug (a /servers listából).

Példa válasz

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