REST API

API Dokumentasie

Integreer lewendige Minecraft-bediener-, speler-, vel- en gemeenskapdata vanaf mcstat.org in jou eie toepassings, bots en dashboards.

Basis URL

Alle API-versoeke begin met hierdie basis-URL

https://mcstat.org/api/v1

Bekyk as Markdown

Rou Markdown-dokumentasie vir KI's, bots en gereedskap

API-sleutels

Bestuur en monitor jou API-sleutels

Skep, draai en bekyk ontledings vir jou API-sleutels in die kontroleskerm.

Maak API-sleutelkontroleskerm oop

API speelgrond

Toets eindpunte direk in die blaaier

Bot-kontrole

Hierdie speelgrond vereis nie 'n API-sleutel nie; menslike verifikasie is nodig om misbruik te verminder.

Eindpunt

GET

/api/v1/servers

Navraag parameters

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

Versoek URL

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

Voer 'n versoek uit om die antwoord te sien

Stawing

Alle gedokumenteerde publieke API-eindpunte vereis 'n API-sleutel. Stuur jou sleutel in die X-API-sleutel-kopskrif.

Versoek opskrif

Voeg hierdie opskrif by om te staaf

X-API-Key: mcs_your_key_here

Of as navraagparameter

Of slaag as navraagparameter

?api_key=mcs_your_key_here

Tarief limiete

Versoeke word geverifieer deur API-sleutel. 'n Ontbrekende of ongeldige sleutel gee HTTP 401 terug, 'n gedeaktiveerde sleutel gee HTTP 403 terug, en 'n oorskryde limiet gee HTTP 429 terug.

Sonder API-sleutel

Nie toegelaat nie

Met API sleutel

60 versoeke per minuut, 1 000 per dag en 30 000 per maand by verstek. Oorskryding van 'n limiet gee HTTP 429 terug met X-RateLimit-*-opskrifte wat jou limiete wys en 'n Herprobeer-nadat jy vertel wanneer die venster teruggestel word. Hoër limiete kan op versoek per sleutel toegestaan word.

Tarieflimietopskrifte:'n 429-antwoord bevat X-Terieflimiet-Minute, X-Terieflimiet-Beperk-Dag, X-Terieflimiet-Resterende-Dag, X-Terieflimiet-Beperk-Maand, X-Terieflimiet-Resterende-maand en Herprobeer-Na. Suksesvolle antwoorde dra 'n Cache-Control-opskrif sodat u resultate veilig aan die kliëntkant kan kas.

Reaksie formaat

Elke suksesvolle antwoord is JSON met 'n boolean en 'n voorwerp. Foute gebruik dieselfde koevert met : vals.

Sukses reaksie

JSON

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

Foutreaksie

JSON

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

Foute

Standaard HTTP-statuskodes word gebruik. Algemene gevalle:

Kode	Betekenis
`400`	Slegte versoek — ongeldige parameters
`401`	Ongemagtig — ontbrekende of ongeldige API-sleutel
`403`	Verbode – API-sleutel gedeaktiveer
`404`	Nie gevind nie — hulpbron bestaan nie
`429`	Te veel versoeke – tarieflimiet oorskry
`500`	Interne bedienerfout — probeer later weer

Bediener eindpunte

Blaai deur, filter en inspekteer Minecraft-bedieners wat deur mcstat.org nagespoor word.

GET

/api/v1/servers

Lys bedieners

Gepagineerde lys van publieke bedieners met ryk filters.

Voorbeeld versoek

cURL

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

Navraag parameters

Naam	Tik	vereis word	verstek	Beskrywing
`page`	`integer`	Nee	`1`	Bladsynommer, begin by 1.
`limit`	`integer`	Nee	`20`	Items per bladsy.
`sort`	`string`	Nee	`recent`	Sorteer volgorde.
`search`	`string`	Nee	`—`	Vryteks-navraag.
`country`	`string`	Nee	`—`	ISO-landnaamfilter.
`version`	`string`	Nee	`—`	Minecraft weergawe filter.
`tag`	`string`	Nee	`—`	Filter volgens merker.
`mode`	`string`	Nee	`—`	Spelmodus filter.
`minPlayers`	`integer`	Nee	`—`	Minimum huidige spelertelling.
`maxPlayers`	`integer`	Nee	`—`	Maksimum huidige spelertelling.
`minUptime`	`number`	Nee	`—`	Minimum uptyd persentasie.
`minVotes`	`integer`	Nee	`—`	Minimum totale stemmetelling.
`minRating`	`number`	Nee	`—`	Minimum gradering (1–5).
`onlineOnly`	`boolean`	Nee	`—`	Sluit slegs bedieners in wat aanlyn rapporteer.

Voorbeeld reaksie

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}

Bediener detail

Volledige bedienerprofiel: statistiekgeskiedenis, uptyd, stemgrafiek, geledere.

Voorbeeld versoek

cURL

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

Navraag parameters

Naam	Tik	vereis word	verstek	Beskrywing
`slug`	`string`	Ja	`—`	Bedienerslak (van /bedienerslys).
`period`	`string`	Nee	`24h`	Tydvenster: 24h, 7d, 30d, 90d, all-time.

Voorbeeld reaksie

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

Bediener kiesers

Onlangse kiesers (geverifieer en anoniem) vir die gegewe bediener.

Voorbeeld versoek

cURL

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

Navraag parameters

Naam	Tik	vereis word	verstek	Beskrywing
`slug`	`string`	Ja	`—`	Bedienerslak (van /bedienerslys).
`page`	`integer`	Nee	`1`	Bladsynommer, begin by 1.
`limit`	`integer`	Nee	`7`	Items per bladsy.

Voorbeeld reaksie

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

Bediener-resensies

Gepagineerde spelerresensies en graderings vir 'n bediener.

Voorbeeld versoek

cURL

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

Navraag parameters

Naam	Tik	vereis word	verstek	Beskrywing
`slug`	`string`	Ja	`—`	Bedienerslak (van /bedienerslys).
`page`	`integer`	Nee	`1`	Bladsynommer, begin by 1.
`limit`	`integer`	Nee	`5`	Items per bladsy.

Voorbeeld reaksie

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

Bediener-opdaterings

Goedgekeurde nuus- en opdateringsplasings vir 'n bediener.

Voorbeeld versoek

cURL

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

Navraag parameters

Naam	Tik	vereis word	verstek	Beskrywing
`slug`	`string`	Ja	`—`	Bedienerslak (van /bedienerslys).
`page`	`integer`	Nee	`1`	Bladsynommer, begin by 1.
`limit`	`integer`	Nee	`3`	Items per bladsy.

Voorbeeld reaksie

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

Top bedieners

Neigingslys geoptimaliseer vir tuisblad/legstukgebruik.

Voorbeeld versoek

cURL

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

Navraag parameters

Naam	Tik	vereis word	verstek	Beskrywing
`sort`	`string`	Nee	`votes`	Sorteer volgorde.
`limit`	`integer`	Nee	`10`	Items per bladsy.
`country`	`string`	Nee	`—`	ISO-landnaamfilter.
`gameMode`	`string`	Nee	`—`	Spelmodus filter.

Voorbeeld reaksie

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

Bedienerlande

Samegestelde telling van bedieners gegroepeer volgens land.

Voorbeeld versoek

cURL

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

Navraag parameters

Geen parameters nie

Voorbeeld reaksie

JSON

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

GET

/api/v1/servers/versions

Bediener weergawes

Samegestelde telling van bedieners gegroepeer volgens Minecraft-weergawe.

Voorbeeld versoek

cURL

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

Navraag parameters

Geen parameters nie

Voorbeeld reaksie

JSON

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

Speler eindpunte

Soek spelerprofiele, sessies, vlakke en geskiedenis op.

GET

/api/v1/players

Lys spelers

Gepagineerde publieke spelergids.

Voorbeeld versoek

cURL

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

Navraag parameters

Naam	Tik	vereis word	verstek	Beskrywing
`page`	`integer`	Nee	`1`	Bladsynommer, begin by 1.
`limit`	`integer`	Nee	`—`	Items per bladsy.
`sort`	`string`	Nee	`recent`	Sorteer volgorde.
`search`	`string`	Nee	`—`	Vryteks-navraag.

Voorbeeld reaksie

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}

Speler detail

Profiel, onlangse sessies, bedieners gespeel, K/D, prestasies.

Voorbeeld versoek

cURL

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

Navraag parameters

Naam	Tik	vereis word	verstek	Beskrywing
`id`	`string`	Ja	`—`	Speler-ID, UUID of bynaam.

Voorbeeld reaksie

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

Soek

Verenigde soektog oor bedieners en spelers.

GET

/api/v1/search

Wêreldwye soektog

Soek bedieners en spelers in een oproep.

Voorbeeld versoek

cURL

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

Navraag parameters

Naam	Tik	vereis word	verstek	Beskrywing
`q`	`string`	Ja	`—`	Soeknavraag (2–100 tekens).
`type`	`string`	Nee	`all`	Resultaattipe: all, servers, players.
`limit`	`integer`	Nee	`10`	Items per bladsy.

Voorbeeld reaksie

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

Regstreekse en globale statistieke

Intydse globale aktiwiteit, streek en land uiteensettings.

GET

/api/v1/live

Regstreekse statistieke

Globale aanlyntotale, topbedieners, onlangse aktiwiteit, streek en land uiteensetting.

Voorbeeld versoek

cURL

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

Navraag parameters

Geen parameters nie

Voorbeeld reaksie

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

Lewendige geskiedenis

Uurlikse emmers van totale aanlynspelers oor die afgelope 7 dae.

Voorbeeld versoek

cURL

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

Navraag parameters

Geen parameters nie

Voorbeeld reaksie

JSON

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

Ranglyste

Topspelers gerangskik volgens sessies, bedieners of vlakpunte.

GET

/api/v1/leaderboards

Ranglyste

Topspelers vir die geselekteerde metrieke, tydperk, vlak en prestasiefilters.

Voorbeeld versoek

cURL

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

Navraag parameters

Naam	Tik	vereis word	verstek	Beskrywing
`metric`	`string`	Nee	`best`	Rangorde-metriek: best, sessions, servers.
`period`	`string`	Nee	`all-time`	Tydvenster: 24h, 7d, 30d, 90d, all-time.
`page`	`integer`	Nee	`1`	Bladsynommer, begin by 1.
`limit`	`integer`	Nee	`20`	Items per bladsy.
`tier`	`string`	Nee	`—`	Vlak filter.
`achievement`	`string`	Nee	`—`	Prestasie filter.
`search`	`string`	Nee	`—`	Vryteks-navraag.

Voorbeeld reaksie

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

Skins & Mantels

Soek velle en kappe wat deur die gemeenskap opgelaai is.

GET

/api/v1/skins

Lys velle

Blaai deur gemeenskapveloplaaie met sorteer/filter.

Voorbeeld versoek

cURL

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

Navraag parameters

Naam	Tik	vereis word	verstek	Beskrywing
`page`	`integer`	Nee	`1`	Bladsynommer, begin by 1.
`limit`	`integer`	Nee	`24`	Items per bladsy.
`sort`	`string`	Nee	`recent`	Sorteer volgorde.
`model`	`string`	Nee	`—`	Velmodel: klassiek of skraal.
`search`	`string`	Nee	`—`	Vryteks-navraag.
`tag`	`string`	Nee	`—`	Filter volgens merker.
`owner`	`string`	Nee	`—`	Eienaar gebruikernaam filter.

Voorbeeld reaksie

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}

Veldetail

Volvel-metadata plus die kyker se hou/gunsteling-status.

Voorbeeld versoek

cURL

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

Navraag parameters

Naam	Tik	vereis word	verstek	Beskrywing
`slug`	`string`	Ja	`—`	Bedienerslak (van /bedienerslys).

Voorbeeld reaksie

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

Lys capes

Blaai deur gemeenskapskaap-oplaaie met sorteer/filter.

Voorbeeld versoek

cURL

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

Navraag parameters

Naam	Tik	vereis word	verstek	Beskrywing
`page`	`integer`	Nee	`1`	Bladsynommer, begin by 1.
`limit`	`integer`	Nee	`24`	Items per bladsy.
`sort`	`string`	Nee	`recent`	Sorteer volgorde.
`search`	`string`	Nee	`—`	Vryteks-navraag.
`tag`	`string`	Nee	`—`	Filter volgens merker.
`owner`	`string`	Nee	`—`	Eienaar gebruikernaam filter.

Voorbeeld reaksie

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}

Cape-besonderhede

Volledige cape-metadata plus die kyker se hou-van-/gunsteling-status.

Voorbeeld versoek

cURL

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

Navraag parameters

Naam	Tik	vereis word	verstek	Beskrywing
`slug`	`string`	Ja	`—`	Bedienerslak (van /bedienerslys).

Voorbeeld reaksie

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