Highscores

Documentation of how to use our v1 highscores API.

TibiaData API v3 has been released and it’s not recommended to use v1 anymore.
Go to the documentation page to find a newer version.


Get various highscores of worlds

This API helps you to get a list of highscores on a certain world and on which type.

GET

GET

GET

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

This GET request has optional fields type and page to be set in the URL.

Default value of type is experience.
You can use following fields instead: experience, magic, shielding, distance, sword, club, axe, fist, fishing, achievements and loyalty.

Default value of pages is 0 (accepted from 0 to 11).
Each page shows 25 records, so page 1 covers 26-30, page 2 covers 31-45 and so on.

Example URL:

https://api.tibiadata.com/v1/highscores/Antica.json
https://api.tibiadata.com/v1/highscores/Zeluna/sword.json
https://api.tibiadata.com/v1/highscores/Candia/achievements/4.json

Example JSON data:

{
    "highscores": {
        "1": {
            "name": "Meendel",
            "rank": "1",
            "voc": "Royal Paladin",
            "points": "2846439072",
            "level": "556"
        },
        "2": {
            "name": "Magicallse",
            "rank": "2",
            "voc": "Master Sorcerer",
            "points": "2746411681",
            "level": "550"
        },
        "3": {
            "name": "Pysio",
            "rank": "3",
            "voc": "Elite Knight",
            "points": "2439600962",
            "level": "529"
        },
        ...
    }
}