# 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.

App · Gaming · 19 actions. Web page: https://docs.lodol.com/docs/integrations/the-hive

## Actions

### 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**

- Player (`player`, text, required): 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**

- `stats` (object)

**Example output**

```json
{
  "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**

- Game (`game`, text, required): 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.
- Player (`player`, text, required): 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.
- Month (`month`, date): Pick any day in the month you want. Leave blank for the current month.

**Outputs**

- `stats` (object)

**Example output**

```json
{
  "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**

- Game (`game`, text, required): 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.
- Player (`player`, text, required): 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.
- Season (`season`, number, required): The season number to look up (1 or greater). Not every game runs seasons. At least 1.

**Outputs**

- `stats` (object)

**Example output**

```json
{
  "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**

- Player (`player`, text, required): 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**

- `stats` (object)

**Example output**

```json
{
  "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**

- Game (`game`, text, required): 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.
- Player (`player`, text, required): 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**

- `stats` (object)

**Example output**

```json
{
  "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**

- Game (`game`, text, required): 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**

- `leaderboard` (list)

**Example output**

```json
{
  "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**

- Game (`game`, text, required): 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**

- `months` (list)

**Example output**

```json
{
  "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**

- Costume (`costume_id`, text, required): Pick a costume, or reference a costume id from a previous step.

**Outputs**

- `costume` (object)

**Example output**

```json
{
  "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**

- Game (`game`, text, required): 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**

- `maps` (list)

**Example output**

```json
{
  "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**

- Game (`game`, text, required): 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**

- `metadata` (object)

**Example output**

```json
{
  "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**

- `statistics` (object)

**Example output**

```json
{
  "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**

- Game (`game`, text, required): 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.
- Month (`month`, date): Pick any day in the month you want. Leave blank for the current month.

**Outputs**

- `leaderboard` (list)

**Example output**

```json
{
  "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**

- Player (`player`, text, required): 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**

- `activity` (list)

**Example output**

```json
{
  "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**

- Game (`game`, text, required): 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.
- Season (`season`, number, required): The season number to look up (1 or greater). Not every game runs seasons. At least 1.
- Max entries (`amount`, number): How many ranked entries to return. Leave blank for the endpoint's default page. At least 1.
- Skip (`skip`, number): How many top entries to skip before returning results, for paging through a leaderboard. Defaults to 0. At least 0.

**Outputs**

- `leaderboard` (list)

**Example output**

```json
{
  "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**

- Title (`title_id`, text, required): Pick a title, or reference a title id from a previous step.

**Outputs**

- `title` (object)

**Example output**

```json
{
  "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 entries (`amount`, number): How many ranked entries to return. Leave blank for the endpoint's default page. At least 1.
- Skip (`skip`, number): How many top entries to skip before returning results, for paging through a leaderboard. Defaults to 0. At least 0.

**Outputs**

- `leaderboard` (list)

**Example output**

```json
{
  "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**

- `costumes` (list)

**Example output**

```json
{
  "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**

- `titles` (list)

**Example output**

```json
{
  "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 search (`partial`, text, required): Part or all of a player's username, e.g. 'techni'.

**Outputs**

- `players` (list)

**Example output**

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