REST API

एपीआई दस्तावेज़ीकरण

mcstat.org से लाइव Minecraft सर्वर, प्लेयर, स्किन और सामुदायिक डेटा को अपने ऐप्स, बॉट और डैशबोर्ड में एकीकृत करें।

आधार यूआरएल

सभी एपीआई अनुरोध इस आधार यूआरएल से शुरू होते हैं

https://mcstat.org/api/v1

Markdown के रूप में देखें

AI, बॉट और टूल के लिए रॉ Markdown दस्तावेज़

एपीआई कुंजी

अपनी एपीआई कुंजियाँ प्रबंधित और मॉनिटर करें

डैशबोर्ड में अपनी एपीआई कुंजियों के लिए विश्लेषण बनाएं, घुमाएँ और देखें।

एपीआई कुंजी डैशबोर्ड खोलें

एपीआई खेल का मैदान

सीधे ब्राउज़र में एंडपॉइंट का परीक्षण करें

बॉट जाँच

इस प्लेग्राउंड के लिए API कुंजी की आवश्यकता नहीं है; दुरुपयोग कम करने के लिए मानवीय सत्यापन आवश्यक है।

समापन बिंदु

GET

/api/v1/servers

क्वेरी पैरामीटर

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

यूआरएल का अनुरोध करें

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

प्रतिक्रिया देखने के लिए अनुरोध चलाएँ

प्रमाणीकरण

सभी दस्तावेज़ित सार्वजनिक एपीआई एंडपॉइंट के लिए एपीआई कुंजी की आवश्यकता होती है। अपनी कुंजी X-API-कुंजी हेडर में भेजें.

हेडर का अनुरोध करें

प्रमाणित करने के लिए इस हेडर को जोड़ें

X-API-Key: mcs_your_key_here

या क्वेरी पैरामीटर के रूप में

या क्वेरी पैरामीटर के रूप में पास करें

?api_key=mcs_your_key_here

दर सीमा

अनुरोध एपीआई कुंजी द्वारा प्रमाणित किए जाते हैं। गुम या अमान्य कुंजियाँ HTTP 401 लौटाती हैं; सीमा से अधिक होने पर HTTP 429 वापस आता है।

एपीआई कुंजी के बिना

अनुमति नहीं है

एपीआई कुंजी के साथ

आज भी वही मध्यम स्तर, एट्रिब्यूशन और प्राथमिकता कतार के साथ। सशुल्क योजनाओं के साथ उच्च स्तर उपलब्ध होंगे।

दर सीमा शीर्षलेख:प्रत्येक प्रतिक्रिया में एक कैश-कंट्रोल हेडर शामिल होता है ताकि आप क्लाइंट-साइड परिणामों को सुरक्षित रूप से कैश कर सकें।

प्रतिक्रिया स्वरूप

प्रत्येक सफल प्रतिक्रिया एक बूलियन और एक ऑब्जेक्ट के साथ JSON है। त्रुटियाँ के साथ एक ही लिफाफे का उपयोग करती हैं: गलत।

सफलता प्रतिक्रिया

JSON

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

त्रुटि प्रतिक्रिया

JSON

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

त्रुटियाँ

मानक HTTP स्थिति कोड का उपयोग किया जाता है। सामान्य मामले:

कोड	मतलब
`400`	ख़राब अनुरोध - अमान्य पैरामीटर
`401`	अनधिकृत - गुम या अमान्य एपीआई कुंजी
`404`	नहीं मिला - संसाधन मौजूद नहीं है
`429`	बहुत अधिक अनुरोध - दर सीमा पार हो गई है
`500`	आंतरिक सर्वर त्रुटि - बाद में पुनः प्रयास करें

सर्वर समापनबिंदु

mcstat.org द्वारा ट्रैक किए गए Minecraft सर्वर को ब्राउज़ करें, फ़िल्टर करें और निरीक्षण करें।

GET

/api/v1/servers

सूची सर्वर

समृद्ध फ़िल्टर वाले सार्वजनिक सर्वरों की पृष्ठांकित सूची।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`page`	`integer`	नहीं	`1`	पृष्ठ संख्या, 1 से प्रारंभ.
`limit`	`integer`	नहीं	`20`	प्रति पृष्ठ आइटम.
`sort`	`string`	नहीं	`recent`	क्रमबद्ध करें.
`search`	`string`	नहीं	`—`	निःशुल्क-पाठ क्वेरी.
`country`	`string`	नहीं	`—`	आईएसओ देश का नाम फ़िल्टर।
`version`	`string`	नहीं	`—`	Minecraft संस्करण फ़िल्टर।
`tag`	`string`	नहीं	`—`	टैग द्वारा फ़िल्टर करें.
`mode`	`string`	नहीं	`—`	गेम-मोड फ़िल्टर.
`minPlayers`	`integer`	नहीं	`—`	न्यूनतम वर्तमान खिलाड़ी संख्या.
`maxPlayers`	`integer`	नहीं	`—`	अधिकतम वर्तमान खिलाड़ी संख्या.
`minUptime`	`number`	नहीं	`—`	न्यूनतम अपटाइम प्रतिशत.
`minVotes`	`integer`	नहीं	`—`	न्यूनतम कुल वोट संख्या.
`minRating`	`number`	नहीं	`—`	न्यूनतम रेटिंग (1-5)।
`onlineOnly`	`boolean`	नहीं	`—`	केवल ऑनलाइन रिपोर्टिंग करने वाले सर्वर शामिल करें।

उदाहरण प्रतिक्रिया

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}

सर्वर विवरण

पूर्ण सर्वर प्रोफ़ाइल: सांख्यिकी इतिहास, अपटाइम, वोट चार्ट, रैंक।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`slug`	`string`	हाँ	`—`	सर्वर स्लग (/सर्वर सूची से)।
`period`	`string`	नहीं	`24h`	समय विंडो: 24h, 7d, 30d, 90d, all-time.

उदाहरण प्रतिक्रिया

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

सर्वर मतदाता

दिए गए सर्वर के लिए हाल के मतदाता (प्रमाणीकृत और गुमनाम)।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`slug`	`string`	हाँ	`—`	सर्वर स्लग (/सर्वर सूची से)।
`page`	`integer`	नहीं	`1`	पृष्ठ संख्या, 1 से प्रारंभ.
`limit`	`integer`	नहीं	`7`	प्रति पृष्ठ आइटम.

उदाहरण प्रतिक्रिया

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

सर्वर समीक्षाएँ

किसी सर्वर के लिए पृष्ठांकित खिलाड़ी समीक्षाएँ और रेटिंग।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`slug`	`string`	हाँ	`—`	सर्वर स्लग (/सर्वर सूची से)।
`page`	`integer`	नहीं	`1`	पृष्ठ संख्या, 1 से प्रारंभ.
`limit`	`integer`	नहीं	`5`	प्रति पृष्ठ आइटम.

उदाहरण प्रतिक्रिया

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

सर्वर अपडेट

किसी सर्वर के लिए स्वीकृत समाचार और अपडेट पोस्ट।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`slug`	`string`	हाँ	`—`	सर्वर स्लग (/सर्वर सूची से)।
`page`	`integer`	नहीं	`1`	पृष्ठ संख्या, 1 से प्रारंभ.
`limit`	`integer`	नहीं	`3`	प्रति पृष्ठ आइटम.

उदाहरण प्रतिक्रिया

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

शीर्ष सर्वर

मुखपृष्ठ/विजेट उपयोग के लिए रुझान वाली सूची अनुकूलित।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`sort`	`string`	नहीं	`votes`	क्रमबद्ध करें.
`limit`	`integer`	नहीं	`10`	प्रति पृष्ठ आइटम.
`country`	`string`	नहीं	`—`	आईएसओ देश का नाम फ़िल्टर।
`gameMode`	`string`	नहीं	`—`	गेम-मोड फ़िल्टर.

उदाहरण प्रतिक्रिया

JSON

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

सर्वर देश

देश के अनुसार समूहीकृत सर्वरों की कुल संख्या।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

कोई पैरामीटर नहीं

उदाहरण प्रतिक्रिया

JSON

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

GET

/api/v1/servers/versions

सर्वर संस्करण

Minecraft संस्करण द्वारा समूहीकृत सर्वरों की कुल संख्या।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

कोई पैरामीटर नहीं

उदाहरण प्रतिक्रिया

JSON

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

प्लेयर समापनबिंदु

खिलाड़ी प्रोफ़ाइल, सत्र, स्तर और इतिहास देखें।

GET

/api/v1/players

खिलाड़ियों की सूची बनाएं

पृष्ठांकित सार्वजनिक प्लेयर निर्देशिका.

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`page`	`integer`	नहीं	`1`	पृष्ठ संख्या, 1 से प्रारंभ.
`limit`	`integer`	नहीं	`—`	प्रति पृष्ठ आइटम.
`sort`	`string`	नहीं	`recent`	क्रमबद्ध करें.
`search`	`string`	नहीं	`—`	निःशुल्क-पाठ क्वेरी.

उदाहरण प्रतिक्रिया

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}

खिलाड़ी विवरण

प्रोफ़ाइल, हाल के सत्र, खेले गए सर्वर, के/डी, उपलब्धियां।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`id`	`string`	हाँ	`—`	प्लेयर आईडी, यूयूआईडी या उपनाम।

उदाहरण प्रतिक्रिया

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

खोजें

सर्वर और खिलाड़ियों में एकीकृत खोज।

GET

/api/v1/search

वैश्विक खोज

एक कॉल में सर्वर और खिलाड़ी खोजें।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`q`	`string`	हाँ	`—`	खोज क्वेरी (2-100 वर्ण)।
`type`	`string`	नहीं	`all`	परिणाम प्रकार: all, servers, players.
`limit`	`integer`	नहीं	`10`	प्रति पृष्ठ आइटम.

उदाहरण प्रतिक्रिया

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

लाइव और वैश्विक आँकड़े

वास्तविक समय की वैश्विक गतिविधि, क्षेत्र और देश का विवरण।

GET

/api/v1/live

लाइव आँकड़े

वैश्विक ऑनलाइन योग, शीर्ष सर्वर, हाल की गतिविधि, क्षेत्र और देश का विवरण।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

कोई पैरामीटर नहीं

उदाहरण प्रतिक्रिया

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

जीवंत इतिहास

पिछले 7 दिनों में कुल ऑनलाइन खिलाड़ियों की प्रति घंटा बकेट।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

कोई पैरामीटर नहीं

उदाहरण प्रतिक्रिया

JSON

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

लीडरबोर्ड

शीर्ष खिलाड़ियों को सत्र, सर्वर या टियर पॉइंट के आधार पर रैंक किया गया।

GET

/api/v1/leaderboards

लीडरबोर्ड

चयनित मीट्रिक, अवधि, स्तर और उपलब्धि फ़िल्टर के लिए शीर्ष खिलाड़ी।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`metric`	`string`	नहीं	`best`	रैंकिंग मीट्रिक: best, sessions, servers.
`period`	`string`	नहीं	`all-time`	समय विंडो: 24h, 7d, 30d, 90d, all-time.
`page`	`integer`	नहीं	`1`	पृष्ठ संख्या, 1 से प्रारंभ.
`limit`	`integer`	नहीं	`20`	प्रति पृष्ठ आइटम.
`tier`	`string`	नहीं	`—`	टियर फ़िल्टर.
`achievement`	`string`	नहीं	`—`	उपलब्धि फ़िल्टर.
`search`	`string`	नहीं	`—`	निःशुल्क-पाठ क्वेरी.

उदाहरण प्रतिक्रिया

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

खाल और टोपी

समुदाय द्वारा अपलोड की गई खाल और टोपी खोजें।

GET

/api/v1/skins

खालों की सूची बनाएं

सॉर्ट/फ़िल्टर के साथ सामुदायिक त्वचा अपलोड ब्राउज़ करें।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`page`	`integer`	नहीं	`1`	पृष्ठ संख्या, 1 से प्रारंभ.
`limit`	`integer`	नहीं	`24`	प्रति पृष्ठ आइटम.
`sort`	`string`	नहीं	`recent`	क्रमबद्ध करें.
`model`	`string`	नहीं	`—`	त्वचा मॉडल: क्लासिक या पतला।
`search`	`string`	नहीं	`—`	निःशुल्क-पाठ क्वेरी.
`tag`	`string`	नहीं	`—`	टैग द्वारा फ़िल्टर करें.
`owner`	`string`	नहीं	`—`	स्वामी उपयोगकर्ता नाम फ़िल्टर.

उदाहरण प्रतिक्रिया

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}

त्वचा का विवरण

संपूर्ण त्वचा मेटाडेटा और दर्शक की पसंद/पसंदीदा स्थिति।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`slug`	`string`	हाँ	`—`	सर्वर स्लग (/सर्वर सूची से)।

उदाहरण प्रतिक्रिया

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

सूची टोपी

सॉर्ट/फ़िल्टर के साथ सामुदायिक केप अपलोड ब्राउज़ करें।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`page`	`integer`	नहीं	`1`	पृष्ठ संख्या, 1 से प्रारंभ.
`limit`	`integer`	नहीं	`24`	प्रति पृष्ठ आइटम.
`sort`	`string`	नहीं	`recent`	क्रमबद्ध करें.
`search`	`string`	नहीं	`—`	निःशुल्क-पाठ क्वेरी.
`tag`	`string`	नहीं	`—`	टैग द्वारा फ़िल्टर करें.
`owner`	`string`	नहीं	`—`	स्वामी उपयोगकर्ता नाम फ़िल्टर.

उदाहरण प्रतिक्रिया

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}

केप विवरण

पूर्ण केप मेटाडेटा के साथ दर्शक की लाइक/पसंदीदा स्थिति।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`slug`	`string`	हाँ	`—`	सर्वर स्लग (/सर्वर सूची से)।

उदाहरण प्रतिक्रिया

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,
      "owner": {
        "id": "Nf3kPq8sT2wVxJ7b",
        "username": "notch",
        "avatar": "https://mcstat.org/media/avatars/notch.webp"
      },
      "viewer": {
        "liked": false,
        "favorited": false,
        "isOwner": false
      }
    }
  }
}

MCSTATMinecraft सर्वर सूची

REST API

एपीआई दस्तावेज़ीकरण

आधार यूआरएल

सभी एपीआई अनुरोध इस आधार यूआरएल से शुरू होते हैं

https://mcstat.org/api/v1

Markdown के रूप में देखें

AI, बॉट और टूल के लिए रॉ Markdown दस्तावेज़

एपीआई कुंजी

अपनी एपीआई कुंजियाँ प्रबंधित और मॉनिटर करें

डैशबोर्ड में अपनी एपीआई कुंजियों के लिए विश्लेषण बनाएं, घुमाएँ और देखें।

एपीआई कुंजी डैशबोर्ड खोलें

एपीआई खेल का मैदान

सीधे ब्राउज़र में एंडपॉइंट का परीक्षण करें

बॉट जाँच

समापन बिंदु

GET

/api/v1/servers

क्वेरी पैरामीटर

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

यूआरएल का अनुरोध करें

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

प्रतिक्रिया देखने के लिए अनुरोध चलाएँ

प्रमाणीकरण

हेडर का अनुरोध करें

प्रमाणित करने के लिए इस हेडर को जोड़ें

X-API-Key: mcs_your_key_here

या क्वेरी पैरामीटर के रूप में

या क्वेरी पैरामीटर के रूप में पास करें

?api_key=mcs_your_key_here

दर सीमा

एपीआई कुंजी के बिना

अनुमति नहीं है

एपीआई कुंजी के साथ

प्रतिक्रिया स्वरूप

सफलता प्रतिक्रिया

JSON

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

त्रुटि प्रतिक्रिया

JSON

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

त्रुटियाँ

मानक HTTP स्थिति कोड का उपयोग किया जाता है। सामान्य मामले:

कोड	मतलब
`400`	ख़राब अनुरोध - अमान्य पैरामीटर
`401`	अनधिकृत - गुम या अमान्य एपीआई कुंजी
`404`	नहीं मिला - संसाधन मौजूद नहीं है
`429`	बहुत अधिक अनुरोध - दर सीमा पार हो गई है
`500`	आंतरिक सर्वर त्रुटि - बाद में पुनः प्रयास करें

सर्वर समापनबिंदु

GET

/api/v1/servers

सूची सर्वर

समृद्ध फ़िल्टर वाले सार्वजनिक सर्वरों की पृष्ठांकित सूची।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`page`	`integer`	नहीं	`1`	पृष्ठ संख्या, 1 से प्रारंभ.
`limit`	`integer`	नहीं	`20`	प्रति पृष्ठ आइटम.
`sort`	`string`	नहीं	`recent`	क्रमबद्ध करें.
`search`	`string`	नहीं	`—`	निःशुल्क-पाठ क्वेरी.
`country`	`string`	नहीं	`—`	आईएसओ देश का नाम फ़िल्टर।
`version`	`string`	नहीं	`—`	Minecraft संस्करण फ़िल्टर।
`tag`	`string`	नहीं	`—`	टैग द्वारा फ़िल्टर करें.
`mode`	`string`	नहीं	`—`	गेम-मोड फ़िल्टर.
`minPlayers`	`integer`	नहीं	`—`	न्यूनतम वर्तमान खिलाड़ी संख्या.
`maxPlayers`	`integer`	नहीं	`—`	अधिकतम वर्तमान खिलाड़ी संख्या.
`minUptime`	`number`	नहीं	`—`	न्यूनतम अपटाइम प्रतिशत.
`minVotes`	`integer`	नहीं	`—`	न्यूनतम कुल वोट संख्या.
`minRating`	`number`	नहीं	`—`	न्यूनतम रेटिंग (1-5)।
`onlineOnly`	`boolean`	नहीं	`—`	केवल ऑनलाइन रिपोर्टिंग करने वाले सर्वर शामिल करें।

उदाहरण प्रतिक्रिया

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}

सर्वर विवरण

पूर्ण सर्वर प्रोफ़ाइल: सांख्यिकी इतिहास, अपटाइम, वोट चार्ट, रैंक।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`slug`	`string`	हाँ	`—`	सर्वर स्लग (/सर्वर सूची से)।
`period`	`string`	नहीं	`24h`	समय विंडो: 24h, 7d, 30d, 90d, all-time.

उदाहरण प्रतिक्रिया

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

सर्वर मतदाता

दिए गए सर्वर के लिए हाल के मतदाता (प्रमाणीकृत और गुमनाम)।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`slug`	`string`	हाँ	`—`	सर्वर स्लग (/सर्वर सूची से)।
`page`	`integer`	नहीं	`1`	पृष्ठ संख्या, 1 से प्रारंभ.
`limit`	`integer`	नहीं	`7`	प्रति पृष्ठ आइटम.

उदाहरण प्रतिक्रिया

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

सर्वर समीक्षाएँ

किसी सर्वर के लिए पृष्ठांकित खिलाड़ी समीक्षाएँ और रेटिंग।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`slug`	`string`	हाँ	`—`	सर्वर स्लग (/सर्वर सूची से)।
`page`	`integer`	नहीं	`1`	पृष्ठ संख्या, 1 से प्रारंभ.
`limit`	`integer`	नहीं	`5`	प्रति पृष्ठ आइटम.

उदाहरण प्रतिक्रिया

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

सर्वर अपडेट

किसी सर्वर के लिए स्वीकृत समाचार और अपडेट पोस्ट।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`slug`	`string`	हाँ	`—`	सर्वर स्लग (/सर्वर सूची से)।
`page`	`integer`	नहीं	`1`	पृष्ठ संख्या, 1 से प्रारंभ.
`limit`	`integer`	नहीं	`3`	प्रति पृष्ठ आइटम.

उदाहरण प्रतिक्रिया

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

शीर्ष सर्वर

मुखपृष्ठ/विजेट उपयोग के लिए रुझान वाली सूची अनुकूलित।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`sort`	`string`	नहीं	`votes`	क्रमबद्ध करें.
`limit`	`integer`	नहीं	`10`	प्रति पृष्ठ आइटम.
`country`	`string`	नहीं	`—`	आईएसओ देश का नाम फ़िल्टर।
`gameMode`	`string`	नहीं	`—`	गेम-मोड फ़िल्टर.

उदाहरण प्रतिक्रिया

JSON

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

सर्वर देश

देश के अनुसार समूहीकृत सर्वरों की कुल संख्या।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

कोई पैरामीटर नहीं

उदाहरण प्रतिक्रिया

JSON

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

GET

/api/v1/servers/versions

सर्वर संस्करण

Minecraft संस्करण द्वारा समूहीकृत सर्वरों की कुल संख्या।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

कोई पैरामीटर नहीं

उदाहरण प्रतिक्रिया

JSON

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

प्लेयर समापनबिंदु

खिलाड़ी प्रोफ़ाइल, सत्र, स्तर और इतिहास देखें।

GET

/api/v1/players

खिलाड़ियों की सूची बनाएं

पृष्ठांकित सार्वजनिक प्लेयर निर्देशिका.

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`page`	`integer`	नहीं	`1`	पृष्ठ संख्या, 1 से प्रारंभ.
`limit`	`integer`	नहीं	`—`	प्रति पृष्ठ आइटम.
`sort`	`string`	नहीं	`recent`	क्रमबद्ध करें.
`search`	`string`	नहीं	`—`	निःशुल्क-पाठ क्वेरी.

उदाहरण प्रतिक्रिया

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}

खिलाड़ी विवरण

प्रोफ़ाइल, हाल के सत्र, खेले गए सर्वर, के/डी, उपलब्धियां।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`id`	`string`	हाँ	`—`	प्लेयर आईडी, यूयूआईडी या उपनाम।

उदाहरण प्रतिक्रिया

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

खोजें

सर्वर और खिलाड़ियों में एकीकृत खोज।

GET

/api/v1/search

वैश्विक खोज

एक कॉल में सर्वर और खिलाड़ी खोजें।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`q`	`string`	हाँ	`—`	खोज क्वेरी (2-100 वर्ण)।
`type`	`string`	नहीं	`all`	परिणाम प्रकार: all, servers, players.
`limit`	`integer`	नहीं	`10`	प्रति पृष्ठ आइटम.

उदाहरण प्रतिक्रिया

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

लाइव और वैश्विक आँकड़े

वास्तविक समय की वैश्विक गतिविधि, क्षेत्र और देश का विवरण।

GET

/api/v1/live

लाइव आँकड़े

वैश्विक ऑनलाइन योग, शीर्ष सर्वर, हाल की गतिविधि, क्षेत्र और देश का विवरण।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

कोई पैरामीटर नहीं

उदाहरण प्रतिक्रिया

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

जीवंत इतिहास

पिछले 7 दिनों में कुल ऑनलाइन खिलाड़ियों की प्रति घंटा बकेट।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

कोई पैरामीटर नहीं

उदाहरण प्रतिक्रिया

JSON

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

लीडरबोर्ड

शीर्ष खिलाड़ियों को सत्र, सर्वर या टियर पॉइंट के आधार पर रैंक किया गया।

GET

/api/v1/leaderboards

लीडरबोर्ड

चयनित मीट्रिक, अवधि, स्तर और उपलब्धि फ़िल्टर के लिए शीर्ष खिलाड़ी।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`metric`	`string`	नहीं	`best`	रैंकिंग मीट्रिक: best, sessions, servers.
`period`	`string`	नहीं	`all-time`	समय विंडो: 24h, 7d, 30d, 90d, all-time.
`page`	`integer`	नहीं	`1`	पृष्ठ संख्या, 1 से प्रारंभ.
`limit`	`integer`	नहीं	`20`	प्रति पृष्ठ आइटम.
`tier`	`string`	नहीं	`—`	टियर फ़िल्टर.
`achievement`	`string`	नहीं	`—`	उपलब्धि फ़िल्टर.
`search`	`string`	नहीं	`—`	निःशुल्क-पाठ क्वेरी.

उदाहरण प्रतिक्रिया

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

खाल और टोपी

समुदाय द्वारा अपलोड की गई खाल और टोपी खोजें।

GET

/api/v1/skins

खालों की सूची बनाएं

सॉर्ट/फ़िल्टर के साथ सामुदायिक त्वचा अपलोड ब्राउज़ करें।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`page`	`integer`	नहीं	`1`	पृष्ठ संख्या, 1 से प्रारंभ.
`limit`	`integer`	नहीं	`24`	प्रति पृष्ठ आइटम.
`sort`	`string`	नहीं	`recent`	क्रमबद्ध करें.
`model`	`string`	नहीं	`—`	त्वचा मॉडल: क्लासिक या पतला।
`search`	`string`	नहीं	`—`	निःशुल्क-पाठ क्वेरी.
`tag`	`string`	नहीं	`—`	टैग द्वारा फ़िल्टर करें.
`owner`	`string`	नहीं	`—`	स्वामी उपयोगकर्ता नाम फ़िल्टर.

उदाहरण प्रतिक्रिया

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}

त्वचा का विवरण

संपूर्ण त्वचा मेटाडेटा और दर्शक की पसंद/पसंदीदा स्थिति।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`slug`	`string`	हाँ	`—`	सर्वर स्लग (/सर्वर सूची से)।

उदाहरण प्रतिक्रिया

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

सूची टोपी

सॉर्ट/फ़िल्टर के साथ सामुदायिक केप अपलोड ब्राउज़ करें।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`page`	`integer`	नहीं	`1`	पृष्ठ संख्या, 1 से प्रारंभ.
`limit`	`integer`	नहीं	`24`	प्रति पृष्ठ आइटम.
`sort`	`string`	नहीं	`recent`	क्रमबद्ध करें.
`search`	`string`	नहीं	`—`	निःशुल्क-पाठ क्वेरी.
`tag`	`string`	नहीं	`—`	टैग द्वारा फ़िल्टर करें.
`owner`	`string`	नहीं	`—`	स्वामी उपयोगकर्ता नाम फ़िल्टर.

उदाहरण प्रतिक्रिया

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}

केप विवरण

पूर्ण केप मेटाडेटा के साथ दर्शक की लाइक/पसंदीदा स्थिति।

उदाहरण अनुरोध

cURL

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

क्वेरी पैरामीटर

नाम	प्रकार	आवश्यक	डिफ़ॉल्ट	विवरण
`slug`	`string`	हाँ	`—`	सर्वर स्लग (/सर्वर सूची से)।

उदाहरण प्रतिक्रिया

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,
      "owner": {
        "id": "Nf3kPq8sT2wVxJ7b",
        "username": "notch",
        "avatar": "https://mcstat.org/media/avatars/notch.webp"
      },
      "viewer": {
        "liked": false,
        "favorited": false,
        "isOwner": false
      }
    }
  }
}