# Tibia

> Access live Tibia game data through TibiaData's keyless public API: characters, worlds, guilds, highscores, houses, kill statistics, creatures, boostable bosses, spells, fansites, and news. No account or API key required.

App · Gaming · 19 actions. Web page: https://docs.lodol.com/docs/integrations/tibia

## Actions

### Get character

Look up a character by name: vocation, level, world, guild, recent deaths, achievements, and the account's other visible characters.

**Inputs**

- Character name (`name`, text, required): The exact character name, e.g. 'Bobeek'.

**Outputs**

- `character` (object)

**Example output**

```json
{
  "character": {
    "account_information": {
      "created": "2007-02-20T07:39:01Z",
      "loyalty_title": "Sage of Tibia"
    },
    "achievements": [
      {
        "grade": 3,
        "name": "Goldhunter",
        "secret": false
      }
    ],
    "character": {
      "account_status": "Premium Account",
      "achievement_points": 210,
      "guild": {
        "name": "Rising Rebels",
        "rank": "Leader"
      },
      "last_login": "2026-08-12T17:21:07Z",
      "level": 1041,
      "name": "Bobeek",
      "residence": "Thais",
      "sex": "male",
      "title": "None",
      "unlocked_titles": 12,
      "vocation": "Elite Knight",
      "world": "Antica"
    },
    "deaths": [
      {
        "assists": [],
        "killers": [
          {
            "name": "a demon",
            "player": false,
            "summon": "",
            "traded": false
          }
        ],
        "level": 1041,
        "reason": "Died at Level 1041 by a demon.",
        "time": "2026-08-07T14:50:29Z"
      }
    ],
    "other_characters": [
      {
        "deleted": false,
        "main": true,
        "name": "Bobeek",
        "status": "online",
        "traded": false,
        "world": "Antica"
      }
    ]
  }
}
```

### Get creature

Get one creature's full library entry: its behaviour, hitpoints, experience, elemental resistances, and loot.

**Inputs**

- Creature (`race`, text, required): Pick a creature, or reference a creature race id from a previous step.

**Outputs**

- `creature` (object)

**Example output**

```json
{
  "creature": {
    "be_paralysed": true,
    "be_summoned": false,
    "behaviour": "They flee at 15% health.",
    "description": "The rorcs are the creation of a power-hungry orc shaman.",
    "experience_points": 900,
    "hitpoints": 1200,
    "image_url": "https://static.tibia.com/images/library/rorc.gif",
    "immune": [],
    "loot_list": [
      "Gold Coin",
      "Rorc Feather"
    ],
    "name": "Rorcs",
    "race": "rorc",
    "weakness": [
      "ice"
    ]
  }
}
```

### Get guild

Look up a guild by name: its world, description, whether it is at war, and its full member roster with ranks and vocations.

**Inputs**

- Guild name (`name`, text, required): The exact guild name, e.g. 'Rising Rebels'.

**Outputs**

- `guild` (object)

**Example output**

```json
{
  "guild": {
    "active": true,
    "description": "A friendly hunting community.",
    "founded": "2019-05-27",
    "guildhalls": null,
    "in_war": false,
    "invited": [],
    "logo_url": "https://static.tibia.com/images/guildlogos/Rising_Rebels.gif",
    "members": [
      {
        "joined": "2019-05-27",
        "level": 1041,
        "name": "Bobeek",
        "rank": "Leader",
        "status": "online",
        "title": "",
        "vocation": "Elite Knight"
      }
    ],
    "members_invited": 0,
    "members_total": 30,
    "name": "Rising Rebels",
    "open_applications": true,
    "players_offline": 27,
    "players_online": 3,
    "world": "Antica"
  }
}
```

### Get highscores

Get a page of a world's highscores for a chosen leaderboard (experience, a skill, boss points, and more), optionally filtered to one vocation. Each page holds 50 ranks.

**Inputs**

- World (`world`, text, required): Pick a world, or reference a world name from a previous step.
- Leaderboard (`category`, text, required): Which highscore leaderboard to rank by. One of: `achievements`, `axefighting` (Axe Fighting), `charmpoints` (Charm Points), `clubfighting` (Club Fighting), `distancefighting` (Distance Fighting), `experience`, `fishing`, `fistfighting` (Fist Fighting), `goshnarstaint` (Goshnar's Taint), `loyaltypoints` (Loyalty Points), and 7 more.
- Vocation (`vocation`, text): Limit the ranking to one vocation, or 'All vocations'. One of: `all` (All vocations), `knights`, `paladins`, `sorcerers`, `druids`, `monks`. Default: `all`.
- Page number (`page`, number): Which page of ranks to return (50 per page). At least 1. Default: `1`.

**Outputs**

- `highscores` (object)

**Example output**

```json
{
  "highscores": {
    "category": "experience",
    "highscore_age": 32,
    "highscore_list": [
      {
        "level": 2194,
        "name": "Ranny Zolnierz Elder",
        "rank": 1,
        "value": 175613403258,
        "vocation": "Master Sorcerer",
        "world": "Antica"
      }
    ],
    "highscore_page": {
      "current_page": 1,
      "total_highscores": 1000,
      "total_pages": 20
    },
    "vocation": "all",
    "world": "Antica"
  }
}
```

### Get house

Get one house or guildhall on a world by its ID: size, rent, beds, and its current rental or auction status. Get the ID from 'List houses'.

**Inputs**

- World (`world`, text, required): Pick a world, or reference a world name from a previous step.
- House ID (`house_id`, number, required): The numeric house ID, as returned by 'List houses'. At least 1.

**Outputs**

- `house` (object)

**Example output**

```json
{
  "house": {
    "beds": 1,
    "houseid": 10301,
    "img": "https://static.tibia.com/images/houses/house_10301.png",
    "name": "Alai Flats, Flat 01",
    "rent": 50000,
    "size": 17,
    "status": {
      "auction": {
        "auction_end": "",
        "auction_ongoing": false,
        "current_bid": 0,
        "current_bidder": ""
      },
      "is_auctioned": false,
      "is_moving": false,
      "is_rented": true,
      "is_transfering": false,
      "original": "The house has been rented by Carrbonara.",
      "rental": {
        "moving_date": "",
        "owner": "Carrbonara",
        "owner_sex": "female",
        "paid_until": "2026-08-25T09:03:52Z",
        "transfer_accept": false,
        "transfer_price": 0,
        "transfer_receiver": ""
      }
    },
    "town": "Thais",
    "type": "house",
    "world": "Antica"
  }
}
```

### Get kill statistics

Get a world's kill statistics: per-race counts of players and creatures killed over the last day and week, plus the totals.

**Inputs**

- World (`world`, text, required): Pick a world, or reference a world name from a previous step.

**Outputs**

- `killStatistics` (object)

**Example output**

```json
{
  "killStatistics": {
    "entries": [
      {
        "last_day_killed": 1204,
        "last_day_players_killed": 3,
        "last_week_killed": 8921,
        "last_week_players_killed": 25,
        "race": "demons"
      }
    ],
    "total": {
      "last_day_killed": 2399039,
      "last_day_players_killed": 844,
      "last_week_killed": 23691023,
      "last_week_players_killed": 5647
    },
    "world": "Antica"
  }
}
```

### Get news archive

List the full news archive. Leave the window blank for the last 90 days, or set a number of days to narrow it.

**Inputs**

- Days (`days`, number): How many days back to include. Leave blank for the full 90-day archive. At least 1.

**Outputs**

- `news` (list)

**Example output**

```json
{
  "news": [
    {
      "category": "community",
      "date": "2026-08-12",
      "id": 8928,
      "news": "A double XP/skill week has been scheduled.",
      "type": "ticker",
      "url": "https://www.tibia.com/news/?subtopic=newsarchive&id=8928",
      "url_api": "https://api.tibiadata.com/v4/news/id/8928"
    }
  ]
}
```

### Get news entry

Get one news entry's full content by its ID. Pick a recent entry by headline, or reference an ID from a news-list step.

**Inputs**

- News entry (`news_id`, text, required): Pick a news entry, or reference a news ID from a previous step.

**Outputs**

- `news` (object)

**Example output**

```json
{
  "news": {
    "category": "development",
    "content": "Dear Tibians!\nWith today's server save, a number of fixes and changes have been implemented.",
    "date": "2026-08-11",
    "id": 8925,
    "title": "Fixes and Changes",
    "url": "https://www.tibia.com/news/?subtopic=newsarchive&id=8925"
  }
}
```

### Get spell

Get one spell's full details: its formula, the vocations that can learn it, cooldowns, costs, and where to buy it.

**Inputs**

- Spell (`spell_id`, text, required): Pick a spell, or reference a spell id from a previous step.

**Outputs**

- `spell` (object)

**Example output**

```json
{
  "spell": {
    "description": "",
    "has_rune_information": false,
    "has_spell_information": true,
    "image_url": "https://static.tibia.com/images/library/annihilation.png",
    "name": "Annihilation",
    "spell_id": "annihilation",
    "spell_information": {
      "amount": 0,
      "city": null,
      "cooldown_alone": 30,
      "cooldown_group": 2,
      "damage_type": "var.",
      "formula": "exori gran ico",
      "group_attack": true,
      "level": 110,
      "mana": 300,
      "premium_only": true,
      "price": 0,
      "soul_points": 0,
      "type_instant": true,
      "type_rune": false,
      "vocation": [
        "Knight"
      ]
    }
  }
}
```

### Get world

Get one world's details: online player count and record, location, PvP type, BattlEye status, and who is currently online.

**Inputs**

- World (`name`, text, required): Pick a world, or reference a world name from a previous step.

**Outputs**

- `world` (object)

**Example output**

```json
{
  "world": {
    "battleye_date": "2017-08-29",
    "battleye_protected": true,
    "creation_date": "1997-01",
    "game_world_type": "regular",
    "location": "Europe",
    "name": "Antica",
    "online_players": [
      {
        "level": 309,
        "name": "Abraos Roibb",
        "vocation": "Royal Paladin"
      }
    ],
    "players_online": 323,
    "premium_only": false,
    "pvp_type": "Open PvP",
    "record_date": "2026-05-01T14:19:31Z",
    "record_players": 1152,
    "status": "online",
    "tournament_world_type": "",
    "transfer_type": "regular",
    "world_quest_titles": [
      "Rise of Devovorga"
    ]
  }
}
```

### List boostable bosses

List every boostable boss, plus today's boosted boss (which grants extra loot and rewards when defeated).

**Inputs**: None.

**Outputs**

- `boostableBosses` (object)

**Example output**

```json
{
  "boostableBosses": {
    "boostable_boss_list": [
      {
        "featured": false,
        "image_url": "https://static.tibia.com/images/library/abyssador.gif",
        "name": "Abyssador"
      }
    ],
    "boosted": {
      "featured": true,
      "image_url": "https://static.tibia.com/images/global/header/monsters/souldespoiler.gif",
      "name": "The Souldespoiler"
    }
  }
}
```

### List creatures

List every creature in the Tibia library, plus today's boosted creature. Use 'Get creature' for one creature's full details.

**Inputs**: None.

**Outputs**

- `creatures` (object)

**Example output**

```json
{
  "creatures": {
    "boosted": {
      "featured": true,
      "image_url": "https://static.tibia.com/images/global/header/monsters/rorc.gif",
      "name": "Rorc",
      "race": "rorc"
    },
    "creature_list": [
      {
        "featured": false,
        "image_url": "https://static.tibia.com/images/library/demon.gif",
        "name": "Demons",
        "race": "demon"
      }
    ]
  }
}
```

### List fansites

List the officially promoted and supported Tibia fansites, each with its homepage, languages, content type, and social links.

**Inputs**: None.

**Outputs**

- `fansites` (object)

**Example output**

```json
{
  "fansites": {
    "promoted": [
      {
        "contact": "Tobias",
        "content_type": {
          "screenshots": false,
          "statistics": true,
          "texts": false,
          "tools": true
        },
        "fansite_item": true,
        "fansite_item_url": "https://static.tibia.com/images/fansiteitems/x.png",
        "homepage": "https://tibiadata.com",
        "languages": [
          "English"
        ],
        "logo_url": "https://static.tibia.com/images/community/tibiadata.png",
        "name": "TibiaData.com",
        "social_media": {
          "discord": true,
          "x": true
        },
        "specials": [
          "API"
        ]
      }
    ],
    "supported": []
  }
}
```

### List guilds

List every active and forming guild on a world, each with its logo and description.

**Inputs**

- World (`world`, text, required): Pick a world, or reference a world name from a previous step.

**Outputs**

- `guilds` (object)

**Example output**

```json
{
  "guilds": {
    "active": [
      {
        "description": "A friendly hunting community.",
        "logo_url": "https://static.tibia.com/images/guildlogos/Rising_Rebels.gif",
        "name": "Rising Rebels"
      }
    ],
    "formation": [],
    "world": "Antica"
  }
}
```

### List houses

List every house and guildhall in a town on a world, with each one's size, rent, and whether it is rented or up for auction.

**Inputs**

- World (`world`, text, required): Pick a world, or reference a world name from a previous step.
- Town (`town`, text, required): The town whose houses to list. One of: `Ab'Dendriel`, `Ankrahmun`, `Candia`, `Carlin`, `Darashia`, `Edron`, `Farmine`, `Gray Beach`, `Issavi`, `Kazordoon`, and 9 more.

**Outputs**

- `houses` (object)

**Example output**

```json
{
  "houses": {
    "guildhall_list": [],
    "house_list": [
      {
        "auction": {
          "current_bid": 0,
          "finished": false,
          "time_left": ""
        },
        "auctioned": false,
        "house_id": 10301,
        "name": "Alai Flats, Flat 01",
        "rent": 50000,
        "rented": true,
        "size": 17
      }
    ],
    "town": "Thais",
    "world": "Antica"
  }
}
```

### List latest news

List the news headlines from the last 90 days (official news, articles, and tickers), newest first.

**Inputs**: None.

**Outputs**

- `news` (list)

**Example output**

```json
{
  "news": [
    {
      "category": "development",
      "date": "2026-08-11",
      "id": 8925,
      "news": "Fixes and Changes",
      "type": "news",
      "url": "https://www.tibia.com/news/?subtopic=newsarchive&id=8925",
      "url_api": "https://api.tibiadata.com/v4/news/id/8925"
    }
  ]
}
```

### List news tickers

List the short news tickers from the last 90 days (brief status notes and announcements), newest first.

**Inputs**: None.

**Outputs**

- `newsTickers` (list)

**Example output**

```json
{
  "newsTickers": [
    {
      "category": "community",
      "date": "2026-08-12",
      "id": 8928,
      "news": "As compensation for the recent reset of Premia, a double XP/skill week has been scheduled.",
      "type": "ticker",
      "url": "https://www.tibia.com/news/?subtopic=newsarchive&id=8928",
      "url_api": "https://api.tibiadata.com/v4/news/id/8928"
    }
  ]
}
```

### List spells

List every spell in the spell library, each with its formula, level and mana cost, and whether it is instant or a rune.

**Inputs**: None.

**Outputs**

- `spells` (object)

**Example output**

```json
{
  "spells": {
    "spell_list": [
      {
        "formula": "exori gran ico",
        "group_attack": true,
        "group_healing": false,
        "group_support": false,
        "level": 110,
        "mana": 300,
        "name": "Annihilation",
        "premium_only": true,
        "price": 0,
        "spell_id": "annihilation",
        "type_instant": true,
        "type_rune": false
      }
    ],
    "spells_filter": "all"
  }
}
```

### List worlds

List every game world with its player count, location, PvP type, and BattlEye status, plus the all-time online record.

**Inputs**: None.

**Outputs**

- `worlds` (object)

**Example output**

```json
{
  "worlds": {
    "players_online": 6903,
    "record_date": "2007-11-28T18:26:00Z",
    "record_players": 64028,
    "regular_worlds": [
      {
        "battleye_date": "2017-08-29",
        "battleye_protected": true,
        "game_world_type": "regular",
        "location": "Europe",
        "name": "Antica",
        "players_online": 319,
        "premium_only": false,
        "pvp_type": "Open PvP",
        "status": "online",
        "tournament_world_type": "",
        "transfer_type": "regular"
      }
    ],
    "tournament_worlds": []
  }
}
```