Tibia Dev API

Read-only REST APIs for two games, served as JSON: Tibia, built from TibiaWiki, and Huntera, a free browser MMORPG built on Tibia's content with numbers of its own. Both follow the same rules, so what you learn on one works on the other.

API	Base URL	Built from
Tibia	`https://api.tibia.dev/v1`	TibiaWiki: items, creatures, quests, NPCs, spells, houses, hunting places, worlds, everything the wiki documents
Huntera	`https://huntera.tibia.dev/v1`	The game's own client, and the community huntera-wiki

Every endpoint is a GET. There is no key to obtain, no account to create, and no request that writes.

curl https://api.tibia.dev/v1/items/gold-coin
curl https://huntera.tibia.dev/v1/spells/blood-rage

Looking things up

One row, several ways to name it: id, slug, title or key

Narrowing a listing

Filters, sorting, includes and pagination

Limits and errors

What the API answers when something is wrong

Huntera

Whose numbers you are reading, and how fresh they are

Tibia API Reference

85 endpoints, with every filter's accepted values

Huntera API Reference

25 endpoints over Huntera's twelve catalogues

What is in here

Tibia


Items	9,800: weapons, armour, furniture, runes, the gold coin everything is priced in
Creatures	2,193, bosses among them, with loot tables, resistances and bestiary grades
NPCs	1,245, and the 13,929 offers they buy and sell
Quests	370, with their rewards and the creatures that guard them
Spells	211 · Imbuements 72 · Hunting places 443 · Houses 1,090 · Worlds 292 · Books 1,226

Plus abilities, achievements, charms, cities, corpses, effects, familiars, game updates, keys, locations, map floors, missiles, mounts, outfits, raids, Rashid's whereabouts, streets, tiles, tournaments and the CipSoft staff list.

Huntera


Items	837, with Huntera's own weights, requirements, combat stats and NPC prices
Creatures	116: the 113 of its bestiary, and the three bosses behind its boss doors
Hunts	60, each with its difficulty tiers, the creatures a tier fields and the loot it drops
Spells	57 · Imbuements 69 · Mounts 142 · Outfits 75 · Prey groups 35
And	6 arenas · 6 training skills · 3 boss doors · 3 quests

The shape of a response

A single resource answers under data:

{
  "data": {
    "wiki_article_id": 2119,
    "client_id": 3031,
    "slug": "gold-coin",
    "name": "Gold Coin",
    "class": "Other Items",
    "categories": [
      { "slug": "valuables", "name": "Valuables", "slot": null, "wearable": false },
      { "slug": "currency",  "name": "Currency",  "slot": null, "wearable": false }
    ],
    "is_stackable": true,
    "weight": 0.01,
    "image_url": "https://api.tibia.dev/storage/images/item/gold-coin.gif"
  }
}

A listing answers with data as an array, plus links and meta carrying the page cursor and totals. Huntera answers the same way; its rows are named by a key instead of a wiki_article_id, and carry the fields described in Huntera.

The OpenAPI descriptions

Each API describes itself in OpenAPI 3.0.3, generated from the code on every deploy, so neither can drift from what the API actually does:

Point a client generator at either one:

npx @openapitools/openapi-generator-cli generate \
  -i https://api.tibia.dev/v1/openapi.yaml -g typescript-fetch -o ./src/tibia

Attribution

The Tibia data belongs to the TibiaWiki community, under CC BY-SA 3.0. Huntera's catalogue belongs to its developers, and is read from the game at huntera.com.br and from TroniPM's community huntera-wiki. Tibia is a trademark of CipSoft GmbH. This project is not affiliated with or endorsed by CipSoft or by Huntera.