Profile Stats
GET/profile/{username}/leaderboardPer-player rank and value across every stat for a gamemode/mode. Not Profile, despite the shared prefix.
Path and query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
username | string | required path | case-insensitive |
type | string | required query | gamemode id |
mode | string | recommended query | not crawled without this param |
interval | string | optional query | same yearly restriction as Leaderboards |
Response 200
key quirk
Object keyed by the stat's display name, not the raw stat key used by Leaderboards.
| Field | Type | Notes |
|---|---|---|
<displayName> | object | key is e.g. "Bow kills", not BOW_KILLS. See Gamemode Catalog for the raw to display mapping. |
<displayName>.metadata.total | number | players tracked for this stat |
<displayName>.entries | Entry[] | exactly one entry, this player's own rank |
<displayName>.entries[].place | number | 1-indexed absolute rank |
<displayName>.entries[].value | string | numeric string |
<displayName>.entries[].id | string | player 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 ContentRequest forms
text
GET /profile/resuns/leaderboard?type=bedwars&interval=total&mode=ALL_MODESbash
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
| Status | Condition | Verified |
|---|---|---|
204 (empty body) | valid request, no data for this gamemode/mode | crawl-confirmed |
400 | invalid gamemode / mode / interval combination | inferred by symmetry with Leaderboards |
404 (empty body) | username does not exist | inferred by symmetry with Profile |