REST API

API-dokumentasjon

Integrer live Minecraft-server-, spiller-, hud- og fellesskapsdata fra mcstat.org i dine egne apper, roboter og dashboards.

Base-URL

Alle API-forespørsler starter med denne basis-URLen

https://mcstat.org/api/v1

Vis som Markdown

Rå Markdown-dokumentasjon for AI-er, boter og verktøy

API-nøkler

Administrer og overvåk API-nøklene dine

Opprett, roter og vis analyser for API-nøklene dine i dashbordet.

Åpne API Key Dashboard

API-lekeplass

Test endepunkter direkte i nettleseren

Bot-sjekk

Denne lekeplassen krever ikke en API-nøkkel; menneskelig verifisering er nødvendig for å redusere misbruk.

Endepunkt

GET

/api/v1/servers

Spørringsparametere

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

Be om URL

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

Kjør en forespørsel for å se svaret

Autentisering

Alle dokumenterte offentlige API-endepunkter krever en API-nøkkel. Send nøkkelen i X-API-Key-overskriften.

Forespørselsoverskrift

Legg til denne overskriften for å autentisere

X-API-Key: mcs_your_key_here

Eller som spørringsparameter

Eller send som spørringsparameter

?api_key=mcs_your_key_here

Satsgrenser

Forespørsler er autentisert av API-nøkkel. En manglende eller ugyldig nøkkel returnerer HTTP 401, en deaktivert nøkkel returnerer HTTP 403, og en overskredet grense returnerer HTTP 429.

Uten API-nøkkel

Ikke tillatt

Med API-nøkkel

60 forespørsler per minutt, 1 000 per dag og 30 000 per måned som standard. Overskridelse av en grense returnerer HTTP 429 med X-RateLimit-*-overskrifter som viser grensene dine og en Prøv på nytt-etter som forteller deg når vinduet tilbakestilles. Høyere grenser kan gis per nøkkel på forespørsel.

Overskrifter for satsgrense:Et 429-svar har X-RateLimit-Minute, X-RateLimit-Limit-Day, X-RateLimit-Remaining-Day, X-RateLimit-Limit-Month, X-RateLimit-Remainth-Month og Retry-Etter. Vellykkede svar har en Cache-Control-overskrift slik at du trygt kan bufre resultater på klientsiden.

Svarformat

Hvert vellykkede svar er JSON med en boolsk og et -objekt. Feil bruker samme konvolutt med : false.

Suksessrespons

JSON

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

Feilsvar

JSON

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

Feil

Standard HTTP-statuskoder brukes. Vanlige tilfeller:

Kode	Mening
`400`	Dårlig forespørsel – ugyldige parametere
`401`	Uautorisert – mangler eller ugyldig API-nøkkel
`403`	Forbudt – API-nøkkel deaktivert
`404`	Ikke funnet - ressursen finnes ikke
`429`	For mange forespørsler – takstgrensen er overskredet
`500`	Intern serverfeil – prøv igjen senere

Serverendepunkter

Bla gjennom, filtrer og inspiser Minecraft-servere sporet av mcstat.org.

GET

/api/v1/servers

List servere

Paginert liste over offentlige servere med rike filtre.

Eksempelforespørsel

cURL

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

Spørringsparametere

Navn	Type	nødvendig	standard	Beskrivelse
`page`	`integer`	Nei	`1`	Sidenummer, fra 1.
`limit`	`integer`	Nei	`20`	Elementer per side.
`sort`	`string`	Nei	`recent`	Sorteringsrekkefølge.
`search`	`string`	Nei	`—`	Fritekstspørring.
`country`	`string`	Nei	`—`	ISO-landsnavnfilter.
`version`	`string`	Nei	`—`	Minecraft versjonsfilter.
`tag`	`string`	Nei	`—`	Filtrer etter tag.
`mode`	`string`	Nei	`—`	Spillmodusfilter.
`minPlayers`	`integer`	Nei	`—`	Minimum antall spillere.
`maxPlayers`	`integer`	Nei	`—`	Maksimalt antall spillere.
`minUptime`	`number`	Nei	`—`	Minimum oppetidsprosent.
`minVotes`	`integer`	Nei	`—`	Minimum totalt antall stemmer.
`minRating`	`number`	Nei	`—`	Minimumsvurdering (1–5).
`onlineOnly`	`boolean`	Nei	`—`	Inkluder kun servere som 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}

Serverdetaljer

Full serverprofil: statistikkhistorikk, oppetid, stemmediagram, rangeringer.

Eksempelforespørsel

cURL

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

Spørringsparametere

Navn	Type	nødvendig	standard	Beskrivelse
`slug`	`string`	Ja	`—`	Server-slug (fra /servers-listen).
`period`	`string`	Nei	`24h`	Tidsvindu: 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

Servervelgere

Nylige velgere (autentiserte og anonyme) for den gitte serveren.

Eksempelforespørsel

cURL

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

Spørringsparametere

Navn	Type	nødvendig	standard	Beskrivelse
`slug`	`string`	Ja	`—`	Server-slug (fra /servers-listen).
`page`	`integer`	Nei	`1`	Sidenummer, fra 1.
`limit`	`integer`	Nei	`7`	Elementer per 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

Paginerte spilleranmeldelser og vurderinger for en server.

Eksempelforespørsel

cURL

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

Spørringsparametere

Navn	Type	nødvendig	standard	Beskrivelse
`slug`	`string`	Ja	`—`	Server-slug (fra /servers-listen).
`page`	`integer`	Nei	`1`	Sidenummer, fra 1.
`limit`	`integer`	Nei	`5`	Elementer per 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

Serveroppdateringer

Godkjente nyhets- og oppdateringsinnlegg for en server.

Eksempelforespørsel

cURL

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

Spørringsparametere

Navn	Type	nødvendig	standard	Beskrivelse
`slug`	`string`	Ja	`—`	Server-slug (fra /servers-listen).
`page`	`integer`	Nei	`1`	Sidenummer, fra 1.
`limit`	`integer`	Nei	`3`	Elementer per 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

Topp servere

Trendliste optimalisert for bruk av hjemmeside/widget.

Eksempelforespørsel

cURL

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

Spørringsparametere

Navn	Type	nødvendig	standard	Beskrivelse
`sort`	`string`	Nei	`votes`	Sorteringsrekkefølge.
`limit`	`integer`	Nei	`10`	Elementer per side.
`country`	`string`	Nei	`—`	ISO-landsnavnfilter.
`gameMode`	`string`	Nei	`—`	Spillmodusfilter.

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

Serverland

Samlet antall servere gruppert etter land.

Eksempelforespørsel

cURL

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

Spørringsparametere

Ingen parametere

Eksempel svar

JSON

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

GET

/api/v1/servers/versions

Serverversjoner

Samlet antall servere gruppert etter Minecraft-versjon.

Eksempelforespørsel

cURL

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

Spørringsparametere

Ingen parametere

Eksempel svar

JSON

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

Spillerens endepunkter

Slå opp spillerprofiler, økter, nivåer og historie.

GET

/api/v1/players

Liste spillere

Paginert offentlig spillerkatalog.

Eksempelforespørsel

cURL

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

Spørringsparametere

Navn	Type	nødvendig	standard	Beskrivelse
`page`	`integer`	Nei	`1`	Sidenummer, fra 1.
`limit`	`integer`	Nei	`—`	Elementer per side.
`sort`	`string`	Nei	`recent`	Sorteringsrekkefølge.
`search`	`string`	Nei	`—`	Fritekstspørring.

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}

Spillerdetaljer

Profil, nylige økter, spilte servere, K/D, prestasjoner.

Eksempelforespørsel

cURL

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

Spørringsparametere

Navn	Type	nødvendig	standard	Beskrivelse
`id`	`string`	Ja	`—`	Spiller-ID, UUID eller kallenavn.

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øk

Enhetlig søk på tvers av servere og spillere.

GET

/api/v1/search

Globalt søk

Søk i servere og spillere i ett kall.

Eksempelforespørsel

cURL

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

Spørringsparametere

Navn	Type	nødvendig	standard	Beskrivelse
`q`	`string`	Ja	`—`	Søk (2–100 tegn).
`type`	`string`	Nei	`all`	Resultattype: all, servers, players.
`limit`	`integer`	Nei	`10`	Elementer per 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 og global statistikk

Global aktivitet, region og land i sanntid.

GET

/api/v1/live

Live statistikk

Globale online-totaler, toppservere, nylig aktivitet, region og land.

Eksempelforespørsel

cURL

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

Spørringsparametere

Ingen parametere

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

Timespann med totalt antall onlinespillere i løpet av de siste 7 dagene.

Eksempelforespørsel

cURL

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

Spørringsparametere

Ingen parametere

Eksempel svar

JSON

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

Rangeringer

Toppspillere rangert etter økter, servere eller nivåpoeng.

GET

/api/v1/leaderboards

Rangeringer

Toppspillere for den valgte beregningen, perioden, nivået og prestasjonsfiltrene.

Eksempelforespørsel

cURL

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

Spørringsparametere

Navn	Type	nødvendig	standard	Beskrivelse
`metric`	`string`	Nei	`best`	Rangeringsberegning: best, sessions, servers.
`period`	`string`	Nei	`all-time`	Tidsvindu: 24h, 7d, 30d, 90d, all-time.
`page`	`integer`	Nei	`1`	Sidenummer, fra 1.
`limit`	`integer`	Nei	`20`	Elementer per side.
`tier`	`string`	Nei	`—`	Tierfilter.
`achievement`	`string`	Nei	`—`	Prestasjonsfilter.
`search`	`string`	Nei	`—`	Fritekstspørring.

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

Skinn og kapper

Søk etter fellesskapslastede skins og capes.

GET

/api/v1/skins

Liste skinn

Bla gjennom community skin-opplastinger med sorter/filter.

Eksempelforespørsel

cURL

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

Spørringsparametere

Navn	Type	nødvendig	standard	Beskrivelse
`page`	`integer`	Nei	`1`	Sidenummer, fra 1.
`limit`	`integer`	Nei	`24`	Elementer per side.
`sort`	`string`	Nei	`recent`	Sorteringsrekkefølge.
`model`	`string`	Nei	`—`	Hudmodell: klassisk eller slank.
`search`	`string`	Nei	`—`	Fritekstspørring.
`tag`	`string`	Nei	`—`	Filtrer etter tag.
`owner`	`string`	Nei	`—`	Eier brukernavn 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

Full skin metadata pluss seerens like/favorittstatus.

Eksempelforespørsel

cURL

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

Spørringsparametere

Navn	Type	nødvendig	standard	Beskrivelse
`slug`	`string`	Ja	`—`	Server-slug (fra /servers-listen).

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

Bla gjennom community cape-opplastinger med sortering/filter.

Eksempelforespørsel

cURL

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

Spørringsparametere

Navn	Type	nødvendig	standard	Beskrivelse
`page`	`integer`	Nei	`1`	Sidenummer, fra 1.
`limit`	`integer`	Nei	`24`	Elementer per side.
`sort`	`string`	Nei	`recent`	Sorteringsrekkefølge.
`search`	`string`	Nei	`—`	Fritekstspørring.
`tag`	`string`	Nei	`—`	Filtrer etter tag.
`owner`	`string`	Nei	`—`	Eier brukernavn 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

Fullstendige kappe-metadata pluss betrakterens liker-/favorittstatus.

Eksempelforespørsel

cURL

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

Spørringsparametere

Navn	Type	nødvendig	standard	Beskrivelse
`slug`	`string`	Ja	`—`	Server-slug (fra /servers-listen).

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