The Hive (Bedrock)

Look up The Hive (Bedrock) game data through its keyless public API: player search and activity, all-time, monthly, and season stats and leaderboards for every game, per-game maps and leveling metadata, server-wide player counts, the Treasure Wars rewards leaderboard, and the hub title and costume catalogues. No account or API key required.

Actions

Action	What it does
Get a player's hub profile	Get a player's main hub profile: rank, first-played date, login streak, and hub title and avatar counts.
Get a player's monthly stats	Get one player's monthly stats and rank for a game: the current month by default, or a specific month if you pick one.
Get a player's season stats	Get one player's stats and rank for a specific numbered season of a game (for games that run seasons, such as BedWars).
Get a player's stats for all games	Get one player's all-time stats across every game at once, keyed by game code, plus their main hub profile.
Get a player's stats for one game	Get one player's all-time stats for a single game: games played, victories, kills, and the game's own metrics.
Get all-time leaderboard	Get a game's all-time leaderboard: the top 100 players, ranked best first, each with their rank, username, and headline stats.
Get available months	List every month that has a stored monthly leaderboard for a game, so you know which months 'Get monthly leaderboard' can return.
Get costume	Get one hub costume by name (or id): its display text and how it is unlocked.
Get game maps	Get the maps in rotation for a game, each with its name, season, team variant, and preview image URL.
Get game metadata	Get a game's leveling metadata: its full name, max level, whether it supports prestige, the XP-to-level curve, and level unlocks.
Get global statistics	Get server-wide unique-player counts: the total across The Hive and a breakdown per game.
Get monthly leaderboard	Get a game's monthly leaderboard: the top 100 for the current month by default, or a specific month if you pick one.
Get player activity	Get a player's recent round-by-round activity: the game played, whether they won, and the stat changes from each round, newest first.
Get season leaderboard	Get a game's leaderboard for a specific numbered season, ranked best first.
Get title	Get one hub title by name (or id): its display text and how it is unlocked.
Get Treasure Wars rewards leaderboard	Get the special Treasure Wars rewards leaderboard, ranked by uncapped XP: the standings used for its seasonal rewards.
List costumes	List every hub costume in the catalogue, each with its id, display text, and how it is unlocked.
List titles	List every hub title in the catalogue, each with its id, display text, and how it is unlocked.
Search players	Search for players by a partial username.

Get a player's hub profile

Get a player's main hub profile: rank, first-played date, login streak, and hub title and avatar counts.

Inputs

PlayerplayertextRequired: A Hive player's username or UUID. Find a UUID with the 'Search players' action (the most reliable identifier), or reference one from a previous step.

Outputs

statsobject

Example output

{
  "stats": {
    "main": {
      "UUID": "107c45ba-298c-3b71-9f68-764b98364fe5",
      "avatar_count": 4,
      "first_played": 1722457737,
      "hub_title_count": 9,
      "longest_daily_login_streak": 4,
      "rank": "REGULAR",
      "username": "technicstorm98",
      "username_cc": "TechnicStorm98",
      "xuid": 2535444102782820
    }
  }
}

Get a player's monthly stats

Get one player's monthly stats and rank for a game: the current month by default, or a specific month if you pick one.

Inputs

GamegametextRequired: The Hive game to look up. Pick one from the list.One of: wars (Treasure Wars), bed (BedWars), sky (SkyWars), murder (Murder Mystery), hide (Hide and Seek), sg (Survival Games), dr (DeathRun), ctf (Capture the Flag), drop (Block Drop), ground (Ground Wars), and 4 more.
PlayerplayertextRequired: A Hive player's username or UUID. Find a UUID with the 'Search players' action (the most reliable identifier), or reference one from a previous step.
Monthmonthdate: Pick any day in the month you want. Leave blank for the current month.

Outputs

statsobject

Example output

{
  "stats": {
    "beds_destroyed": 1697,
    "deaths": 2207,
    "final_kills": 4320,
    "human_index": 1,
    "index": 0,
    "kills": 6018,
    "played": 2203,
    "username": "outofluzkwho",
    "victories": 2042
  }
}

Get a player's season stats

Get one player's stats and rank for a specific numbered season of a game (for games that run seasons, such as BedWars).

Inputs

GamegametextRequired: The Hive game to look up. Pick one from the list.One of: wars (Treasure Wars), bed (BedWars), sky (SkyWars), murder (Murder Mystery), hide (Hide and Seek), sg (Survival Games), dr (DeathRun), ctf (Capture the Flag), drop (Block Drop), ground (Ground Wars), and 4 more.
PlayerplayertextRequired: A Hive player's username or UUID. Find a UUID with the 'Search players' action (the most reliable identifier), or reference one from a previous step.
SeasonseasonnumberRequired: The season number to look up (1 or greater). Not every game runs seasons.At least 1.

Outputs

statsobject

Example output

{
  "stats": {
    "UUID": "0a206c29-f84c-35dd-ba1d-8da18f7cdf0b",
    "beds_destroyed": 13900,
    "deaths": 12052,
    "final_kills": 27511,
    "human_index": 1,
    "index": 0,
    "kills": 36499,
    "played": 14105,
    "prestige": 0,
    "username": "NullKing11",
    "victories": 14000,
    "xp": 138750
  }
}

Get a player's stats for all games

Get one player's all-time stats across every game at once, keyed by game code, plus their main hub profile.

Inputs

PlayerplayertextRequired: A Hive player's username or UUID. Find a UUID with the 'Search players' action (the most reliable identifier), or reference one from a previous step.

Outputs

statsobject

Example output

{
  "stats": {
    "bed": {
      "UUID": "107c45ba-298c-3b71-9f68-764b98364fe5",
      "beds_destroyed": 9,
      "deaths": 14,
      "final_kills": 11,
      "first_played": 1738107889,
      "kills": 18,
      "played": 25,
      "prestige": 0,
      "victories": 14,
      "xp": 4487
    },
    "main": {
      "UUID": "107c45ba-298c-3b71-9f68-764b98364fe5",
      "avatar_count": 4,
      "first_played": 1722457737,
      "hub_title_count": 9,
      "longest_daily_login_streak": 4,
      "rank": "REGULAR",
      "username": "technicstorm98",
      "username_cc": "TechnicStorm98",
      "xuid": 2535444102782820
    }
  }
}

Get a player's stats for one game

Get one player's all-time stats for a single game: games played, victories, kills, and the game's own metrics. An empty result means the player has no recorded stats for that game.

Inputs

GamegametextRequired: The Hive game to look up. Pick one from the list.One of: wars (Treasure Wars), bed (BedWars), sky (SkyWars), murder (Murder Mystery), hide (Hide and Seek), sg (Survival Games), dr (DeathRun), ctf (Capture the Flag), drop (Block Drop), ground (Ground Wars), and 4 more.
PlayerplayertextRequired: A Hive player's username or UUID. Find a UUID with the 'Search players' action (the most reliable identifier), or reference one from a previous step.

Outputs

statsobject

Example output

{
  "stats": {
    "UUID": "0a206c29-f84c-35dd-ba1d-8da18f7cdf0b",
    "deaths": 72946,
    "final_kills": 120358,
    "first_played": 1543246003,
    "kills": 177221,
    "played": 85740,
    "prestige": 5,
    "treasure_destroyed": 198539,
    "victories": 77777,
    "xp": 566126
  }
}

Get all-time leaderboard

Get a game's all-time leaderboard: the top 100 players, ranked best first, each with their rank, username, and headline stats.

Inputs

GamegametextRequired: The Hive game to look up. Pick one from the list.One of: wars (Treasure Wars), bed (BedWars), sky (SkyWars), murder (Murder Mystery), hide (Hide and Seek), sg (Survival Games), dr (DeathRun), ctf (Capture the Flag), drop (Block Drop), ground (Ground Wars), and 4 more.

Outputs

leaderboardlist

Example output

{
  "leaderboard": [
    {
      "UUID": "0a206c29-f84c-35dd-ba1d-8da18f7cdf0b",
      "deaths": 72946,
      "final_kills": 120358,
      "human_index": 1,
      "index": 0,
      "kills": 177221,
      "played": 85740,
      "prestige": 0,
      "treasure_destroyed": 198539,
      "username": "NullKing11",
      "victories": 77777,
      "xp": 566126
    }
  ]
}

Get available months

List every month that has a stored monthly leaderboard for a game, so you know which months 'Get monthly leaderboard' can return.

Inputs

GamegametextRequired: The Hive game to look up. Pick one from the list.One of: wars (Treasure Wars), bed (BedWars), sky (SkyWars), murder (Murder Mystery), hide (Hide and Seek), sg (Survival Games), dr (DeathRun), ctf (Capture the Flag), drop (Block Drop), ground (Ground Wars), and 4 more.

Outputs

monthslist

Example output

{
  "months": [
    {
      "month": "august",
      "month_number": 8,
      "resource": "/v0/game/monthly/bed/2026/8",
      "year": "2026"
    }
  ]
}

Get costume

Get one hub costume by name (or id): its display text and how it is unlocked.

Inputs

Costumecostume_idtextRequired: Pick a costume, or reference a costume id from a previous step.

Outputs

costumeobject

Example output

{
  "costume": {
    "UUID": "36149e95-3dfb-4208-8ea8-69784475914b",
    "display": "Black Cat",
    "unlock_data": {
      "active": false,
      "metadata": {
        "description": "Awarded for completing the 2018 Halloween Hub Ghost Hunt",
        "lastAvailable": "2018-10-31",
        "originalUnlockType": "SPECIAL_EVENT"
      },
      "type": "LEGACY"
    }
  }
}

Get game maps

Get the maps in rotation for a game, each with its name, season, team variant, and preview image URL.

Inputs

GamegametextRequired: The Hive game to look up. Pick one from the list.One of: wars (Treasure Wars), bed (BedWars), sky (SkyWars), murder (Murder Mystery), hide (Hide and Seek), sg (Survival Games), dr (DeathRun), ctf (Capture the Flag), drop (Block Drop), ground (Ground Wars), and 4 more.

Outputs

mapslist

Example output

{
  "maps": [
    {
      "image": "https://cdn.playhive.com/maps/tw_duo_ablaze.jpg",
      "name": "Ablaze",
      "season": "NO_SEASON",
      "variant": "DUOS"
    }
  ]
}

Get game metadata

Get a game's leveling metadata: its full name, max level, whether it supports prestige, the XP-to-level curve, and level unlocks.

Inputs

GamegametextRequired: The Hive game to look up. Pick one from the list.One of: wars (Treasure Wars), bed (BedWars), sky (SkyWars), murder (Murder Mystery), hide (Hide and Seek), sg (Survival Games), dr (DeathRun), ctf (Capture the Flag), drop (Block Drop), ground (Ground Wars), and 4 more.

Outputs

metadataobject

Example output

{
  "metadata": {
    "allowPrestiging": true,
    "experienceToLevel": {
      "0": 0,
      "150": 1,
      "450": 2,
      "900": 3
    },
    "levelUnlocks": {
      "1": [
        {
          "global": false,
          "icon": "https://cdn.playhive.com/icons/locker/wars/bridgebuilders/turtle.png",
          "name": "Default Turtle",
          "type": "Auto-Bridger"
        }
      ]
    },
    "maxLevel": 100,
    "maxPrestige": 5,
    "name": "TreasureWars",
    "shortName": "WARS"
  }
}

Get global statistics

Get server-wide unique-player counts: the total across The Hive and a breakdown per game.

Inputs

None.

Outputs

statisticsobject

Example output

{
  "statistics": {
    "unique_players": {
      "bed": 34696914,
      "bridge": 14421113,
      "build": 44256603,
      "ctf": 15100868,
      "dr": 45051183,
      "drop": 13608480,
      "global": 130441222,
      "grav": 11038336,
      "ground": 10029900,
      "hide": 56700204,
      "main": 130441222,
      "murder": 46836062,
      "party": 10400363,
      "sg": 36422761,
      "sky": 55329132,
      "wars": 31140145
    }
  }
}

Get monthly leaderboard

Get a game's monthly leaderboard: the top 100 for the current month by default, or a specific month if you pick one.

Inputs

GamegametextRequired: The Hive game to look up. Pick one from the list.One of: wars (Treasure Wars), bed (BedWars), sky (SkyWars), murder (Murder Mystery), hide (Hide and Seek), sg (Survival Games), dr (DeathRun), ctf (Capture the Flag), drop (Block Drop), ground (Ground Wars), and 4 more.
Monthmonthdate: Pick any day in the month you want. Leave blank for the current month.

Outputs

leaderboardlist

Example output

{
  "leaderboard": [
    {
      "UUID": "8682a9e7-c767-31f4-bfc8-8112e1d8202c",
      "beds_destroyed": 1697,
      "deaths": 2207,
      "final_kills": 4320,
      "human_index": 1,
      "index": 0,
      "kills": 6018,
      "played": 2203,
      "prestige": 0,
      "username": "outofluzkwho",
      "victories": 2042
    }
  ]
}

Get player activity

Get a player's recent round-by-round activity: the game played, whether they won, and the stat changes from each round, newest first.

Inputs

PlayerplayertextRequired: A Hive player's username or UUID. Find a UUID with the 'Search players' action (the most reliable identifier), or reference one from a previous step.

Outputs

activitylist

Example output

{
  "activity": [
    {
      "changeset": {
        "beds_destroyed": 1,
        "final_kills": 2,
        "kills": 2,
        "played": 1,
        "victories": 1
      },
      "game": "bed",
      "time": 1786665573,
      "type": "ROUND_PLAYED",
      "victory": true
    }
  ]
}

Get season leaderboard

Get a game's leaderboard for a specific numbered season, ranked best first. Only games that run seasons (such as BedWars) have these. Optionally cap how many entries to return and page through them.

Inputs

GamegametextRequired: The Hive game to look up. Pick one from the list.One of: wars (Treasure Wars), bed (BedWars), sky (SkyWars), murder (Murder Mystery), hide (Hide and Seek), sg (Survival Games), dr (DeathRun), ctf (Capture the Flag), drop (Block Drop), ground (Ground Wars), and 4 more.
SeasonseasonnumberRequired: The season number to look up (1 or greater). Not every game runs seasons.At least 1.
Max entriesamountnumber: How many ranked entries to return. Leave blank for the endpoint's default page.At least 1.
Skipskipnumber: How many top entries to skip before returning results, for paging through a leaderboard. Defaults to 0.At least 0.

Outputs

leaderboardlist

Example output

{
  "leaderboard": [
    {
      "UUID": "0a206c29-f84c-35dd-ba1d-8da18f7cdf0b",
      "beds_destroyed": 13900,
      "deaths": 12052,
      "final_kills": 27511,
      "human_index": 1,
      "index": 0,
      "kills": 36499,
      "played": 14105,
      "prestige": 0,
      "username": "NullKing11",
      "victories": 14000,
      "xp": 138750
    }
  ]
}

Get title

Get one hub title by name (or id): its display text and how it is unlocked.

Inputs

Titletitle_idtextRequired: Pick a title, or reference a title id from a previous step.

Outputs

titleobject

Example output

{
  "title": {
    "UUID": "12cfe272-0d26-4eac-aaff-d244218b5567",
    "display": "&aThe Snail",
    "unlock_data": {
      "active": true,
      "metadata": {
        "game": "dr",
        "level": 3
      },
      "type": "GAME_LEVEL"
    }
  }
}

Get Treasure Wars rewards leaderboard

Get the special Treasure Wars rewards leaderboard, ranked by uncapped XP: the standings used for its seasonal rewards. Optionally cap how many entries to return and page through them.

Inputs

Max entriesamountnumber: How many ranked entries to return. Leave blank for the endpoint's default page.At least 1.
Skipskipnumber: How many top entries to skip before returning results, for paging through a leaderboard. Defaults to 0.At least 0.

Outputs

leaderboardlist

Example output

{
  "leaderboard": [
    {
      "UUID": "0a206c29-f84c-35dd-ba1d-8da18f7cdf0b",
      "deaths": 27505,
      "final_kills": 55199,
      "human_index": 1,
      "index": 0,
      "kills": 70757,
      "played": 48203,
      "prestige": 0,
      "treasure_destroyed": 113094,
      "uncapped_xp": 8644120,
      "username": "NullKing11",
      "victories": 47297,
      "xp": 0
    }
  ]
}

List costumes

List every hub costume in the catalogue, each with its id, display text, and how it is unlocked.

Inputs

None.

Outputs

costumeslist

Example output

{
  "costumes": [
    {
      "UUID": "36149e95-3dfb-4208-8ea8-69784475914b",
      "display": "Black Cat",
      "unlock_data": {
        "active": false,
        "metadata": {
          "description": "Awarded for completing the 2018 Halloween Hub Ghost Hunt",
          "lastAvailable": "2018-10-31",
          "originalUnlockType": "SPECIAL_EVENT"
        },
        "type": "LEGACY"
      }
    }
  ]
}

List titles

List every hub title in the catalogue, each with its id, display text, and how it is unlocked.

Inputs

None.

Outputs

titleslist

Example output

{
  "titles": [
    {
      "UUID": "12cfe272-0d26-4eac-aaff-d244218b5567",
      "display": "&aThe Snail",
      "unlock_data": {
        "active": true,
        "metadata": {
          "game": "dr",
          "level": 3
        },
        "type": "GAME_LEVEL"
      }
    }
  ]
}

Search players

Search for players by a partial username. Returns matching players with their UUID and username. Use a UUID to look up a specific player's stats or activity.

Inputs

Username searchpartialtextRequired: Part or all of a player's username, e.g. 'techni'.

Outputs

playerslist

Example output

{
  "players": [
    {
      "UUID": "107c45ba-298c-3b71-9f68-764b98364fe5",
      "username": "technicstorm98",
      "username_cc": null
    }
  ]
}

ActionsCopy Anchor Link

Get a player's hub profileCopy Anchor Link

Inputs

Outputs

Get a player's monthly statsCopy Anchor Link

Inputs

Outputs

Get a player's season statsCopy Anchor Link

Inputs

Outputs

Get a player's stats for all gamesCopy Anchor Link

Inputs

Outputs

Get a player's stats for one gameCopy Anchor Link

Inputs

Outputs

Get all-time leaderboardCopy Anchor Link

Inputs

Outputs

Get available monthsCopy Anchor Link

Inputs

Outputs

Get costumeCopy Anchor Link

Inputs

Outputs

Get game mapsCopy Anchor Link

Inputs

Outputs

Get game metadataCopy Anchor Link

Inputs

Outputs

Get global statisticsCopy Anchor Link

Inputs

Outputs

Get monthly leaderboardCopy Anchor Link

Inputs

Outputs

Get player activityCopy Anchor Link

Inputs

Outputs

Get season leaderboardCopy Anchor Link

Inputs

Outputs

Get titleCopy Anchor Link

Inputs

Outputs

Get Treasure Wars rewards leaderboardCopy Anchor Link

Inputs

Outputs

List costumesCopy Anchor Link

Inputs

Outputs

List titlesCopy Anchor Link

Inputs

Outputs

Search playersCopy Anchor Link

Inputs

Outputs

On this page

Actions

Get a player's hub profile

Get a player's monthly stats

Get a player's season stats

Get a player's stats for all games

Get a player's stats for one game

Get all-time leaderboard

Get available months

Get costume

Get game maps

Get game metadata

Get global statistics

Get monthly leaderboard

Get player activity

Get season leaderboard

Get title

Get Treasure Wars rewards leaderboard

List costumes

List titles

Search players