Latest Website News
Main Menu
 

All Categories - Game Updates - Website - Customer Support
Technical - Community - Behind the Scenes - Archived

16th March 2025 - Hiscores API

We've got a new hiscores API now! Your HTML scraping days are over.

Please note there are rate limits in place. Keep it fair for everyone using it.

Additionally after the last game update, hiscores will update on logout. No longer on a 30-minute schedule.

Important! RuneScape stores XP * 10 to allow for decimals, divide and truncate it when displaying.

Search By Category

GET /api/hiscores/category/:type

There is an optional "rank" query parameter that will paginate just like the hiscores page. If you aren't familiar with it, it returns the last 20 ranks up to your query (21 per page).
?rank=22 returns 2-22, ?rank=1000 would return 980-1000.

The response format will appear like:


[
  {
    "username": string,
    "level": number,
    "value": number, // xp
    "date": string, // last updated
    "rank": number
  }
]

Types:
0: Overall
1: Attack
2: Defence
3: Strength
4: Hitpoints
5: Ranged
6: Prayer
7: Magic
8: Cooking
9: Woodcutting
10: Fletching
11: Fishing
12: Firemaking
13: Crafting
14: Smithing
15: Mining
16: Herblore
17: Agility
18: Thieving
(yes there's a gap!)
21: Runecrafting

Search By Player

GET /api/hiscores/player/:username
(this cannot be used to tell if an account exists)

The response format will appear like:


[
  {
    "type": number, // category
    "level": number,
    "value": number, // xp
    "date": string, // last updated
    "rank": number
  }
]

View our non-affiliation disclaimer here.
Recreated and preserved 2023 - 2025.