Skip to content

Profile Stats ​

GET /profile/{username}/leaderboard

Per-player rank and value across every stat for a gamemode/mode. Not Profile, despite the shared prefix.

Path and query parameters ​

ParameterTypeRequiredDescription
usernamestringrequired pathcase-insensitive
typestringrequired querygamemode id
modestringrecommended querynot crawled without this param
intervalstringoptional querysame yearly restriction as Leaderboards

Response 200 ​

key quirk

Object keyed by the stat's display name, not the raw stat key used by Leaderboards.

FieldTypeNotes
<displayName>objectkey is e.g. "Bow kills", not BOW_KILLS. See Gamemode Catalog for the raw to display mapping.
<displayName>.metadata.totalnumberplayers tracked for this stat
<displayName>.entriesEntry[]exactly one entry, this player's own rank
<displayName>.entries[].placenumber1-indexed absolute rank
<displayName>.entries[].valuestringnumeric string
<displayName>.entries[].idstringplayer username

Live example ​

Real GET request from your browser, bedwars stats for resuns.

LIVE REQUESTopen raw
fetching https://stats.pika-network.net/api/profile/resuns/leaderboard?type=bedwars&interval=total&mode=ALL_MODES ...

Response 204 ​

not an error

Player exists, has no data for this gamemode/mode. Empty body, treat exactly like an empty result.

text
GET /profile/xloray/leaderboard?type=bedwars&interval=total&mode=DOUBLES
204 No Content

Request forms ​

text
GET /profile/resuns/leaderboard?type=bedwars&interval=total&mode=ALL_MODES
bash
curl 'https://stats.pika-network.net/api/profile/resuns/leaderboard?type=bedwars&interval=total&mode=ALL_MODES'
ts
import { Gamemode, PikaNetworkClient } from '@kyizl/craftify';

const pika = new PikaNetworkClient();

const stats = await pika.getProfileStats({
  username: 'resuns',
  gamemode: Gamemode.BedWars,
});

stats.StatKey.BedWars.Kills;

Errors ​

StatusConditionVerified
204 (empty body)valid request, no data for this gamemode/modecrawl-confirmed
400invalid gamemode / mode / interval combinationinferred by symmetry with Leaderboards
404 (empty body)username does not existinferred by symmetry with Profile

Distributed under the MIT License.