Highscores

Documentation of how to use our v1 highscores API.

Get various highscores of worlds

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

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"
        },
        ...
    }
}