REST API

Dokumentasi API

Integrasikan data server, pemain, skin, dan komunitas Minecraft langsung dari mcstat.org ke dalam aplikasi, bot, dan dasbor Anda sendiri.

URL dasar

Semua permintaan API dimulai dengan URL dasar ini

https://mcstat.org/api/v1

Lihat sebagai Markdown

Dokumentasi Markdown mentah untuk AI, bot, dan alat

Kunci API

Kelola dan pantau kunci API Anda

Buat, putar, dan lihat analitik untuk kunci API Anda di dasbor.

Buka Dasbor Kunci API

Taman Bermain API

Uji titik akhir langsung di browser

Pemeriksaan Bot

Taman bermain ini tidak memerlukan kunci API; verifikasi manusia diperlukan untuk mengurangi penyalahgunaan.

Titik akhir

GET

/api/v1/servers

Parameter Kueri

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 Permintaan

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

Jalankan permintaan untuk melihat responsnya

Otentikasi

Semua titik akhir API publik yang terdokumentasi memerlukan kunci API. Kirim kunci Anda di header X-API-Key.

Judul permintaan

Tambahkan header ini untuk mengautentikasi

X-API-Key: mcs_your_key_here

Atau sebagai parameter kueri

Atau berikan sebagai parameter kueri

?api_key=mcs_your_key_here

Batasan tarif

Permintaan diautentikasi dengan kunci API. Kunci yang hilang atau tidak valid akan menampilkan HTTP 401, kunci yang dinonaktifkan akan menampilkan HTTP 403, dan batas yang terlampaui akan menampilkan HTTP 429.

Tanpa kunci API

Tidak diperbolehkan

Dengan kunci API

60 permintaan per menit, 1.000 per hari, dan 30.000 per bulan secara default. Melebihi batas akan mengembalikan HTTP 429 dengan header X-RateLimit-* yang menunjukkan batas Anda dan Retry-After yang memberi tahu Anda saat jendela disetel ulang. Batas yang lebih tinggi dapat diberikan per kunci berdasarkan permintaan.

Header Batas Nilai:Respons 429 membawa X-RateLimit-Limit-Minute, X-RateLimit-Limit-Day, X-RateLimit-Remaining-Day, X-RateLimit-Limit-Month, X-RateLimit-Remaining-Month dan Retry-After. Respons yang berhasil membawa header Kontrol-Cache sehingga Anda dapat menyimpan hasil cache dengan aman di sisi klien.

Format tanggapan

Setiap respons yang berhasil adalah JSON dengan boolean dan objek . Kesalahan menggunakan amplop yang sama dengan : false.

Respon sukses

JSON

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

Respon kesalahan

JSON

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

Kesalahan

Kode status HTTP standar digunakan. Kasus umum:

Kode	Artinya
`400`	Permintaan buruk — parameter tidak valid
`401`	Tidak sah — kunci API hilang atau tidak valid
`403`	Terlarang — Kunci API dinonaktifkan
`404`	Tidak ditemukan — sumber daya tidak ada
`429`	Terlalu banyak permintaan — batas tarif terlampaui
`500`	Kesalahan server internal — coba lagi nanti

Titik akhir server

Jelajahi, filter, dan periksa server Minecraft yang dilacak oleh mcstat.org.

GET

/api/v1/servers

Daftar server

Daftar paginasi server publik dengan filter kaya.

Contoh permintaan

cURL

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

Parameter Kueri

Nama	Ketik	diperlukan	bawaan	Deskripsi
`page`	`integer`	Tidak	`1`	Nomor halaman, dimulai dari 1.
`limit`	`integer`	Tidak	`20`	Item per halaman.
`sort`	`string`	Tidak	`recent`	Urutkan pesanan.
`search`	`string`	Tidak	`—`	Kueri teks bebas.
`country`	`string`	Tidak	`—`	Filter nama negara ISO.
`version`	`string`	Tidak	`—`	Filter versi Minecraft.
`tag`	`string`	Tidak	`—`	Filter berdasarkan tag.
`mode`	`string`	Tidak	`—`	Filter mode permainan.
`minPlayers`	`integer`	Tidak	`—`	Jumlah pemain minimum saat ini.
`maxPlayers`	`integer`	Tidak	`—`	Jumlah pemain maksimum saat ini.
`minUptime`	`number`	Tidak	`—`	Persentase waktu aktif minimum.
`minVotes`	`integer`	Tidak	`—`	Jumlah total suara minimum.
`minRating`	`number`	Tidak	`—`	Peringkat minimum (1–5).
`onlineOnly`	`boolean`	Tidak	`—`	Hanya sertakan server yang melaporkan secara online.

Contoh tanggapan

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}

Detail server

Profil server lengkap: riwayat statistik, waktu aktif, bagan suara, peringkat.

Contoh permintaan

cURL

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

Parameter Kueri

Nama	Ketik	diperlukan	bawaan	Deskripsi
`slug`	`string`	Ya	`—`	Siput server (dari daftar /servers).
`period`	`string`	Tidak	`24h`	Jendela waktu: 24h, 7d, 30d, 90d, all-time.

Contoh tanggapan

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 pemilih

Pemilih terkini (terautentikasi dan anonim) untuk server tertentu.

Contoh permintaan

cURL

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

Parameter Kueri

Nama	Ketik	diperlukan	bawaan	Deskripsi
`slug`	`string`	Ya	`—`	Siput server (dari daftar /servers).
`page`	`integer`	Tidak	`1`	Nomor halaman, dimulai dari 1.
`limit`	`integer`	Tidak	`7`	Item per halaman.

Contoh tanggapan

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

Ulasan server

Ulasan dan peringkat pemain berhalaman untuk sebuah server.

Contoh permintaan

cURL

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

Parameter Kueri

Nama	Ketik	diperlukan	bawaan	Deskripsi
`slug`	`string`	Ya	`—`	Siput server (dari daftar /servers).
`page`	`integer`	Tidak	`1`	Nomor halaman, dimulai dari 1.
`limit`	`integer`	Tidak	`5`	Item per halaman.

Contoh tanggapan

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

Pembaruan server

Postingan berita dan pembaruan yang disetujui untuk sebuah server.

Contoh permintaan

cURL

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

Parameter Kueri

Nama	Ketik	diperlukan	bawaan	Deskripsi
`slug`	`string`	Ya	`—`	Siput server (dari daftar /servers).
`page`	`integer`	Tidak	`1`	Nomor halaman, dimulai dari 1.
`limit`	`integer`	Tidak	`3`	Item per halaman.

Contoh tanggapan

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

Server teratas

Daftar tren dioptimalkan untuk penggunaan beranda/widget.

Contoh permintaan

cURL

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

Parameter Kueri

Nama	Ketik	diperlukan	bawaan	Deskripsi
`sort`	`string`	Tidak	`votes`	Urutkan pesanan.
`limit`	`integer`	Tidak	`10`	Item per halaman.
`country`	`string`	Tidak	`—`	Filter nama negara ISO.
`gameMode`	`string`	Tidak	`—`	Filter mode permainan.

Contoh tanggapan

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

Negara server

Jumlah agregat server yang dikelompokkan berdasarkan negara.

Contoh permintaan

cURL

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

Parameter Kueri

Tidak ada parameter

Contoh tanggapan

JSON

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

GET

/api/v1/servers/versions

Versi server

Jumlah agregat server yang dikelompokkan berdasarkan versi Minecraft.

Contoh permintaan

cURL

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

Parameter Kueri

Tidak ada parameter

Contoh tanggapan

JSON

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

Titik akhir pemain

Cari profil pemain, sesi, tingkatan, dan riwayat.

GET

/api/v1/players

Daftar pemain

Direktori pemutar publik yang diberi nomor halaman.

Contoh permintaan

cURL

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

Parameter Kueri

Nama	Ketik	diperlukan	bawaan	Deskripsi
`page`	`integer`	Tidak	`1`	Nomor halaman, dimulai dari 1.
`limit`	`integer`	Tidak	`—`	Item per halaman.
`sort`	`string`	Tidak	`recent`	Urutkan pesanan.
`search`	`string`	Tidak	`—`	Kueri teks bebas.

Contoh tanggapan

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}

Detil pemain

Profil, sesi terkini, server yang dimainkan, K/D, pencapaian.

Contoh permintaan

cURL

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

Parameter Kueri

Nama	Ketik	diperlukan	bawaan	Deskripsi
`id`	`string`	Ya	`—`	Id pemain, UUID atau nama panggilan.

Contoh tanggapan

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

Cari

Pencarian terpadu di seluruh server dan pemain.

GET

/api/v1/search

Pencarian global

Cari server dan pemain dalam satu panggilan.

Contoh permintaan

cURL

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

Parameter Kueri

Nama	Ketik	diperlukan	bawaan	Deskripsi
`q`	`string`	Ya	`—`	Kueri penelusuran (2–100 karakter).
`type`	`string`	Tidak	`all`	Jenis hasil: all, servers, players.
`limit`	`integer`	Tidak	`10`	Item per halaman.

Contoh tanggapan

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

Statistik Langsung & Global

Pengelompokan aktivitas global, wilayah, dan negara secara real-time.

GET

/api/v1/live

Statistik langsung

Total online global, server teratas, aktivitas terkini, rincian wilayah dan negara.

Contoh permintaan

cURL

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

Parameter Kueri

Tidak ada parameter

Contoh tanggapan

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

Sejarah hidup

Jumlah total pemain online setiap jam selama 7 hari terakhir.

Contoh permintaan

cURL

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

Parameter Kueri

Tidak ada parameter

Contoh tanggapan

JSON

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

Papan peringkat

Pemain teratas diberi peringkat berdasarkan sesi, server, atau poin tingkat.

GET

/api/v1/leaderboards

Papan peringkat

Pemain teratas untuk filter metrik, periode, tingkatan, dan pencapaian yang dipilih.

Contoh permintaan

cURL

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

Parameter Kueri

Nama	Ketik	diperlukan	bawaan	Deskripsi
`metric`	`string`	Tidak	`best`	Metrik peringkat: best, sessions, servers.
`period`	`string`	Tidak	`all-time`	Jendela waktu: 24h, 7d, 30d, 90d, all-time.
`page`	`integer`	Tidak	`1`	Nomor halaman, dimulai dari 1.
`limit`	`integer`	Tidak	`20`	Item per halaman.
`tier`	`string`	Tidak	`—`	Filter tingkat.
`achievement`	`string`	Tidak	`—`	Filter pencapaian.
`search`	`string`	Tidak	`—`	Kueri teks bebas.

Contoh tanggapan

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

Kulit & Jubah

Telusuri skin dan jubah yang diunggah komunitas.

GET

/api/v1/skins

Daftar kulit

Jelajahi unggahan skin komunitas dengan sortir/filter.

Contoh permintaan

cURL

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

Parameter Kueri

Nama	Ketik	diperlukan	bawaan	Deskripsi
`page`	`integer`	Tidak	`1`	Nomor halaman, dimulai dari 1.
`limit`	`integer`	Tidak	`24`	Item per halaman.
`sort`	`string`	Tidak	`recent`	Urutkan pesanan.
`model`	`string`	Tidak	`—`	Model kulit: klasik atau ramping.
`search`	`string`	Tidak	`—`	Kueri teks bebas.
`tag`	`string`	Tidak	`—`	Filter berdasarkan tag.
`owner`	`string`	Tidak	`—`	Filter nama pengguna pemilik.

Contoh tanggapan

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}

Detail kulit

Metadata kulit lengkap ditambah status suka/favorit pemirsa.

Contoh permintaan

cURL

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

Parameter Kueri

Nama	Ketik	diperlukan	bawaan	Deskripsi
`slug`	`string`	Ya	`—`	Siput server (dari daftar /servers).

Contoh tanggapan

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

Daftar jubah

Jelajahi unggahan jubah komunitas dengan sortir/filter.

Contoh permintaan

cURL

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

Parameter Kueri

Nama	Ketik	diperlukan	bawaan	Deskripsi
`page`	`integer`	Tidak	`1`	Nomor halaman, dimulai dari 1.
`limit`	`integer`	Tidak	`24`	Item per halaman.
`sort`	`string`	Tidak	`recent`	Urutkan pesanan.
`search`	`string`	Tidak	`—`	Kueri teks bebas.
`tag`	`string`	Tidak	`—`	Filter berdasarkan tag.
`owner`	`string`	Tidak	`—`	Filter nama pengguna pemilik.

Contoh tanggapan

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}

Detail cape

Metadata cape lengkap beserta status suka/favorit penonton.

Contoh permintaan

cURL

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

Parameter Kueri

Nama	Ketik	diperlukan	bawaan	Deskripsi
`slug`	`string`	Ya	`—`	Siput server (dari daftar /servers).

Contoh tanggapan

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