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.

Actions

Action	What it does
Get character	Look up a character by name: vocation, level, world, guild, recent deaths, achievements, and the account's other visible characters.
Get creature	Get one creature's full library entry: its behaviour, hitpoints, experience, elemental resistances, and loot.
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.
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.
Get house	Get one house or guildhall on a world by its ID: size, rent, beds, and its current rental or auction status.
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.
Get news archive	List the full news archive.
Get news entry	Get one news entry's full content by its ID.
Get spell	Get one spell's full details: its formula, the vocations that can learn it, cooldowns, costs, and where to buy it.
Get world	Get one world's details: online player count and record, location, PvP type, BattlEye status, and who is currently online.
List boostable bosses	List every boostable boss, plus today's boosted boss (which grants extra loot and rewards when defeated).
List creatures	List every creature in the Tibia library, plus today's boosted creature.
List fansites	List the officially promoted and supported Tibia fansites, each with its homepage, languages, content type, and social links.
List guilds	List every active and forming guild on a world, each with its logo and description.
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.
List latest news	List the news headlines from the last 90 days (official news, articles, and tickers), newest first.
List news tickers	List the short news tickers from the last 90 days (brief status notes and announcements), newest first.
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.
List worlds	List every game world with its player count, location, PvP type, and BattlEye status, plus the all-time online record.

Get character

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

Inputs

Character namenametextRequired: The exact character name, e.g. 'Bobeek'.

Outputs

characterobject

Example output

{
  "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

CreatureracetextRequired: Pick a creature, or reference a creature race id from a previous step.

Outputs

creatureobject

Example output

{
  "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 namenametextRequired: The exact guild name, e.g. 'Rising Rebels'.

Outputs

guildobject

Example output

{
  "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

WorldworldtextRequired: Pick a world, or reference a world name from a previous step.
LeaderboardcategorytextRequired: 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.
Vocationvocationtext: Limit the ranking to one vocation, or 'All vocations'.One of: all (All vocations), knights, paladins, sorcerers, druids, monks. Default: all.
Page numberpagenumber: Which page of ranks to return (50 per page).At least 1. Default: 1.

Outputs

highscoresobject

Example output

{
  "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

WorldworldtextRequired: Pick a world, or reference a world name from a previous step.
House IDhouse_idnumberRequired: The numeric house ID, as returned by 'List houses'.At least 1.

Outputs

houseobject

Example output

{
  "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

WorldworldtextRequired: Pick a world, or reference a world name from a previous step.

Outputs

killStatisticsobject

Example output

{
  "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

Daysdaysnumber: How many days back to include. Leave blank for the full 90-day archive.At least 1.

Outputs

newslist

Example output

{
  "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 entrynews_idtextRequired: Pick a news entry, or reference a news ID from a previous step.

Outputs

newsobject

Example output

{
  "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

Spellspell_idtextRequired: Pick a spell, or reference a spell id from a previous step.

Outputs

spellobject

Example output

{
  "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

WorldnametextRequired: Pick a world, or reference a world name from a previous step.

Outputs

worldobject

Example output

{
  "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

boostableBossesobject

Example output

{
  "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

creaturesobject

Example output

{
  "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

fansitesobject

Example output

{
  "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

WorldworldtextRequired: Pick a world, or reference a world name from a previous step.

Outputs

guildsobject

Example output

{
  "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

WorldworldtextRequired: Pick a world, or reference a world name from a previous step.
TowntowntextRequired: The town whose houses to list.One of: Ab'Dendriel, Ankrahmun, Candia, Carlin, Darashia, Edron, Farmine, Gray Beach, Issavi, Kazordoon, and 9 more.

Outputs

housesobject

Example output

{
  "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

newslist

Example output

{
  "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

newsTickerslist

Example output

{
  "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

spellsobject

Example output

{
  "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

worldsobject

Example output

{
  "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": []
  }
}

ActionsCopy Anchor Link

Get characterCopy Anchor Link

Inputs

Outputs

Get creatureCopy Anchor Link

Inputs

Outputs

Get guildCopy Anchor Link

Inputs

Outputs

Get highscoresCopy Anchor Link

Inputs

Outputs

Get houseCopy Anchor Link

Inputs

Outputs

Get kill statisticsCopy Anchor Link

Inputs

Outputs

Get news archiveCopy Anchor Link

Inputs

Outputs

Get news entryCopy Anchor Link

Inputs

Outputs

Get spellCopy Anchor Link

Inputs

Outputs

Get worldCopy Anchor Link

Inputs

Outputs

List boostable bossesCopy Anchor Link

Inputs

Outputs

List creaturesCopy Anchor Link

Inputs

Outputs

List fansitesCopy Anchor Link

Inputs

Outputs

List guildsCopy Anchor Link

Inputs

Outputs

List housesCopy Anchor Link

Inputs

Outputs

List latest newsCopy Anchor Link

Inputs

Outputs

List news tickersCopy Anchor Link

Inputs

Outputs

List spellsCopy Anchor Link

Inputs

Outputs

List worldsCopy Anchor Link

Inputs

Outputs

On this page

Actions

Get character

Get creature

Get guild

Get highscores

Get house

Get kill statistics

Get news archive

Get news entry

Get spell

Get world

List boostable bosses

List creatures

List fansites

List guilds

List houses

List latest news

List news tickers

List spells

List worlds