Developer Resources from RuneHead

At RuneHead we support the developers of other sites and tools. For example, you're free to make look up bots for IRC which will tell the IRC users which clan a person is in, or maybe a quick little script to find the statistics of a clan, in fact, we would like to encourage you to do so if you feel that it's a needed feature for your bot/script/program! We do ask however that, instead of eating up our (and your own) bandwidth and processing power, you'll use one of our "easy to explode" feeds which you can find below. Being professional programmers ourselves, we understand the need for feeds which are easy to parse with scripting languages like mIRC scripting and PHP, so if you have a suggestion or addition to this page, please feel free to contact us and we'll look at it.

Currently we offer a clan search and a user search as "lowtech" feeds (see below).

Clan Search

If you wish to retrieve clan information from the RuneHead Hiscores Catalogue about a clan, this is the feed for you. The feed brings back information in this manner:

@@start
Clan name|Website url|Meberlist url|Type|Initials|Number of members|Average combat|Average hitpoints|Average skill total|Average magic|Average ranged|F2P/P2P based|Time based|Cape colour|Homeworld
@@end

Looks rather complicated, doesn't it? Well, the bright side this that you can simply explode/split the string by each |, and you should get your results rather easily. If there's more than one clan found, each clan will be separated by a newline (character 10 in acsii pre). The url you need to use to get the information is http://runehead.com/feeds/lowtech/searchclan.php?search={clan_name}, which takes an optional parameter, namely &type= which can be 1 or 2. By default, the script will return only results marked as clans in the database, but if you set &type=1, it'll return only non-clans, and with &type=2 it'll return both clans and non-clans, and if it's left blank or set to anything other than 1 or 2, only clans will be returned.

Another feature this feed brings you is that it'll automatically search for whether or not the given search string are initials or a clan name. For example, ?search=DI would return the Damage Inc list(s), as would ?search=Damage%20Inc (%20 is the default character for spaces in URL's). If the script finds clans with the initials of the search string, it wont search for clans which has the search string in it's name.

So let's get down to it, examples of use and returns (Damage Inc used as default example here):

http://runehead.com/feeds/lowtech/searchclan.php?search=DI

Would return

@@start
Damage Incorporated|http://www.DI-RS.com|http://www.runehead.com/clans/ml.php?clan=DIML|clan|DI|132|124.39|98.85|1762|95.16|91.72|F2P & P2P|America & Europe|blue|114
dark infernal|http://z8.invisionfree.com/dark_infernal/|http://www.runehead.com/clans/ml.php?clan=00_zian_00|clan|DI|9|60.31|48.22|653|34.89|32.89|F2P|America|black|20
Damage Inc Warlords List|http://www.di-rs.com/forums/|http://www.runehead.com/clans/ml.php?clan=Oversold0|clan|DI|17|125.16|98.59|1880|96.88|94.94|F2P & P2P|America|green|0
@@end

Remember the format? Let's take the first return, Damage Incorporated is the name, http://www.DI-RS.com the website url, http://www.runehead.com/clans/ml.php?clan=DIML the memberlist url, clan is the clan type, DI the initials, 132 is the number of members, 124.39 would be the average combat, 98.85 the average hitpoints, 1762 the average skill total, 95.16 the average magic level, 91.72 the average range level, F2P & P2P is their base, American & Europe their time base, blue their cape colour and 114 their homeworld.

If we set &type=1 we'll get a non-clan with the initials of DI:

http://runehead.com/feeds/lowtech/searchclan.php?search=DI&type=1

Would return

@@start
Damage Inc and Fa|http://www.di-rs.com/forums/|http://www.runehead.com/clans/ml.php?clan=Di_and_Fa|non-clan|Di|191|123.81|98.58|1747|94.85|90.49|F2P & P2P|America & Europe|blue|114
@@end

And, with &type=2, you'll get them all:

http://runehead.com/feeds/lowtech/searchclan.php?search=DI&type=2

Would return

@@start
Damage Incorporated|http://www.DI-RS.com|http://www.runehead.com/clans/ml.php?clan=DIML|clan|DI|132|124.39|98.85|1762|95.16|91.72|F2P & P2P|America & Europe|blue|114
Damage Inc and Fa|http://www.di-rs.com/forums/|http://www.runehead.com/clans/ml.php?clan=Di_and_Fa|non-clan|Di|191|123.81|98.58|1747|94.85|90.49|F2P & P2P|America & Europe|blue|114
dark infernal|http://z8.invisionfree.com/dark_infernal/|http://www.runehead.com/clans/ml.php?clan=00_zian_00|clan|DI|9|60.31|48.22|653|34.89|32.89|F2P|America|black|20
Damage Inc Warlords List|http://www.di-rs.com/forums/|http://www.runehead.com/clans/ml.php?clan=Oversold0|clan|DI|17|125.16|98.59|1880|96.88|94.94|F2P & P2P|America|green|0
@@end

Play with it, and please feel free to contact us if you have any ideas, changes or corrections to this feed

If nothing is found, or the search string is left empty, you'll see the following:

@@start
@@Not Found
@@end

User Search

In addition to the above, you can also search for which clans/non-clans a user is a member of. To do this, we've made a lowtech feed in the same style as the clan search, easily splitable by |, with each resulting clan on it's own line.

The url you need to use to get the information is http://runehead.com/feeds/lowtech/searchuser.php?user={user_name}, which takes an optional parameter, namely &type= which can be 1 or 2. By default, the script will return only results marked as clans in the database, but if you set &type=1, it'll return only non-clans, and with &type=2 it'll return both clans and non-clans, and if it's left blank or set to anything other than 1 or 2, only clans will be returned.

The return is like so:

@@start
Clan Name|Clan Website
@@end

For example, searching for Zezima (note that high profile names like Zezima are added to a lot of spam lists. We do our best to keep our lists clean, but we're only robots.. Erhm, humans...):

http://runehead.com/feeds/lowtech/searchuser.php?user=zezima

Would return

@@start
The Forgotten Legion|http://www.theforgottenlegion.co.nr
Slayers of Chaos|http://z6.invisionfree.com/The_Slayers_of_Chaos/
Anzacs MB Pking Team|http://z6.invisionfree.com/Anzacs/index.php?act=idx
The Holy Kingdom|http://www.NoneATM.com
gloryofpures|http://z4.invisionfree.com/gloryofpures
@@end

And, adding &type=1 will bring us some non-clan results

http://runehead.com/feeds/lowtech/searchuser.php?user=zezima&type=1

Would return

@@start
99 Hunter|http://www.runescape.com
99 Runecrafters|http://www.runescape.com
LVL 99 Crafters|http://z6.invisionfree.com/Lvl_99_Crafters
99 Construction|http://
RSHelp|http://runeboards.com/forum/
dragonslayers|http://www.runescape.com
@@end

Or if you want them all, we add &type=2

http://runehead.com/feeds/lowtech/searchuser.php?user=zezima&type=2

Would return

@@start
The Forgotten Legion|http://www.theforgottenlegion.co.nr
99 Hunter|http://www.runescape.com
99 Runecrafters|http://www.runescape.com
LVL 99 Crafters|http://z6.invisionfree.com/Lvl_99_Crafters
99 Construction|http://
Slayers of Chaos|http://z6.invisionfree.com/The_Slayers_of_Chaos/
Anzacs MB Pking Team|http://z6.invisionfree.com/Anzacs/index.php?act=idx
RSHelp|http://runeboards.com/forum/
The Holy Kingdom|http://www.NoneATM.com
gloryofpures|http://z4.invisionfree.com/gloryofpures
dragonslayers|http://www.runescape.com
@@end

Play with it, and please feel free to contact us if you have any ideas, changes or corrections to this feed

If nothing is found, or the search string is left empty, you'll see the following:

@@start
@@Not Found
@@end