Skip to main content
Join the official Python Developers Survey 2018 and win valuable prizes: Start the survey!

A Python 3 module wrapper for RuneScape 3 Clan's API

Project description

PyPI PyPI - Python Version Build Status

A Python 3 module wrapper for RuneScape 3 API


  • Python 3.6+

  • requests>=2.19.1


$ python3 -m pip install rs3clans



  • Creating a Player object
    • Always check if a player actually exists before doing anything with it
>>> from rs3clans import players
>>> player = players.Player(name='nriver')
>>> if player.exists:
...     pass
  • Whether the player exists or not
>>> player.exists
  • Whether his Runemetrics Profile is Private or not
>>> player.private_profile
  • You can also pass the argument runemetrics as False if you don't want their runemetrics info to be set
    • This will make you unable to use some attributes from the Player class
>>> player = players.Player(name='nriver', runemetrics=False)
  • Getting a player's name
    • (if his Runemetrics Profile is private it will return the same name passed when creating object)
  • Getting a player's total Exp (requires Public Runemetrics Profile)
>>> player.exp
  • Getting a player's Total Level (requires Public Runemetrics Profile)
>>> player.total_level
  • Getting a player's Combat Level (requires Public Runemetrics Profile)
>>> player.combat_level
  • Quests information about a player (requires Public Runemetrics Profile)
>>> player.quests_not_started
>>> player.quests_started
>>> player.quests_complete
  • Getting information on a specific skill of the player (requires Public Runemetrics Profile)
>>> player.skill('agility').level
  • Skill name is case-insensitive
>>> player.skill('AtTaCk').rank
  • Can pass skill names as well as id
    • (8 = Woodcutting for example)
>>> player.skill(8).exp
  • Getting a player's title
>>> player.title
'The Liberator'
  • Verifying if a player's title is a suffix or not
>>> player.suffix
  • Getting a player's clan
>>> player.clan


  • Creating a Clan object
    • Always check if a clan actually exists before doing anything with it
>>> from rs3clans import clans
>>> try:
...     clan = clans.Clan('Atlantis')
... except clans.ClanNotFoundError:
...     print('Clan not found.')
  • Getting a clan's total Exp
>>> clan.exp
  • Getting information about a specific member in that clan
    • Clan.member attribute (dict) (requires case-sensitive name)
    • Clan.get_member() (method) (does not require case-sensitive name)
>>> # Case-sensitive
>>> clan.member['NRiver']
{'rank': 'Overseer', 'exp': 1041963324}
>>> clan.member['NRiver']['rank']
>>> # Case-insensitive
>>> clan.get_member('nriver')
{'rank': 'Overseer', 'exp': 1041963324}
>>> clan.get_member('nRiVeR')['rank']
  • Getting the number of players in a clan
>>> clan.count
  • Getting the average Clan Exp per player in clan
>>> clan.avg_exp


  • Documentations are currently outdated because of issues with readthedocs that i can't be arsed to do band-aid fixes to "fix", use the examples above instead


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
rs3clans-1.0.2-py3-none-any.whl (10.0 kB) Copy SHA256 hash SHA256 Wheel py3 Oct 12, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page