RuneScape

Read RuneScape's own public data: Grand Exchange prices and price history, the hiscores, clans, RuneMetrics profiles and quest logs, the bestiary and the live player count, from the endpoints Jagex publishes for the game. Price any item by name, chart how it has moved, read a player's every skill and activity, see who leads a skill, list a clan's members, follow a player's adventurer's log, look up a monster's weakness, or post how many people are online. No account or API key is required.

Actions

Action	What it does
Get clan members	Everyone in a clan, from the owner down to the newest recruit, with each member's rank, total experience and kills, plus the totals: how many members, how much experience between them, who has the most, and how many hold each rank.
Get item price	What one item is worth on the Grand Exchange right now: the exact price, how many traded over the last day, how far the price moved today and over the last 30, 90 and 180 days, the examine text, the category and whether it is members only, with a link to its icon ready for a message.
Get monster stats	One monster's entry in the bestiary: combat level, life points, weakness, combat stats, the experience a kill gives, its Slayer category and the level needed, where it is found, and whether it is aggressive, poisonous or members only.
Get player count	How many people are playing RuneScape and Old School RuneScape right now, and how many accounts have ever been created.
Get player profile	A player's RuneMetrics profile: combat level, total level and experience, every skill, how many quests they have finished, started and not begun, and the latest entries of their adventurer's log, the in-game record of boss kills, drops and level-ups.
Get player quests	Every quest and whether the player has completed it, started it or not begun, with each quest's difficulty, quest points and whether they meet its requirements, plus the counts and the quest points earned so far.
Get player stats	A player's hiscores entry in full: every skill's level, experience and rank, every activity they are ranked in, their total level and overall rank, how many skills they have at 99 and at 120, and their highest skill.
Get price history	How an item's Grand Exchange price has moved over the last week, month, three months or six, as one point per day ready to chart plus the summary a reader actually wants: where it started, where it is now, how far it moved in coins and percent, and its high and low and the day each happened.
Get prices for several items	Price a whole watchlist at once and see what it adds up to: the exact price and daily volume of each item, what one of each would cost together, and which is the most and least valuable.
Get the top clans	The three clans with the most experience between their members, which is all the clan hiscores publish: each with its member count, its total and the average per member.
Get top players	Who leads a skill or an activity: up to fifty players from any rank down, with their experience or score, from the main, Ironman or Hardcore Ironman hiscores.
List items in a category	Browse the Grand Exchange the way its own site does: one of its 51 categories, the items whose names start with a chosen letter, twelve to a page, each with its price, today's change, examine text and icon.
Look up players' clans	Which clan each of up to twenty players is in and the title they wear, in one request.
Search the bestiary	Find monsters by name in the game's bestiary and get back each one's id and combat level with a link to its wiki page.

Get clan members

Everyone in a clan, from the owner down to the newest recruit, with each member's rank, total experience and kills, plus the totals: how many members, how much experience between them, who has the most, and how many hold each rank. A clan that does not exist comes back marked not found rather than failing.

Inputs

ClanclantextRequired: The clan's name, spelled as it is in game.

Outputs

average_xpnumber: Experience per member.
clantext
foundtrue/false: False when there is no such clan.
highest_xp_memberobject
member_countnumber
memberslist: Highest rank first.
most_kills_memberobject
not_found_notetext: Set only when there is no such clan, saying so. Empty otherwise.
ownertext
rank_countsobject: How many members hold each rank, Owner first.
total_killsnumber
total_xpnumber
total_xp_texttext

Example output

{
  "average_xp": 2351241512,
  "clan": "Maxed",
  "found": true,
  "highest_xp_member": {
    "kills": 6,
    "player": "Jad",
    "rank": "Admin",
    "total_xp": 5386253335,
    "total_xp_text": "5.4b"
  },
  "member_count": 497,
  "members": [
    {
      "kills": 5,
      "player": "Bit of Class",
      "rank": "Owner",
      "total_xp": 4866427375,
      "total_xp_text": "4.9b"
    },
    {
      "kills": 116,
      "player": "Pogmathon",
      "rank": "Deputy Owner",
      "total_xp": 5196335062,
      "total_xp_text": "5.2b"
    }
  ],
  "most_kills_member": {
    "kills": 31079,
    "player": "Shooter",
    "rank": "Admin",
    "total_xp": 4306299800,
    "total_xp_text": "4.3b"
  },
  "not_found_note": "",
  "owner": "Bit of Class",
  "rank_counts": {
    "Admin": 345,
    "Coordinator": 3,
    "Deputy Owner": 4,
    "General": 116,
    "Organiser": 14,
    "Overseer": 3,
    "Owner": 1,
    "Recruit": 11
  },
  "total_kills": 99628,
  "total_xp": 1168566292766,
  "total_xp_text": "1.2t"
}

Get item price

What one item is worth on the Grand Exchange right now: the exact price, how many traded over the last day, how far the price moved today and over the last 30, 90 and 180 days, the examine text, the category and whether it is members only, with a link to its icon ready for a message. The item is picked by name rather than by id.

Inputs

ItemitemtextRequired: The item to look up. Pick it from the list, or use the name exactly as it appears in game when it comes from an earlier step.

Outputs

attributionobject: Credit to show wherever the wiki's data is republished.
categorytext: The Grand Exchange category the item is filed under.
change_180d_percentnumber
change_30d_percentnumber: How far the price moved over the last 30 days, in percent.
change_90d_percentnumber
change_todaynumber: How many coins the price moved today. Negative for a fall.
change_today_texttext
examinetext: The item's in-game examine text.
exchange_urltext: Link to the item's Grand Exchange page on the wiki.
guide_pricenumber: The price as Jagex's item database quotes it, rounded to three figures. The exact price is in 'price'.
guide_price_texttext
icon_urltext: Link to the item's inventory icon, ready to use in a message.
image_urltext: Link to the larger picture of the item.
item_idnumber: The item's id in game.
item_nametext
memberstrue/false: True when the item can only be used on a members' world.
pricenumber: The Grand Exchange's current price for one, in coins, exact. Empty for an item it has never priced.
price_age_hoursnumber: How many hours ago that was.
price_age_notetext: Set only when the price is days old or missing, saying so. Empty otherwise.
price_texttext: The same price the way a player reads it, such as '1.4b'.
price_updated_attext: When the Grand Exchange last set this price (ISO 8601, UTC).
trend_todaytext: One of 'positive', 'negative' or 'neutral'.
volumenumber: How many changed hands over the last day. Empty for the items the exchange publishes no volume for.

Example output

{
  "attribution": {
    "license": "CC BY-NC-SA 3.0",
    "license_url": "https://creativecommons.org/licenses/by-nc-sa/3.0/",
    "text": "Item names and exact prices from the RuneScape Wiki; everything else from Jagex's public RuneScape endpoints",
    "url": "https://runescape.wiki"
  },
  "category": "Melee weapons - high level",
  "change_180d_percent": -16.0,
  "change_30d_percent": -8.0,
  "change_90d_percent": -14.0,
  "change_today": 2207,
  "change_today_text": "2.2k",
  "examine": "A weapon from the Abyss.",
  "exchange_url": "https://runescape.wiki/w/Exchange:Abyssal_whip",
  "guide_price": 70000,
  "guide_price_text": "70k",
  "icon_url": "https://secure.runescape.com/m=itemdb_rs/obj_sprite.gif?id=4151",
  "image_url": "https://secure.runescape.com/m=itemdb_rs/obj_big.gif?id=4151",
  "item_id": 4151,
  "item_name": "Abyssal whip",
  "members": true,
  "price": 69981,
  "price_age_hours": 23,
  "price_age_note": "",
  "price_text": "70k",
  "price_updated_at": "2026-10-08T07:42:06Z",
  "trend_today": "positive",
  "volume": 307
}

Get monster stats

One monster's entry in the bestiary: combat level, life points, weakness, combat stats, the experience a kill gives, its Slayer category and the level needed, where it is found, and whether it is aggressive, poisonous or members only. Takes a name or an id; a name with no monster comes back marked not found rather than failing.

Inputs

MonstermonstertextRequired: The monster's name, as the bestiary spells it, or its id from a search.

Outputs

aggressivetrue/false
areaslist: Where it is found.
attacknumber
attackabletrue/false
combat_levelnumber
defencenumber
examinetext
foundtrue/false: False when the bestiary has no such monster.
life_pointsnumber
magicnumber
matched_by_searchtrue/false: True when no monster had exactly that name and the first whose name contains it was used.
memberstrue/false
monster_idnumber
nametext
not_found_notetext: Set only when there is no such monster, saying so. Empty otherwise.
poisonoustrue/false
rangednumber
requestedtext
sizenumber: In game squares.
slayer_categorytext
slayer_levelnumber: The Slayer level needed. Empty when none is.
weaknesstext: The attack style it is weak to. Empty when it has no weakness.
wiki_urltext
xpnumber: Combat experience for one kill.

Example output

{
  "aggressive": false,
  "areas": [
    "RuneScape Surface",
    "The Abyss",
    "Ancient cavern",
    "Slayer Tower Resource Dungeon"
  ],
  "attack": 70,
  "attackable": true,
  "combat_level": 98,
  "defence": 70,
  "examine": "A denizen of the Abyss!",
  "found": true,
  "life_points": 8500,
  "magic": 1,
  "matched_by_search": false,
  "members": true,
  "monster_id": 1615,
  "name": "Abyssal demon",
  "not_found_note": "",
  "poisonous": false,
  "ranged": 1,
  "requested": "Abyssal demon",
  "size": 1,
  "slayer_category": "Abyssal Demons",
  "slayer_level": 85,
  "weakness": "Slashing",
  "wiki_url": "https://runescape.wiki/w/Abyssal_demon",
  "xp": 628.6
}

Get player count

How many people are playing RuneScape and Old School RuneScape right now, and how many accounts have ever been created. The number the game's own website shows, ready for a dashboard or a scheduled post.

Inputs

None.

Outputs

accounts_creatednumber
accounts_created_texttext
measured_attext
notetext
online_nownumber
online_now_texttext

Example output

{
  "accounts_created": 341504883,
  "accounts_created_text": "341,504,883",
  "measured_at": "2026-10-09T07:15:12Z",
  "note": "The online count covers RuneScape and Old School RuneScape together; Jagex publishes no split.",
  "online_now": 74887,
  "online_now_text": "74,887"
}

Get player profile

A player's RuneMetrics profile: combat level, total level and experience, every skill, how many quests they have finished, started and not begun, and the latest entries of their adventurer's log, the in-game record of boss kills, drops and level-ups. Profiles are private unless the player opts in; a private one comes back marked unavailable with the reason rather than failing.

Inputs

PlayerplayertextRequired: The player's display name, spelled as they spell it.
Log entriesactivitiesnumber: How many adventurer's log entries to include, newest first. RuneMetrics keeps the last 20.From 0 to 20. Default: 20.

Outputs

activitieslist: The adventurer's log, newest first.
activity_countnumber
availabletrue/false: False when the profile cannot be read.
combat_levelnumber
foundtrue/false: False when RuneMetrics knows no such player.
highest_xp_skilltext
latest_activity_attext
magic_xpnumber
melee_xpnumber
notetext: Says why the profile is unavailable, when it is.
overall_ranknumber
playertext
quests_completednumber
quests_not_startednumber
quests_startednumber
ranged_xpnumber
skillslist: Every skill, Attack first.
total_levelnumber
total_xpnumber
total_xp_texttext
unavailable_reasontext: 'private', 'not a member' or 'no such player' when the profile cannot be read. Empty otherwise.

Example output

{
  "activities": [
    {
      "at": "2025-04-11T09:38:00Z",
      "details": "I killed 2 Kalphite Kings.",
      "text": "I killed 2 Kalphite Kings."
    },
    {
      "at": "2025-04-11T09:12:00Z",
      "details": "I killed  the King Black Dragon, which was once the biggest, meanest dragon around.",
      "text": "I killed  the King Black Dragon."
    }
  ],
  "activity_count": 2,
  "available": true,
  "combat_level": 152,
  "found": true,
  "highest_xp_skill": "Attack",
  "latest_activity_at": "2025-04-11T09:38:00Z",
  "magic_xp": 200000000,
  "melee_xp": 3000000000,
  "note": "",
  "overall_rank": 1,
  "player": "Its Dave",
  "quests_completed": 317,
  "quests_not_started": 45,
  "quests_started": 2,
  "ranged_xp": 200000000,
  "skills": [
    {
      "level": 120,
      "name": "Attack",
      "rank": 1155,
      "skill_id": 0,
      "xp": 200000000,
      "xp_text": "200m"
    },
    {
      "level": 120,
      "name": "Necromancy",
      "rank": 1,
      "skill_id": 28,
      "xp": 200000000,
      "xp_text": "200m"
    }
  ],
  "total_level": 3232,
  "total_xp": 5800000000,
  "total_xp_text": "5.8b",
  "unavailable_reason": ""
}

Get player quests

Every quest and whether the player has completed it, started it or not begun, with each quest's difficulty, quest points and whether they meet its requirements, plus the counts and the quest points earned so far. Filter to just the finished, in-progress or unstarted ones. Needs a public RuneMetrics profile.

Inputs

PlayerplayertextRequired: The player's display name, spelled as they spell it.
Showstatustext: Which quests to list.One of: any (Every quest), completed, started (In progress), not_started (Not started). Default: any.

Outputs

availabletrue/false: False when RuneMetrics returned no quests, which is what a private profile or an unknown name gets.
completed_countnumber
eligible_to_startnumber: How many unstarted quests the player already qualifies for.
not_started_countnumber
notetext
playertext
quest_countnumber
quest_points_availablenumber: Quest points from every quest in the game.
quest_points_earnednumber
questslist: The quests matching the filter, alphabetical.
started_countnumber
statustext: The filter applied.

Example output

{
  "available": true,
  "completed_count": 317,
  "eligible_to_start": 27,
  "not_started_count": 45,
  "note": "",
  "player": "Its Dave",
  "quest_count": 2,
  "quest_points_available": 476,
  "quest_points_earned": 431,
  "quests": [
    {
      "difficulty": 250,
      "difficulty_name": "Special",
      "eligible": true,
      "members": true,
      "quest_points": 2,
      "status": "started",
      "title": "Dimension of Disaster",
      "wiki_url": "https://runescape.wiki/w/Dimension_of_Disaster"
    },
    {
      "difficulty": 2,
      "difficulty_name": "Experienced",
      "eligible": true,
      "members": true,
      "quest_points": 2,
      "status": "started",
      "title": "Dimension of Disaster: Defender of Varrock",
      "wiki_url": "https://runescape.wiki/w/Dimension_of_Disaster:_Defender_of_Varrock"
    }
  ],
  "started_count": 2,
  "status": "started"
}

Get player stats

A player's hiscores entry in full: every skill's level, experience and rank, every activity they are ranked in, their total level and overall rank, how many skills they have at 99 and at 120, and their highest skill. Read from the main, Ironman or Hardcore Ironman hiscores. A name that is not ranked comes back marked not found rather than failing, so a lookup workflow can answer instead of breaking.

Inputs

PlayerplayertextRequired: The player's display name, spelled as they spell it.
Hiscoresmodetext: Which hiscores to read. Ironman and Hardcore Ironman accounts are ranked on their own boards as well as the main one.One of: standard (Main hiscores), ironman (Ironman hiscores), hardcore (Hardcore Ironman hiscores). Default: standard.

Outputs

activitieslist: Every activity, ranked or not.
foundtrue/false: False when the name is not on the hiscores.
highest_xp_skilltext
hiscores_urltext
lowest_level_skilltext
modetext
mode_descriptiontext
not_found_notetext: Set only when the player is not ranked, saying so. Empty otherwise.
overall_ranknumber
playertext: The name as the hiscores spell it.
ranked_activitiesnumber
skillslist: Every skill, in the game's order.
skills_at_120number
skills_at_99number
total_levelnumber
total_xpnumber
total_xp_texttext

Example output

{
  "activities": [
    {
      "activity_id": 2,
      "name": "Dominion Tower",
      "rank": 140,
      "ranked": true,
      "score": 26445855
    },
    {
      "activity_id": 32,
      "name": "Leagues: Catalyst",
      "rank": null,
      "ranked": false,
      "score": 0
    }
  ],
  "found": true,
  "highest_xp_skill": "Attack",
  "hiscores_url": "https://secure.runescape.com/m=hiscore/compare?user1=Zezima",
  "lowest_level_skill": "Defence",
  "mode": "standard",
  "mode_description": "the main hiscores",
  "not_found_note": "",
  "overall_rank": 6559,
  "player": "Zezima",
  "ranked_activities": 18,
  "skills": [
    {
      "level": 120,
      "name": "Attack",
      "rank": 358,
      "skill_id": 1,
      "xp": 200000000,
      "xp_text": "200m"
    },
    {
      "level": 120,
      "name": "Necromancy",
      "rank": 46601,
      "skill_id": 29,
      "xp": 109998811,
      "xp_text": "110m"
    }
  ],
  "skills_at_120": 13,
  "skills_at_99": 29,
  "total_level": 3232,
  "total_xp": 5709998811,
  "total_xp_text": "5.7b"
}

Get price history

How an item's Grand Exchange price has moved over the last week, month, three months or six, as one point per day ready to chart plus the summary a reader actually wants: where it started, where it is now, how far it moved in coins and percent, and its high and low and the day each happened.

Inputs

ItemitemtextRequired: The item to look up. Pick it from the list, or use the name exactly as it appears in game when it comes from an earlier step.
Periodperiodtext: How far back to look.One of: 7d (Last 7 days), 30d (Last 30 days), 90d (Last 90 days), 180d (Last 180 days). Default: 30d.

Outputs

average_pricenumber
changenumber: Coins gained or lost over the period.
change_percentnumber
directiontext: One of 'up', 'down', 'flat' or 'unknown'.
exchange_urltext: Link to the item's Grand Exchange page on the wiki.
highest_pricenumber
highest_price_ontext
icon_urltext: Link to the item's inventory icon, ready to use in a message.
image_urltext: Link to the larger picture of the item.
item_idnumber: The item's id in game.
item_nametext
latest_pricenumber
lowest_pricenumber
lowest_price_ontext
periodtext
period_descriptiontext
period_endtext
period_starttext: The first day with a price, as YYYY-MM-DD.
point_countnumber
pointslist: One point per day, oldest first.
starting_pricenumber
summary_notetext: Set only when the item had no prices at all. Empty otherwise.

Example output

{
  "average_price": 68245,
  "change": 3579,
  "change_percent": 5.39,
  "direction": "up",
  "exchange_url": "https://runescape.wiki/w/Exchange:Abyssal_whip",
  "highest_price": 69981,
  "highest_price_on": "2026-10-08",
  "icon_url": "https://secure.runescape.com/m=itemdb_rs/obj_sprite.gif?id=4151",
  "image_url": "https://secure.runescape.com/m=itemdb_rs/obj_big.gif?id=4151",
  "item_id": 4151,
  "item_name": "Abyssal whip",
  "latest_price": 69981,
  "lowest_price": 66402,
  "lowest_price_on": "2026-10-03",
  "period": "7d",
  "period_description": "the last 7 days",
  "period_end": "2026-10-08",
  "period_start": "2026-10-03",
  "point_count": 6,
  "points": [
    {
      "average_30d": 73408,
      "date": "2026-10-03",
      "price": 66402,
      "price_text": "66.4k"
    },
    {
      "average_30d": 71650,
      "date": "2026-10-08",
      "price": 69981,
      "price_text": "70k"
    }
  ],
  "starting_price": 66402,
  "summary_note": ""
}

Get prices for several items

Price a whole watchlist at once and see what it adds up to: the exact price and daily volume of each item, what one of each would cost together, and which is the most and least valuable. Use this rather than one step per item: the whole list is priced in a single request, so a hundred items cost exactly what one does.

Inputs

ItemsitemslistRequired: The items to price. Pick as many as you like; they are all priced in one request, up to 100.

Outputs

attributionobject: Credit to show wherever the wiki's data is republished.
item_countnumber
itemslist: Every item, in the order chosen.
items_without_pricesnumber: How many items the exchange has never priced.
least_valuableobject
most_valuableobject
prices_updated_attext: When the newest of the prices was set.
totalnumber: What one of every item would cost together. Empty when any item has no price.
total_texttext

Example output

{
  "attribution": {
    "license": "CC BY-NC-SA 3.0",
    "license_url": "https://creativecommons.org/licenses/by-nc-sa/3.0/",
    "text": "Item names and exact prices from the RuneScape Wiki; everything else from Jagex's public RuneScape endpoints",
    "url": "https://runescape.wiki"
  },
  "item_count": 2,
  "items": [
    {
      "exchange_url": "https://runescape.wiki/w/Exchange:Bond",
      "icon_url": "https://secure.runescape.com/m=itemdb_rs/obj_sprite.gif?id=29492",
      "image_url": "https://secure.runescape.com/m=itemdb_rs/obj_big.gif?id=29492",
      "item_id": 29492,
      "item_name": "Bond",
      "price": 145401610,
      "price_age_hours": 23,
      "price_age_note": "",
      "price_text": "145.4m",
      "price_updated_at": "2026-10-08T07:42:06Z",
      "volume": null
    },
    {
      "exchange_url": "https://runescape.wiki/w/Exchange:Nature_rune",
      "icon_url": "https://secure.runescape.com/m=itemdb_rs/obj_sprite.gif?id=561",
      "image_url": "https://secure.runescape.com/m=itemdb_rs/obj_big.gif?id=561",
      "item_id": 561,
      "item_name": "Nature rune",
      "price": 393,
      "price_age_hours": 23,
      "price_age_note": "",
      "price_text": "393",
      "price_updated_at": "2026-10-08T07:42:06Z",
      "volume": 9468204
    }
  ],
  "items_without_prices": 0,
  "least_valuable": {
    "exchange_url": "https://runescape.wiki/w/Exchange:Nature_rune",
    "icon_url": "https://secure.runescape.com/m=itemdb_rs/obj_sprite.gif?id=561",
    "image_url": "https://secure.runescape.com/m=itemdb_rs/obj_big.gif?id=561",
    "item_id": 561,
    "item_name": "Nature rune",
    "price": 393,
    "price_age_hours": 23,
    "price_age_note": "",
    "price_text": "393",
    "price_updated_at": "2026-10-08T07:42:06Z",
    "volume": 9468204
  },
  "most_valuable": {
    "exchange_url": "https://runescape.wiki/w/Exchange:Bond",
    "icon_url": "https://secure.runescape.com/m=itemdb_rs/obj_sprite.gif?id=29492",
    "image_url": "https://secure.runescape.com/m=itemdb_rs/obj_big.gif?id=29492",
    "item_id": 29492,
    "item_name": "Bond",
    "price": 145401610,
    "price_age_hours": 23,
    "price_age_note": "",
    "price_text": "145.4m",
    "price_updated_at": "2026-10-08T07:42:06Z",
    "volume": null
  },
  "prices_updated_at": "2026-10-08T07:42:06Z",
  "total": 145402003,
  "total_text": "145.4m"
}

Get the top clans

The three clans with the most experience between their members, which is all the clan hiscores publish: each with its member count, its total and the average per member.

Inputs

None.

Outputs

clan_countnumber
clanslist: Most experience first.

Example output

{
  "clan_count": 2,
  "clans": [
    {
      "average_xp_per_member": 2732009625,
      "average_xp_per_member_text": "2.7b",
      "clan": "Efficiency Experts",
      "member_count": 498,
      "rank": 1,
      "total_xp": 1360540793266,
      "total_xp_text": "1.4t"
    },
    {
      "average_xp_per_member": 2351240026,
      "average_xp_per_member_text": "2.4b",
      "clan": "Maxed",
      "member_count": 497,
      "rank": 2,
      "total_xp": 1168566292766,
      "total_xp_text": "1.2t"
    }
  ]
}

Get top players

Who leads a skill or an activity: up to fifty players from any rank down, with their experience or score, from the main, Ironman or Hardcore Ironman hiscores. Start further down the board to page through it, or to see where a particular rank sits.

Inputs

Leaderboardleaderboardtext: Whether to rank a skill or an activity.One of: skill (A skill), activity (An activity). Default: skill.
Skillskilltext: The skill to rank by experience.Only when Leaderboard is A skill. One of: Overall, Attack, Defence, Strength, Constitution, Ranged, Prayer, Magic, Cooking, Woodcutting, and 20 more. Default: Overall.
Activityactivitytext: The activity to rank by score.Only when Leaderboard is An activity. One of: Bounty Hunter, Bounty Hunter Rogues, Dominion Tower, The Crucible, Castle Wars Games, Barbarian Assault Attackers, Barbarian Assault Defenders, Barbarian Assault Collectors, Barbarian Assault Healers, Duel Tournament, and 22 more. Default: RuneScore.
Hiscoresmodetext: Which hiscores to read. Ironman and Hardcore Ironman accounts are ranked on their own boards as well as the main one.One of: standard (Main hiscores), ironman (Ironman hiscores), hardcore (Hardcore Ironman hiscores). Default: standard.
How manylimitnumber: How many entries to return.From 1 to 50. Default: 10.
Starting rankstarting_ranknumber: The rank to start from. Leave empty for the top.At least 1.

Outputs

boardtext: The skill or activity ranked.
first_ranknumber
last_ranknumber
leaderboardtext
modetext
mode_descriptiontext
player_countnumber
playerslist: Best first.
score_meanstext: 'experience' for a skill, 'score' otherwise.

Example output

{
  "board": "Overall",
  "first_rank": 1,
  "last_rank": 2,
  "leaderboard": "skill",
  "mode": "standard",
  "mode_description": "the main hiscores",
  "player_count": 2,
  "players": [
    {
      "hiscores_url": "https://secure.runescape.com/m=hiscore/compare?user1=Its%20Dave",
      "player": "Its Dave",
      "rank": 1,
      "score": 5800000000,
      "score_text": "5.8b"
    },
    {
      "hiscores_url": "https://secure.runescape.com/m=hiscore/compare?user1=Raul",
      "player": "Raul",
      "rank": 2,
      "score": 5800000000,
      "score_text": "5.8b"
    }
  ],
  "score_means": "experience"
}

List items in a category

Browse the Grand Exchange the way its own site does: one of its 51 categories, the items whose names start with a chosen letter, twelve to a page, each with its price, today's change, examine text and icon. Comes with how many pages there are, so a workflow can walk a whole category.

Inputs

Categorycategorytext: The Grand Exchange category to browse.One of: Miscellaneous, Ammo, Arrows, Bolts, Construction materials, Construction products, Cooking ingredients, Costumes, Crafting materials, Familiars, and 41 more. Default: Melee weapons - high level.
Starting withlettertext: The first letter of the item names to list, or # for names that start with a number.Default: a.
Pagepagenumber: Which page of twelve items to return.At least 1. Default: 1.

Outputs

categorytext
category_idnumber
has_moretrue/false: True when there is a page after this one.
item_countnumber
itemslist: This page's items, in the exchange's order.
items_in_categorynumber
items_under_letternumber
lettertext
pagenumber
page_countnumber: How many pages the letter has in this category.

Example output

{
  "category": "Costumes",
  "category_id": 7,
  "has_more": true,
  "item_count": 1,
  "items": [
    {
      "category": "Costumes",
      "change_today": 0,
      "change_today_text": "0",
      "examine": "A nice hat from a cracker.",
      "exchange_url": "https://runescape.wiki/w/Exchange:Red_partyhat",
      "guide_price": 57600000000,
      "guide_price_text": "57.6b",
      "icon_url": "https://secure.runescape.com/m=itemdb_rs/obj_sprite.gif?id=1038",
      "image_url": "https://secure.runescape.com/m=itemdb_rs/obj_big.gif?id=1038",
      "item_id": 1038,
      "item_name": "Red partyhat",
      "members": false,
      "trend_today": "neutral"
    }
  ],
  "items_in_category": 443,
  "items_under_letter": 37,
  "letter": "r",
  "page": 1,
  "page_count": 4
}

Look up players' clans

Which clan each of up to twenty players is in and the title they wear, in one request. The way to tell whether a name belongs to a real player, and the one place a player's clan is published.

Inputs

PlayersplayerslistRequired: The players to look up, as a list or separated by commas, up to 20.

Outputs

found_countnumber
not_foundlist: The names the website does not know.
player_countnumber
playerslist: One entry per name asked for, in order.

Example output

{
  "found_count": 2,
  "not_found": [],
  "player_count": 2,
  "players": [
    {
      "clan": "Zezima Clan",
      "clan_recruiting": true,
      "found": true,
      "player": "Zezima",
      "title": null
    },
    {
      "clan": "Goblin Slayerz",
      "clan_recruiting": true,
      "found": true,
      "player": "Maikeru",
      "title": null
    }
  ]
}

Search the bestiary

Find monsters by name in the game's bestiary and get back each one's id and combat level with a link to its wiki page. Every monster whose name contains a word of the search is listed, so 'dragon' finds them all. Use it to find the exact name before reading a monster's stats.

Inputs

SearchquerytextRequired: Part of a monster's name.
How manylimitnumber: How many entries to return.From 1 to 50. Default: 10.

Outputs

monster_countnumber
monsterslist: In the bestiary's order.
querytext
total_matchesnumber: How many monsters match in total.

Example output

{
  "monster_count": 2,
  "monsters": [
    {
      "combat_level": 98,
      "monster_id": 1615,
      "name": "Abyssal demon",
      "wiki_url": "https://runescape.wiki/w/Abyssal_demon"
    },
    {
      "combat_level": 72,
      "monster_id": 2263,
      "name": "Abyssal leech",
      "wiki_url": "https://runescape.wiki/w/Abyssal_leech"
    }
  ],
  "query": "abyssal",
  "total_matches": 22
}

ActionsCopy Anchor Link

Get clan membersCopy Anchor Link

Inputs

Outputs

Get item priceCopy Anchor Link

Inputs

Outputs

Get monster statsCopy Anchor Link

Inputs

Outputs

Get player countCopy Anchor Link

Inputs

Outputs

Get player profileCopy Anchor Link

Inputs

Outputs

Get player questsCopy Anchor Link

Inputs

Outputs

Get player statsCopy Anchor Link

Inputs

Outputs

Get price historyCopy Anchor Link

Inputs

Outputs

Get prices for several itemsCopy Anchor Link

Inputs

Outputs

Get the top clansCopy Anchor Link

Inputs

Outputs

Get top playersCopy Anchor Link

Inputs

Outputs

List items in a categoryCopy Anchor Link

Inputs

Outputs

Look up players' clansCopy Anchor Link

Inputs

Outputs

Search the bestiaryCopy Anchor Link

Inputs

Outputs

On this page

Actions

Get clan members

Get item price

Get monster stats

Get player count

Get player profile

Get player quests

Get player stats

Get price history

Get prices for several items

Get the top clans

Get top players

List items in a category

Look up players' clans

Search the bestiary