PHPackages bert-w/runescape-hiscores-api - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. bert-w/runescape-hiscores-api ActiveLibrary bert-w/runescape-hiscores-api ============================= Retrieve Hiscore results easily from the OSRS RuneScape Hiscores page. v3.2.0(1y ago)0191MITHTMLPHP ^7.2|^8.0CI failing Since Mar 5Pushed 1y ago1 watchersCompare [ Source](https://github.com/bert-w/runescape-hiscores-api)[ Packagist](https://packagist.org/packages/bert-w/runescape-hiscores-api)[ RSS](/packages/bert-w-runescape-hiscores-api/feed)WikiDiscussions master Synced today READMEChangelog (10)Dependencies (5)Versions (20)Used By (0) bert-w/runescape-hiscores-api ============================= [](#bert-wrunescape-hiscores-api) [![PHP Pipeline](https://github.com/bert-w/runescape-hiscores-api/actions/workflows/php.yml/badge.svg)](https://github.com/bert-w/runescape-hiscores-api/actions/workflows/php.yml/badge.svg)[![Latest Stable Version](https://camo.githubusercontent.com/420e4011a29f25ae996a8ff17a07233794052762c3ffea9e6da063affcc7d7b4/68747470733a2f2f706f7365722e707567782e6f72672f626572742d772f72756e6573636170652d686973636f7265732d6170692f762f737461626c65)](https://packagist.org/packages/bert-w/runescape-hiscores-api)[![Total Downloads](https://camo.githubusercontent.com/9846ac8b2956a65969f782017ec881a1e576fb84ac05c953ae70d043b5ee06fd/68747470733a2f2f706f7365722e707567782e6f72672f626572742d772f72756e6573636170652d686973636f7265732d6170692f646f776e6c6f616473)](https://packagist.org/packages/bert-w/runescape-hiscores-api)[![License](https://camo.githubusercontent.com/8df301acfd0230a6f35253846311496a3f88fca3c204d13a5c4515e2eaf786a0/68747470733a2f2f706f7365722e707567782e6f72672f626572742d772f72756e6573636170652d686973636f7265732d6170692f6c6963656e7365)](https://packagist.org/packages/bert-w/runescape-hiscores-api) A PHP implementation to request player data in a nice format from: - OSRS Hiscores [https://secure.runescape.com/m=hiscore\_oldschool/overall](https://secure.runescape.com/m=hiscore_oldschool/overall) - RS3 Hiscores [![](https://camo.githubusercontent.com/7df77530163865f9cfe13c1da806626bce8b2f4fd5ffa1273781616ea4b405f5/68747470733a2f2f7777772e72756e6573636170652e636f6d2f696d672f7273703737372f686973636f7265732f736b696c6c5f69636f6e5f66697368696e67312e676966)](https://camo.githubusercontent.com/7df77530163865f9cfe13c1da806626bce8b2f4fd5ffa1273781616ea4b405f5/68747470733a2f2f7777772e72756e6573636170652e636f6d2f696d672f7273703737372f686973636f7265732f736b696c6c5f69636f6e5f66697368696e67312e676966)[![](https://camo.githubusercontent.com/fd8982ccb52acc285eb6d18112d53620795ca22983fbe5850fed2a9369008458/68747470733a2f2f7777772e72756e6573636170652e636f6d2f696d672f7273703737372f686973636f7265732f736b696c6c5f69636f6e5f686974706f696e7473312e676966)](https://camo.githubusercontent.com/fd8982ccb52acc285eb6d18112d53620795ca22983fbe5850fed2a9369008458/68747470733a2f2f7777772e72756e6573636170652e636f6d2f696d672f7273703737372f686973636f7265732f736b696c6c5f69636f6e5f686974706f696e7473312e676966)[![](https://camo.githubusercontent.com/766ca17a9c498e9f65b1662f66d08b3feced2176a47e4602c84739a4f2411e2e/68747470733a2f2f7777772e72756e6573636170652e636f6d2f696d672f7273703737372f686973636f7265732f736b696c6c5f69636f6e5f646566656e6365312e676966)](https://camo.githubusercontent.com/766ca17a9c498e9f65b1662f66d08b3feced2176a47e4602c84739a4f2411e2e/68747470733a2f2f7777772e72756e6573636170652e636f6d2f696d672f7273703737372f686973636f7265732f736b696c6c5f69636f6e5f646566656e6365312e676966)[![](https://camo.githubusercontent.com/cfa67688db634473ec961bd9430a62f26d514c9b54d4f3230a75914458e6c3cd/68747470733a2f2f7777772e72756e6573636170652e636f6d2f696d672f7273703737372f686973636f7265732f736b696c6c5f69636f6e5f736c61796572312e676966)](https://camo.githubusercontent.com/cfa67688db634473ec961bd9430a62f26d514c9b54d4f3230a75914458e6c3cd/68747470733a2f2f7777772e72756e6573636170652e636f6d2f696d672f7273703737372f686973636f7265732f736b696c6c5f69636f6e5f736c61796572312e676966)[![](https://camo.githubusercontent.com/f8a600e582d2a52addef83253703548e620cc594d7cf157bedfb136387e3f727/68747470733a2f2f7777772e72756e6573636170652e636f6d2f696d672f7273703737372f686973636f7265732f736b696c6c5f69636f6e5f776f6f6463757474696e67312e676966)](https://camo.githubusercontent.com/f8a600e582d2a52addef83253703548e620cc594d7cf157bedfb136387e3f727/68747470733a2f2f7777772e72756e6573636170652e636f6d2f696d672f7273703737372f686973636f7265732f736b696c6c5f69636f6e5f776f6f6463757474696e67312e676966)[![](https://camo.githubusercontent.com/12a30dd0e53d9402b920d257aabab0dcc810919e0a956e27ab79cba38bfb7758/68747470733a2f2f7777772e72756e6573636170652e636f6d2f696d672f7273703737372f686973636f7265732f736b696c6c5f69636f6e5f666972656d616b696e67312e676966)](https://camo.githubusercontent.com/12a30dd0e53d9402b920d257aabab0dcc810919e0a956e27ab79cba38bfb7758/68747470733a2f2f7777772e72756e6573636170652e636f6d2f696d672f7273703737372f686973636f7265732f736b696c6c5f69636f6e5f666972656d616b696e67312e676966) Installation instructions ========================= [](#installation-instructions) `composer require bert-w/runescape-hiscores-api` Code Samples ------------ [](#code-samples) ### Retrieving player data [](#retrieving-player-data) ***Note**: It is important to define a user-agent as seen below, since the RuneScape website might throw errors if none is given.* ``` // OSRS $hiscores = new \BertW\RunescapeHiscoresApi\OSRSHiscores([ 'headers' => [ 'User-Agent' => 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.131 Safari/537.36', ], ]); // RS3 $hiscores = new \BertW\RunescapeHiscoresApi\RS3Hiscores([ 'headers' => [ 'User-Agent' => 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.131 Safari/537.36', ], ]); $player = $hiscores->player('someplayer'); ``` ### Get total level [](#get-total-level) ``` $totalLevel = $player->totalLevel(); // Returns (int). ``` ### Get all skills or minigames [](#get-all-skills-or-minigames) ``` $skills = $player->skills(); // Only available for OSRS: $minigames = $player->minigames(); ``` Results in the following array: ``` Array ( [0] => BertW\RunescapeHiscoresApi\HiscoreRow Object ( [icon] => [name] => Overall [rank] => 1 [level] => 2898 [experience] => 5600000000 [score] => [type] => skill ) [1] => BertW\RunescapeHiscoresApi\HiscoreRow Object ( [icon] => [name] => Attack [rank] => 263 [level] => 99 [experience] => 200000000 [score] => [type] => skill ) ... ) ``` ### Get a specific skill / minigame [](#get-a-specific-skill--minigame) ``` // Case insensitive skill or minigame search. To be certain, use the // exact name as used on the OSRS Hiscores page. $player->get('agility')->level; $player->get('Clue Scrolls (all)')->rank; // Returns a \BertW\RunescapeHiscoresApi\HiscoreRow object. ``` All properties on this `HiscoreRow` object are: - `$player->get('agility')->icon` (string|null) - URL to a skill icon that is also found on the hiscores page (like [![skill_icon_magic1](https://camo.githubusercontent.com/6291736590927e49899db625b7c548c45bcc72e5e1d38a3ca1c97aa6ba1dc56d/68747470733a2f2f7777772e72756e6573636170652e636f6d2f696d672f7273703737372f686973636f7265732f736b696c6c5f69636f6e5f6d61676963312e676966)](https://camo.githubusercontent.com/6291736590927e49899db625b7c548c45bcc72e5e1d38a3ca1c97aa6ba1dc56d/68747470733a2f2f7777772e72756e6573636170652e636f6d2f696d672f7273703737372f686973636f7265732f736b696c6c5f69636f6e5f6d61676963312e676966)). - `$player->get('agility')->name` (string) - Name of the skill or minigame as shown on the hiscores ("Agility", "Defence", "Runecraft") - `$player->get('agility')->rank` (int) { - Global ranking of this users' skill or minigame. - `$player->get('agility')->level` (int|null) - Level of the skill (`null` for minigames). - `$player->get('agility')->experience` (int|null) - Total experience of the skill (always `null` for minigames). - `$player->get('agility')->score` (int|null) - Total score of the minigame (always `null` for skills). ### List of OSRS skills [](#list-of-osrs-skills) ``` $player->get('Overall')->level; $player->get('Attack')->level; $player->get('Defence')->level; $player->get('Strength')->level; $player->get('Hitpoints')->level; // (differs from RS3 "Constitution") $player->get('Ranged')->level; $player->get('Prayer')->level; $player->get('Magic')->level; $player->get('Cooking')->level; $player->get('Woodcutting')->level; $player->get('Fletching')->level; $player->get('Fishing')->level; $player->get('Firemaking')->level; $player->get('Crafting')->level; $player->get('Smithing')->level; $player->get('Mining')->level; $player->get('Herblore')->level; $player->get('Agility')->level; $player->get('Thieving')->level; $player->get('Slayer')->level; $player->get('Farming')->level; $player->get('Runecraft')->level; // (differs from RS3 "Runecrafting") $player->get('Hunter')->level; $player->get('Construction')->level; ``` ### List of RS3 skills [](#list-of-rs3-skills) ``` $player->get('Overall')->level; $player->get('Attack')->level; $player->get('Defence')->level; $player->get('Strength')->level; $player->get('Constitution')->level; // (differs from OSRS "Hitpoints") $player->get('Ranged')->level; $player->get('Prayer')->level; $player->get('Magic')->level; $player->get('Cooking')->level; $player->get('Woodcutting')->level; $player->get('Fletching')->level; $player->get('Fishing')->level; $player->get('Firemaking')->level; $player->get('Crafting')->level; $player->get('Smithing')->level; $player->get('Mining')->level; $player->get('Herblore')->level; $player->get('Agility')->level; $player->get('Thieving')->level; $player->get('Slayer')->level; $player->get('Farming')->level; $player->get('Runecrafting')->level; // (differs from OSRS "Runecraft") $player->get('Hunter')->level; $player->get('Construction')->level; $player->get('Summoning')->level; $player->get('Dungeoneering')->level; $player->get('Divination')->level; $player->get('Invention')->level; $player->get('Archaeology')->level; ``` ### Health Score 36 — LowBetter than 82% of packages Maintenance41 Moderate activity, may be stable Popularity11 Limited adoption so far Community7 Small or concentrated contributor base Maturity70 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~116 days Recently: every ~301 days Total 16 Last Release 506d ago Major Versions v1.0.8 → v2.0.02021-08-30 v2.0.3 → v3.0.02022-03-10 PHP version history (2 changes)v1.0.0PHP ^7.2.5 v2.0.1PHP ^7.2|^8.0 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/10498595?v=4)[Bert](/maintainers/bert-w)[@bert-w](https://github.com/bert-w) --- Top Contributors [![bert-w](https://avatars.githubusercontent.com/u/10498595?v=4)](https://github.com/bert-w "bert-w (38 commits)") --- Tags runescapeosrshiscoresrs07 ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/bert-w-runescape-hiscores-api/health.svg) ``` [![Health](https://phpackages.com/badges/bert-w-runescape-hiscores-api/health.svg)](https://phpackages.com/packages/bert-w-runescape-hiscores-api) ``` ### Alternatives [spatie/crawler Crawl all internal links found on a website 2.8k16.3M52](/packages/spatie-crawler)[craftcms/cms Craft CMS 3.6k3.6M2.6k](/packages/craftcms-cms)[silverstripe/framework The SilverStripe framework 7213.5M2.5k](/packages/silverstripe-framework)[neuron-core/neuron-ai The PHP Agentic Framework. 1.8k245.3k20](/packages/neuron-core-neuron-ai)[spatie/laravel-export Create a static site bundle from a Laravel app 646127.9k5](/packages/spatie-laravel-export)[ec-cube/ec-cube EC-CUBE EC open platform. 78527.0k1](/packages/ec-cube-ec-cube) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)