Worlds

Documentation of how to use our v2 worlds API.

All worlds of Tibia

This API helps you to get a list of all worlds and details like players online, location and PvP Type.

No parameters can be set on this request.

Example URL:

https://api.tibiadata.com/v2/worlds.json

Example JSON data:

{
  "worlds": {
    "online": 13245,
    "allworlds": [
      {
        "name": "Amera",
        "online": 182,
        "location": "North America",
        "worldtype": "Open PvP",
        "additional": ""
      }, {
        "name": "Antica",
        "online": 560,
        "location": "Europe",
        "worldtype": "Open PvP",
        "additional": ""
      },
      ...
    ]
  },
  "information": {
    "api_version": 2,
    "execution_time": 0.0005,
    "last_updated": "2017-12-15 08:00:00",
    "timestamp": "2017-12-15 08:00:02"
  }
}

One specific world of Tibia

This API helps you to get information of the world and a list of all players online right now.

This GET request requires the field name to be set in the URL.

Example URL:

https://api.tibiadata.com/v2/world/Antica.json
https://api.tibiadata.com/v2/world/Premia.json
https://api.tibiadata.com/v2/world/Vunira.json

Example JSON data:

{
  "world": {
    "world_information": {
      "name": "Antica",
      "players_online": 547,
      "online_record": {
        "players": 1052,
        "date": {
          "date": "2017-12-03 19:10:30.000000",
          "timezone_type": 2,
          "timezone": "CET"
        }
      },
      "creation_date": "1997-01",
      "location": "Europe",
      "pvp_type": "Open PvP",
      "world_quest_titles": [
        "Bewitched",
        "The Colours of Magic",
        "Rise of Devovorga",
        "The Lightbearer"
      ],
      "battleye_status": "Protected by BattlEye since August 29, 2017."
    },
    "players_online": [
      {
        "name": "Aelith of Aquitaine",
        "level": 82,
        "vocation": "Elder Druid"
      }, {
        "name": "Agent Bruno",
        "level": 55,
        "vocation": "Master Sorcerer"
      },
      ...
    ]
  },
  "information": {
    "api_version": 2,
    "execution_time": 0.0012,
    "last_updated": "2017-12-15 08:00:00",
    "timestamp": "2017-12-15 08:00:02"
  }
}