Log in with:

RuneScape Wiki

Community Powered

Bestiary APIs

These APIs return JSON strings. For more information, particularly about using this information in a gadget, see 278-279-312-64548325.

Beast Data

../../m=itemdb_rs/bestiary/beastData.json?beastid=49

  • This returns the details of this particular NPC from its ID as a JSON string. In this case, 49 is a Hellhound.
  • For example with a beast ID of
    49
    as above the string will be:

    {"animations":{"death":17347,"attack":17348},"slayercat":"Hellhounds","xp":"344.4","size":2,
    "lifepoints":3300,"weakness":"Slashing","id":49,"poisonous":false,"magic":1,"attackable":true,
    "level":92,"defence":66,"description":"Hello, nice doggy...","name":"Hellhound","ranged":1,
    "areas":["Ardougne underground","RuneScape Surface","Forinthry Dungeon","Taverley Dungeon","Ancient cavern"],
    "attack":66,"aggressive":false,"members":false}
    

The details are as follows:

  • name = (string) the name of the beast
  • id = (int) the beast's ID
  • description = (string) the Examine description for the beast
  • weakness = (string) the beast's specific weakness
  • attackable = (bool) true if the beast is attackable; false otherwise
  • aggressive = (bool) true if the beast is aggressive; false otherwise
  • poisonous = (bool) true if the beast is poisonous; false otherwise
  • xp = (string) the base xp for the beast
  • lifepoints = (int) the amount of lifepoints for the beast
  • level = (int) the combat level for the beast
  • defence = (int) the defence level for the beast
  • attack = (int) the attack level for the beast
  • magic = (int) the magic level for the beast
  • ranged = (int) the range level for the beast
  • slayerlevel = (int) the slayer level required to kill this beast, this value can be omitted
  • size = the size of the beast
  • members = (bool) true if the best is members only; false otherwise
  • slayercat = (string) the slayer category that the beast belongs to
    • ie: grotworm, ganodermic
  • areas = a group of locations the beast is found in
    • [ LocationName (string), ... , LocationName (string) ]
    • - ie: [RuneScape Surface,Dwarven Mines]
  • animations = the different 3D animations available for the beast
    • { AnimationName (string) : AnimationID (int), ... ,AnimationName (string) : AnimationID (int) }
    • - ie: {"death":12793,"attack":12791}

Searching Names

In order to get the details on a beast, you will need to know the ID of that specific beast. There are a number of ways you can obtain the ID of a beast. One method is to use the search API:

../../m=itemdb_rs/bestiary/beastSearch.json?term=sheep+cow ( searches all beast names for the terms "sheep" and "cow" )

Search results are returned in a json string.

  • This returns the details of all NPCs that match the search terms as a JSON string.
  • For example with search terms of
    sheep+cow
    as above the string will be:

    [{"value":42,"label":"Sheep"},{"value":43,"label":"Sheep"},{"value":81,"label":"Cow (4)"},
    {"value":397,"label":"Cow (4)"},{"value":1763,"label":"Sheep"},{"value":3579,"label":"Sheep"},
    {"value":5162,"label":"Sheep"},{"value":5163,"label":"Sheep"},{"value":1271,"label":"Golden sheep"},
    {"value":1272,"label":"Golden sheep"},{"value":1691,"label":"Undead cow (4)"},
    {"value":1998,"label":"Plague cow"},{"value":1999,"label":"Plague cow"},
    {"value":2310,"label":"Cow calf (1)"},{"value":2311,"label":"Sheepdog"},
    {"value":5172,"label":"Golden sheep"},{"value":5173,"label":"Golden sheep"},
    {"value":5603,"label":"Unicow (57)"},{"value":18597,"label":"Zombie cow (1)"},
    {"value":5986,"label":"Armoured cow thing (62)"},{"value":6048,"label":"Armoured cow thing (62)"},
    {"value":1886,"label":"Cowardly Bandit"},{"value":5097,"label":"Coward in armour (82)"},
    {"value":6049,"label":"Coward with bow (105)"}]
    

The "value" in each item group represents the beast's ID, and the "label" represents the name of the beast.

Beasts A to Z

You can obtain various lists of beasts and their ID using different API requests, such as the A to Z interface:

../../m=itemdb_rs/bestiary/bestiaryNames.json?letter=Y ( Searches for all beast names that start with the letter "Y" )

  • This returns the details of all NPCs that begin with the letter stated as a JSON string.
  • For example with the letter
    Y
    as above the string will be:

    [{"value":6041,"label":"Yadviga (28)"},
    {"value":5529,"label":"Yak (42)"},
    {"value":12337,"label":"Yaktwee Swinmari Cianta"},
    {"value":515,"label":"Yanni Salika"},
    {"value":2102,"label":"Yellow Fortune Director"},
    {"value":2093,"label":"Yellow Fortune Secretary"},
    {"value":19357,"label":"Yelps (84)"},
    {"npcs":[{"value":19358,"label":"Yelps's bodyguard (112)"},
    {"value":19359,"label":"Yelps's bodyguard (112)"}],"dupe":"Yelps's bodyguard"},
    {"value":7379,"label":"Yeti (63)"},
    {"value":11872,"label":"Yk'Lagor the Thunderous (98)"},
    {"value":513,"label":"Yohnus"},
    {"value":5803,"label":"Young 'un"},
    {"value":15461,"label":"Young grotworm (28)"},
    {"value":1301,"label":"Yrsa"},
    {"value":2364,"label":"Ysgawyn"},
    {"value":16898,"label":"Ysondria"},
    {"value":2746,"label":"Yt-HurKot (108)"},
    {"value":2741,"label":"Yt-MejKot (180)"},
    {"value":4561,"label":"Yulf Squecks"},
    {"value":6028,"label":"Yuri (28)"}]
    

The "value" in each item group represents the beast's ID, and the "label" represents the name of the beast.

Beasts by Area

You can obtain beast names and ID's for specific areas by using the Areas API interfaces. There are two interfaces required for this, one to obtain the list of area names, and one to obtain the list of beasts in that area.

areaNames

To get a list of areas names, call areaNames (you don't need to add any search terms or IDs):

../../m=itemdb_rs/bestiary/bestiary/areaNames.json

  • This returns the details of all areas listed in the Bestiary as a JSON string.
  • For the link above the string will be:

    ["Abandoned Burthorpe mine","Agility Pyramid","Agility course pit","Air Rune Temple","Ancient cavern",
    "Ape Atoll","Ape Atoll tunnels","Ardougne underground","Armadyl's Citadel","Arposandran underground",
    "Arzinian Gold Mine","Ascension Dungeon","Asgarnian Ice Dungeon","Ashdale Caves","Assault course",
    "Baba Yaga's House","Bank","Barbarian Assault","Barbarian Assault lobby","Battlefield","Baxtorian Falls",
    "Beneath Iban's lair","Betty's basement","Black Knights' catacombs","Blast furnace","Borehole entrance",
    "Braindeath Island","Brimhaven Dungeon","Brimstail's home","Brine rat caverns","Burthorpe",
    "Captain Barnaby's Ship","Cave","Cellar","Chaos Temple Dungeon","Chaos Tunnels","Chaos tunnels",
    "Circus","Clan Wars","Classroom","Collapsing cave","Cosmic Entity plane","Courtroom","Crash site",
    "Daemonheim","Dagannoth caves","Death Rune Temple","Deep Wilderness Dungeon","Desert",
    "Desert island","Desert temple","Digsite caves","Dominion Tower","Dorgesh-Kaan","Dorgesh-Kaan Station",
    "Dorgesh-Kaan Station construction site","Dragon forge","Dragonkin castle","Dragontooth shipwreck",
    "Draynor","Dream world","Dungeon","Dungeoneering","Dwarven Mine","Dwarven mines","Eadgar's cave",
    "Eagle's Peak cave","Eagles' eyrie","Easter 2007","Easter 2009","Easter 2010","Easter 2011",
    "Edgeville Dungeon","Edimmu Dungeon","Elemental Workshop","Elvarg's lair","Enchanted valley",
    "Escape route","Exiled Kalphite Hive","Fenkenstrain's Dungeon","Field","Fisher Realm","Fishing Platform",
    "Forest","Forinthry Dungeon","Fremennik Dungeon","Fremennik spiritual realm","Games Room",
    "Genie's Cave","Ghorrock Fortress Dungeon","Glarial's tomb","Goblin temple","God Wars Dungeon",
    "Golrie's cave","Golrie's hideout","Gorajo Hoardstalker Dungeon","Gorak Plane","Grand Tree mine",
    "Grotworm Lair 1","Grotworm Lair 2","Grotworm Lair 3","Guthixian ruins","H.A.M. store rooms",
    "Halloween 2007","Halloween 2009","Haunted mine","Heist Lobby","Hetty's basement","House",
    "Iban's Lair","Ice Cave","Ice Queen's lair","Ice cave","Iceburg","Island","Jadinko lair","Jail",
    "Jaldraocht Pyramid","Jalsavrah Pyramid","Jatizso troll cave","Jiggig Dungeon","Kal'gerion Dungeon",
    "Kalphite Hive","Karamja Underground","Karamja Volcano","Karamja jungle","Keep Le Faye","Keldagrim",
    "Keldagrim Station","Kharazi caves","Killerwatt Plane","Kinshra Workshop","Kitchen","Korasi's dream",
    "Lair of Tarn Razorlor","Lava Flow Mine","Lighthouse","Lighthouse Dungeon","Living Rock Caverns",
    "Lumbridge","Lumbridge Catacombs","Lumbridge Cellar","Lumbridge cellar","Mage Training Arena",
    "Mage Training Arena basement","Meiyerditch Mine","Meiyerditch Myreque base","Meiyerditch mine",
    "Melzar's Maze","Mermaid Island","Mine","Miscellania Underground","Misthalin Underground",
    "Morytania underground","Mos Le'Harmless caves","Mouse hole","Movario's base","Myreque Hideout",
    "Nature Rune Temple","Nomad's temple","Observatory","Ogre enclave","Old Tower Shrine Room",
    "Old Tower Spellcasting Chamber","Oo'glog","Orks Rift","Orks Rift entrance","Ourania Altar","Party room",
    "Paterdomus","Pinball","Pollnivneach Dungeon","Pretty Flower's Cave","Prifddinas","Pyramid",
    "Queen Black Dragon's lair","Queen Black Dragon's stomach","Quiz master","Ramarno's forge",
    "Rantz's house","Rashiliyia's tomb","Rat Pit","Rat pit","Rat pits","Red Raktuber","Rellekka","River Elid cave",
    "Rogues' Den","Ruins of Uzer","RuneScape Surface","Runecrafting Guild","Saradomin's hidden cave",
    "Scabaras Dungeon","Sea battle","Sewer","Shadow Dungeon","Shady grove","Sigmund's base",
    "Silas's Dream","Skavid cave","Slug Citadel","Smoke Dungeon","Snake pit","Sophanem Dungeon",
    "Sorceress' garden","Soul Wars","Soul Wars Tutorial","Spirit Plane","Spirit Realm","Spirit Realm Chaos Altar",
    "Spirit Realm demonic ruins","Stronghold of Safety","Stronghold of Security","Swamp","Taverley Dungeon",
    "Taverley dungeon","Temple Knight archives","Temple Knight testing room","Temple Of Ikov",
    "Temple of Ikov","Temple of Light","Temple of Marimbo Dungeon","The Abyss","The Barrows",
    "The Battle of the Archipelago","The Runespan","The Senntisten Temple","The Senntisten digsite",
    "The Skullery","The final platform","The past","Theatre","Thieves' Guild","Tolna's Rift","Tower of Life",
    "Troll Stronghold","Troll tunnels","Tunnel of Chaos","Tunnels Near Keldagrim","TzHaar City","Tzhaar Caves",
    "Underground path","Underground pig pens","Underwater cave","Uzer Mastaba","Valluta's den","Varrock",
    "Varrock Museum","Varrock Sewers","Waiting room","Waterbirth Island Dungeon","Waterfall cave",
    "Wheat maze","White Wolf Mountain underground","Wilderness","Wilderness Dungeons",
    "Witchaven Dungeon","Wizards' Tower","Xmas 2005","Xmas 2007","Xmas 2009","Xmas 2010","Xmas 2011",
    "Yanille","Yanille Dungeon","Zanaris","Zanik's Lab","halloween 2010","halloween 2011"]
    

Each entry consists of the name of the area.

Once you have a list of area names, you can then use the areaBeasts interface to obtain a list of beasts in that area.

areaBeasts

To get a list of beasts by areas, call areaBeasts:

../../m=itemdb_rs/bestiary/areaBeasts.json?identifier=Shadow+Dungeon ( Searches for all beasts that are in the area "Shadow Dungeon" )

  • This returns the details of all beasts in the area listed as a JSON string.
  • For example with the area
    Shadow Dungeon
    as above the string will be:

    [{"value":412,"label":"Bat (14)"},{"value":78,"label":"Giant bat (44)"},{"value":86,"label":"Giant rat (7)"},
    {"value":4927,"label":"Giant rat (9)"},{"value":1973,"label":"Giant skeleton (84)"},
    {"value":5359,"label":"Giant skeleton (84)"},{"value":47,"label":"Rat (1)"},
    {"value":1976,"label":"Shadow Hound (67)"}]
    

The "value" in each item group represents the beast's ID, and the "label" represents the name of the beast.

Beasts by Slayer Category

You can obtain beast names and ID's for specific categories by using the SlayerCat API interfaces. You'll first need a list of the Slayer categories.

slayerCatNames

To get a list of slayer categories, call slayerCatNames (you don't need to add any search terms or IDs):

../../m=itemdb_rs/bestiary/bestiary/slayerCatNames.json

  • This returns the details of all slayer categories listed in the Bestiary as a JSON string.
  • For the link above the string will be:

    {"Aberrant spectres":41,"Abyssal demons":42,"Ankou":79,"Aquanites":95,"Banshees":38,"Basilisks":43,
    "Bats":8,"Bears":13,"Birds":5,"Black demons":30,"Black dragons":27,"Bloodveld":48,"Blue dragons":25,
    "Brine rats":84,"Bronze dragons":58,"Catablepon":78,"Cave bugs":63,"Cave crawlers":37,
    "Cave horrors":80,"Cave slimes":62,"Cockatrice":44,"Cows":6,"Crawling hands":39,"Crocodiles":65,
    "Cyclopes":108,"Dagannoth":35,"Dark beasts":66,"Desert lizards":68,"Desert strykewyrms":104,
    "Dogs":22,"Dust devils":49,"Dwarves":57,"Earth warriors":54,"Elves":56,"Fever spiders":69,
    "Fire giants":16,"Fleshcrawlers":77,"Fungal magi":99,"Ganodermic creatures":96,"Gargoyles":46,
    "Gelatinous Abominations":111,"Ghosts":12,"Ghouls":23,"Goblins":2,"Goraks":82,"Greater demons":29,
    "Green dragons":24,"Grifolapines":97,"Grifolaroos":98,"Grotworms":112,"Harpie bug swarms":70,
    "Hellhounds":31,"Hill giants":14,"Hobgoblins":21,"Ice giants":15,"Ice strykewyrms":105,
    "Ice warriors":19,"Icefiends":75,"Infernal mages":40,"Iron dragons":59,"Jellies":50,"Jungle horrors":81,
    "Jungle strykewyrms":103,"Kalphite":53,"Killerwatts":73,"Kurask":45,"Lesser demons":28,
    "Living rock creatures":106,"Minotaurs":76,"Mithril dragons":94,"Mogres":67,"Molanisks":87,"Monkeys":1,
    "Moss giants":17,"Mutated jadinkos":109,"Mutated zygomites":74,"Nechryael":52,"Ogres":20,
    "Otherworldly beings":55,"Polypore creatures":100,"Pyrefiends":47,"Rats":3,"Red dragons":26,
    "Rockslugs":51,"Scabarites":85,"Scorpions":7,"Sea snakes":71,"Shades":64,"Shadow warriors":32,
    "Skeletal wyverns":72,"Skeletons":11,"Spiders":4,"Spiritual mages":91,"Spiritual rangers":90,
    "Spiritual warriors":89,"Steel dragons":60,"Suqahs":83,"Terror dogs":86,"Trolls":18,"Turoth":36,
    "TzHaar":101,"Vampyres":34,"Volcanic creatures":102,"Vyrewatch":110,"Wall beasts":61,
    "Warped terrorbirds":93,"Warped tortoises":92,"Waterfiends":88,"Werewolves":33,"Wolves":9,"Zombies":10}
    

Each group consists of the name of the category, and the category ID.

Once you have a list of slayer categories, you can then use the slayerBeasts interface to obtain a list of beasts.

slayerBeasts

To get a list of beasts by slayer category, call slayerBeasts:

../../m=itemdb_rs/bestiary/slayerBeasts.json?identifier=96 ( Searches for all beasts that are in the slayer category "96" )

  • This returns the details of all beasts in the slayer category listed as a JSON string.
  • For example with the slayer category ID of
    96
    as above the string will be:

    [{"value":14696,"label":"Ganodermic beast (112)"},{"value":14697,"label":"Ganodermic beast (112)"},
    {"value":14698,"label":"Ganodermic runt (112)"},{"value":14699,"label":"Ganodermic runt (112)"}]
    

The "value" in each item group represents the beast's ID, and the "label" represents the name of the beast.

Beasts by Weakness

You can obtain beast names and ID's that have specific weaknesses using the Weakness API interfaces. There are two interfaces for this, one to obtain the list of weakness categories, and one to obtain the list of beasts with that specific weakness.

weaknessNames

To get a list of the weakness names, call the weaknessNames interface (you don't need to add any search terms or IDs):

../../m=itemdb_rs/bestiary/bestiary/weaknessNames.json

  • This returns the details of all weaknesses listed in the Bestiary as a JSON string.
  • For the link above the string will be:

    {"Air":1,"Arrow":8,"Bolt":9,"Crushing":7,"Earth":3,"Fire":4,"None":0,"Slashing":6,"Stabbing":5,
    "Thrown":10,"Water":2}
    

Each group consists of the name of the category, and the category ID.

Once you have a list of weakness categories, you can then use the weaknessBeasts interface to obtain a list of beasts in that category.

weaknessBeasts

To get a list of beasts by weakness, call weaknessBeasts:

../../m=itemdb_rs/bestiary/weaknessBeasts.json?identifier=10 ( Searches for all beasts that have the weakness "10" )

  • This returns the details of all beasts that have that weakness listed as a JSON string.
  • For example with the weakness ID of
    10
    as above the string will be:

    [{"value":1604,"label":"Aberrant spectre (72)"},{"value":10744,"label":"Animated book (2)"},
    {"value":16692,"label":"Bandosian ork (68)"},{"value":1618,"label":"Bloodveld (68)"},
    {"value":9612,"label":"Corpse mage (21)"},{"value":9613,"label":"Corpse mage (21)"},
    {"value":9614,"label":"Corpse mage (21)"},{"value":9615,"label":"Corpse mage (21)"},
    {"value":9616,"label":"Corpse mage (21)"},{"value":9617,"label":"Corpse mage (21)"},
    {"value":9618,"label":"Corpse mage (21)"},{"value":9619,"label":"Corpse mage (21)"},
    {"value":9620,"label":"Corpse mage (21)"},{"value":9621,"label":"Corpse mage (21)"},
    {"value":3496,"label":"Dessourt (92)"},{"value":3497,"label":"Gelatinnoth Mother (91)"},
    {"value":103,"label":"Ghost (25)"},{"value":104,"label":"Ghost (25)"},
    {"value":4388,"label":"Ghost (42)"},{"value":5342,"label":"Ghost (25)"},
    {"value":5344,"label":"Ghost (25)"},{"value":5345,"label":"Ghost (25)"},
    {"value":5347,"label":"Ghost (25)"},{"value":5348,"label":"Ghost (25)"},
    {"value":17011,"label":"Ghostly wraith (46)"},{"value":767,"label":"Glophren (70)"},
    {"value":3816,"label":"Gnome Mage (47)"},{"value":8567,"label":"Greater reborn mage (82)"},
    {"value":16689,"label":"Guthixian moss giant (68)"},{"value":15210,"label":"Har-Aken (Magic Tentacle) (800)"},
    {"value":7715,"label":"Icefiend (35)"},{"value":3064,"label":"Lesser Demon Champion (113)"},
    {"value":8565,"label":"Lesser reborn mage (68)"},{"value":8348,"label":"Local mage (16)"},
    {"value":1003,"label":"Lord Iban"},{"value":222,"label":"Monk (14)"},
    {"value":188,"label":"Monk of Zamorak (43)"},{"value":189,"label":"Monk of Zamorak (46)"},
    {"value":190,"label":"Monk of Zamorak (54)"},{"value":6471,"label":"Mosschin (30)"},
    {"value":194,"label":"Necromancer (39)"},{"value":126,"label":"Otherworldly being (63)"},
    {"value":12903,"label":"Reborn mage (40)"},{"value":6472,"label":"Redeyes (36)"},
    {"value":16690,"label":"Saradominist knight (68)"},{"value":10701,"label":"Seeker (86)"},
    {"value":5385,"label":"Skeleton (79)"},{"value":6473,"label":"Strongbones (36)"},
    {"value":5420,"label":"Tarn (79)"},{"value":3752,"label":"Torcher (51)"},
    {"value":19529,"label":"Trahaearn automaton (70)"},{"value":20098,"label":"Trahaearn automaton mk III (68)"},
    {"value":935,"label":"Viyeldi (70)"},{"value":4810,"label":"Vyrelady (98)"},
    {"value":4811,"label":"Vyrelady (98)"},{"value":4812,"label":"Vyrelady (98)"},
    {"value":4821,"label":"Vyrelady (98)"},{"value":4822,"label":"Vyrelord (98)"},
    {"value":4823,"label":"Vyrelord (98)"},{"value":4824,"label":"Vyrelord (98)"},
    {"value":4845,"label":"Vyrelord (98)"},{"value":6367,"label":"Zamorak mage (68)"},
    {"value":6368,"label":"Zamorak mage (68)"},{"value":16691,"label":"Zamorakian werewolf (68)"}]
    

The "value" in each item group represents the beast's ID, and the "label" represents the name of the beast.

Beasts by Level

You can obtain beast names and ID's that are within specific levels by using the levelGroup API interface:

../../m=itemdb_rs/bestiary/levelGroup.json?identifier=200-300 ( Searches for all beasts that are between the levels "200-300" )

  • This returns the details of all beasts that have the levels listed as a JSON string.
  • For example with the level group of
    200-300
    as above the string will be:

    [{"value":2879,"label":"Bardur (200)"},{"value":15205,"label":"TokHaar-Tok-Xil (200)"},
    {"value":16102,"label":"Torva (200)"},{"value":16103,"label":"Pernix (200)"},
    {"value":16104,"label":"Virtus (200)"},{"value":16732,"label":"Demon boss (200)"},
    {"value":17185,"label":"Scopulus (200)"},{"value":3334,"label":"WildyWyrm (202)"},
    {"value":11595,"label":"Pit iron dragon (204)"},{"value":19355,"label":"General Graardor (210)"},
    {"value":18932,"label":"Giant mole (230)"},{"value":50,"label":"King Black Dragon (276)"},
    {"value":15206,"label":"TokHaar-Yt-MejKot (300)"}]
    

Report a wiki page

If you have identified content on the wiki that breaches the wiki policies or RuneScape rules it is possible for you to resolve this by editing/updating the content.

However if you feel that a user has seriously breached our rules or editing policy and this requires urgent attention from a member of staff, then please specify the issue from the below categories: