REST API

API dokumentation

Integrer live Minecraft-server-, spiller-, hud- og fællesskabsdata fra mcstat.org i dine egne apps, bots og dashboards.

Basis URL

Alle API-anmodninger starter med denne basis-URL

https://mcstat.org/api/v1

Vis som Markdown

Rå Markdown-dokumentation til AI'er, bots og værktøjer

API nøgler

Administrer og overvåg dine API-nøgler

Opret, roter og se analyser for dine API-nøgler i dashboardet.

Åbn API Key Dashboard

API legeplads

Test slutpunkter direkte i browseren

Bot-kontrol

Denne legeplads kræver ikke en API-nøgle; menneskelig verifikation er påkrævet for at reducere misbrug.

Slutpunkt

GET

/api/v1/servers

Forespørgselsparametre

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

Anmod om URL

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

Kør en anmodning for at se svaret

Autentificering

Alle dokumenterede offentlige API-endepunkter kræver en API-nøgle. Send din nøgle i X-API-Key headeren.

Anmodningshoved

Tilføj denne overskrift for at godkende

X-API-Key: mcs_your_key_here

Eller som forespørgselsparameter

Eller send som forespørgselsparameter

?api_key=mcs_your_key_here

Satsgrænser

Anmodninger godkendes af API-nøgle. En manglende eller ugyldig nøgle returnerer HTTP 401, en deaktiveret nøgle returnerer HTTP 403, og en overskredet grænse returnerer HTTP 429.

Uden API-nøgle

Ikke tilladt

Med API-nøgle

60 anmodninger pr. minut, 1.000 pr. dag og 30.000 pr. måned som standard. Overskridelse af en grænse returnerer HTTP 429 med X-RateLimit-* overskrifter, der viser dine grænser, og et Forsøg efter, der fortæller dig, når vinduet nulstilles. Højere grænser kan gives pr. nøgle efter anmodning.

Takstgrænseoverskrifter:Et 429-svar bærer X-RateLimit-Minute, X-RateLimit-Limit-Day, X-RateLimit-Remaining-Day, X-RateLimit-Limit-Month, X-RateLimit-Remainth-Month og Retry-After. Vellykkede svar har en Cache-Control-header, så du sikkert kan cache resultater på klientsiden.

Svarformat

Hvert vellykket svar er JSON med en boolean og et objekt. Fejl bruger den samme konvolut med : falsk.

Succes svar

JSON

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

Fejlsvar

JSON

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

Fejl

Standard HTTP-statuskoder bruges. Almindelige tilfælde:

Kode	Betydning
`400`	Dårlig anmodning — ugyldige parametre
`401`	Uautoriseret — manglende eller ugyldig API-nøgle
`403`	Forbudt — API-nøgle deaktiveret
`404`	Ikke fundet – ressource findes ikke
`429`	For mange anmodninger – takstgrænsen er overskredet
`500`	Intern serverfejl - prøv igen senere

Serverendepunkter

Gennemse, filtrer og inspicér Minecraft-servere sporet af mcstat.org.

GET

/api/v1/servers

Liste over servere

Sideinddelt liste over offentlige servere med rige filtre.

Eksempel på anmodning

cURL

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

Forespørgselsparametre

Navn	Type	påkrævet	standard	Beskrivelse
`page`	`integer`	Nej	`1`	Sidenummer, startende ved 1.
`limit`	`integer`	Nej	`20`	Varer pr. side.
`sort`	`string`	Nej	`recent`	Sorteringsrækkefølge.
`search`	`string`	Nej	`—`	Fritekst forespørgsel.
`country`	`string`	Nej	`—`	ISO-landenavnefilter.
`version`	`string`	Nej	`—`	Filter for Minecraft-version.
`tag`	`string`	Nej	`—`	Filtrer efter tag.
`mode`	`string`	Nej	`—`	Spil-mode filter.
`minPlayers`	`integer`	Nej	`—`	Minimum antal spillere.
`maxPlayers`	`integer`	Nej	`—`	Maksimalt antal spillere.
`minUptime`	`number`	Nej	`—`	Minimum oppetidsprocent.
`minVotes`	`integer`	Nej	`—`	Minimum samlet stemmetal.
`minRating`	`number`	Nej	`—`	Minimumsvurdering (1–5).
`onlineOnly`	`boolean`	Nej	`—`	Inkluder kun servere, der rapporterer online.

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

Server detaljer

Fuld serverprofil: statistikhistorik, oppetid, stemmediagram, rækker.

Eksempel på anmodning

cURL

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

Forespørgselsparametre

Navn	Type	påkrævet	standard	Beskrivelse
`slug`	`string`	Ja	`—`	Server slug (fra /servers liste).
`period`	`string`	Nej	`24h`	Tidsvindue: 24h, 7d, 30d, 90d, all-time.

Eksempel 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

Server vælgere

Nylige vælgere (godkendte og anonyme) for den givne server.

Eksempel på anmodning

cURL

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

Forespørgselsparametre

Navn	Type	påkrævet	standard	Beskrivelse
`slug`	`string`	Ja	`—`	Server slug (fra /servers liste).
`page`	`integer`	Nej	`1`	Sidenummer, startende ved 1.
`limit`	`integer`	Nej	`7`	Varer pr. side.

Eksempel 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

Serveranmeldelser

Paginerede spilleranmeldelser og bedømmelser for en server.

Eksempel på anmodning

cURL

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

Forespørgselsparametre

Navn	Type	påkrævet	standard	Beskrivelse
`slug`	`string`	Ja	`—`	Server slug (fra /servers liste).
`page`	`integer`	Nej	`1`	Sidenummer, startende ved 1.
`limit`	`integer`	Nej	`5`	Varer pr. side.

Eksempel 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

Serveropdateringer

Godkendte nyheds- og opdateringsindlæg for en server.

Eksempel på anmodning

cURL

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

Forespørgselsparametre

Navn	Type	påkrævet	standard	Beskrivelse
`slug`	`string`	Ja	`—`	Server slug (fra /servers liste).
`page`	`integer`	Nej	`1`	Sidenummer, startende ved 1.
`limit`	`integer`	Nej	`3`	Varer pr. side.

Eksempel 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

Top servere

Trendliste optimeret til startside/widgetbrug.

Eksempel på anmodning

cURL

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

Forespørgselsparametre

Navn	Type	påkrævet	standard	Beskrivelse
`sort`	`string`	Nej	`votes`	Sorteringsrækkefølge.
`limit`	`integer`	Nej	`10`	Varer pr. side.
`country`	`string`	Nej	`—`	ISO-landenavnefilter.
`gameMode`	`string`	Nej	`—`	Spil-mode filter.

Eksempel 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

Serverlande

Samlet antal servere grupperet efter land.

Eksempel på anmodning

cURL

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

Forespørgselsparametre

Ingen parametre

Eksempel svar

JSON

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

GET

/api/v1/servers/versions

Server versioner

Samlet antal servere grupperet efter Minecraft-version.

Eksempel på anmodning

cURL

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

Forespørgselsparametre

Ingen parametre

Eksempel svar

JSON

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

Spillerens slutpunkter

Slå op på spillerprofiler, sessioner, niveauer og historie.

GET

/api/v1/players

Liste spillere

Sideinddelt offentlig spillermappe.

Eksempel på anmodning

cURL

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

Forespørgselsparametre

Navn	Type	påkrævet	standard	Beskrivelse
`page`	`integer`	Nej	`1`	Sidenummer, startende ved 1.
`limit`	`integer`	Nej	`—`	Varer pr. side.
`sort`	`string`	Nej	`recent`	Sorteringsrækkefølge.
`search`	`string`	Nej	`—`	Fritekst forespørgsel.

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

Spiller detalje

Profil, seneste sessioner, afspillede servere, K/D, præstationer.

Eksempel på anmodning

cURL

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

Forespørgselsparametre

Navn	Type	påkrævet	standard	Beskrivelse
`id`	`string`	Ja	`—`	Spiller-id, UUID eller kaldenavn.

Eksempel 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øg

Samlet søgning på tværs af servere og spillere.

GET

/api/v1/search

Global søgning

Søg i servere og spillere i ét kald.

Eksempel på anmodning

cURL

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

Forespørgselsparametre

Navn	Type	påkrævet	standard	Beskrivelse
`q`	`string`	Ja	`—`	Søgeforespørgsel (2-100 tegn).
`type`	`string`	Nej	`all`	Resultattype: all, servers, players.
`limit`	`integer`	Nej	`10`	Varer pr. side.

Eksempel 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 & Global statistik

Opdeling af global aktivitet, region og lande i realtid.

GET

/api/v1/live

Live statistik

Globale onlinetotaler, topservere, seneste aktivitet, region og land opdeling.

Eksempel på anmodning

cURL

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

Forespørgselsparametre

Ingen parametre

Eksempel 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 historie

Hver time med samlede online spillere i løbet af de sidste 7 dage.

Eksempel på anmodning

cURL

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

Forespørgselsparametre

Ingen parametre

Eksempel svar

JSON

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

Ranglister

Topspillere rangeret efter sessioner, servere eller niveaupoint.

GET

/api/v1/leaderboards

Ranglister

Topspillere for de valgte metric, periode, niveau og præstationsfiltre.

Eksempel på anmodning

cURL

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

Forespørgselsparametre

Navn	Type	påkrævet	standard	Beskrivelse
`metric`	`string`	Nej	`best`	Rangeringsmetrik: best, sessions, servers.
`period`	`string`	Nej	`all-time`	Tidsvindue: 24h, 7d, 30d, 90d, all-time.
`page`	`integer`	Nej	`1`	Sidenummer, startende ved 1.
`limit`	`integer`	Nej	`20`	Varer pr. side.
`tier`	`string`	Nej	`—`	Tier-filter.
`achievement`	`string`	Nej	`—`	Præstationsfilter.
`search`	`string`	Nej	`—`	Fritekst forespørgsel.

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

Skind og kapper

Søg efter community-uploadede skins og capes.

GET

/api/v1/skins

Liste skins

Gennemse community skin-uploads med sorter/filter.

Eksempel på anmodning

cURL

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

Forespørgselsparametre

Navn	Type	påkrævet	standard	Beskrivelse
`page`	`integer`	Nej	`1`	Sidenummer, startende ved 1.
`limit`	`integer`	Nej	`24`	Varer pr. side.
`sort`	`string`	Nej	`recent`	Sorteringsrækkefølge.
`model`	`string`	Nej	`—`	Hudmodel: klassisk eller slank.
`search`	`string`	Nej	`—`	Fritekst forespørgsel.
`tag`	`string`	Nej	`—`	Filtrer efter tag.
`owner`	`string`	Nej	`—`	Ejer brugernavn filter.

Eksempel 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

Fuld skin metadata plus seerens like/favorit tilstand.

Eksempel på anmodning

cURL

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

Forespørgselsparametre

Navn	Type	påkrævet	standard	Beskrivelse
`slug`	`string`	Ja	`—`	Server slug (fra /servers liste).

Eksempel 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

Liste kapper

Gennemse community cape-uploads med sorter/filter.

Eksempel på anmodning

cURL

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

Forespørgselsparametre

Navn	Type	påkrævet	standard	Beskrivelse
`page`	`integer`	Nej	`1`	Sidenummer, startende ved 1.
`limit`	`integer`	Nej	`24`	Varer pr. side.
`sort`	`string`	Nej	`recent`	Sorteringsrækkefølge.
`search`	`string`	Nej	`—`	Fritekst forespørgsel.
`tag`	`string`	Nej	`—`	Filtrer efter tag.
`owner`	`string`	Nej	`—`	Ejer brugernavn filter.

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

Kappedetaljer

Fulde kappe-metadata plus beskuerens synes godt om-/favoritstatus.

Eksempel på anmodning

cURL

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

Forespørgselsparametre

Navn	Type	påkrævet	standard	Beskrivelse
`slug`	`string`	Ja	`—`	Server slug (fra /servers liste).

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