Could not verify request.


S2 Games is committed to providing the necessary information to help you build a great statistical web tool for your readers. To use the Statistics API requires that you first have a unique token keyed to your IP address. If you do not already have one, get your token.

If you have forgotten your token use the token lookup at the bottom of this page.

To access statistics requires knowledge of RESTful API which you can get at many places on the web. A good place to start is Wikipedia.


Only one token per IP address is allowed.


To get information requires formated queries submitted via Urls. This can be done using Curl in PHP. The HoN API only allows display actions in the form of GET requests. Requests are rate limited, meaning there is a specific number of requests we will allow over a brief period of time. Remember to replace spaces in your request with a "%20". Requests will look something like this:



https://api.heroesofnewerth.com/controller/model_method/property/property_value/another_property/another_value/?token=asdfjweric883af

Here is the specific information you may request:

Player Statistics

api.heroesofnewerth.com/player_statistics/ranked/accountid/123456/?token=yourtoken
api.heroesofnewerth.com/player_statistics/casual/accountid/123456/?token=yourtoken
api.heroesofnewerth.com/player_statistics/public/accountid/123456/?token=yourtoken
api.heroesofnewerth.com/player_statistics/all/accountid/123456/?token=yourtoken


api.heroesofnewerth.com/player_statistics/ranked/nickname/testor3/?token=yourtoken
api.heroesofnewerth.com/player_statistics/casual/nickname/testor3/?token=yourtoken
api.heroesofnewerth.com/player_statistics/public/nickname/testor3/?token=yourtoken
api.heroesofnewerth.com/player_statistics/all/nickname/testor3/?token=yourtoken


Hero Statistics

api.heroesofnewerth.com/hero_statistics/ranked/accountid/123456/heroid/14/?token=yourtoken
api.heroesofnewerth.com/hero_statistics/casual/accountid/123456/heroid/14/?token=yourtoken
api.heroesofnewerth.com/hero_statistics/public/accountid/123456/heroid/14/?token=yourtoken
api.heroesofnewerth.com/hero_statistics/all/accountid/123456/heroid/14/?token=yourtoken


api.heroesofnewerth.com/hero_statistics/ranked/nickname/testor3/heroid/14/?token=yourtoken
api.heroesofnewerth.com/hero_statistics/casual/nickname/testor3/heroid/14/?token=yourtoken
api.heroesofnewerth.com/hero_statistics/public/nickname/testor3/heroid/14/?token=yourtoken
api.heroesofnewerth.com/hero_statistics/all/nickname/testor3/heroid/14/?token=yourtoken


api.heroesofnewerth.com/hero_statistics/ranked/accountid/123456/name/Accursed/?token=yourtoken
api.heroesofnewerth.com/hero_statistics/casual/accountid/123456/name/Accursed/?token=yourtoken
api.heroesofnewerth.com/hero_statistics/public/accountid/123456/name/Accursed/?token=yourtoken
api.heroesofnewerth.com/hero_statistics/all/accountid/123456/name/Accursed/?token=yourtoken


api.heroesofnewerth.com/hero_statistics/ranked/nickname/testor3/name/Accursed/?token=yourtoken
api.heroesofnewerth.com/hero_statistics/casual/nickname/testor3/name/Accursed/?token=yourtoken
api.heroesofnewerth.com/hero_statistics/public/nickname/testor3/name/Accursed/?token=yourtoken
api.heroesofnewerth.com/hero_statistics/all/nickname/testor3/name/Witch%20Slayer/?token=yourtoken


Match History

api.heroesofnewerth.com/match_history/ranked/accountid/123456/?token=yourtoken
api.heroesofnewerth.com/match_history/casual/accountid/123456/?token=yourtoken
api.heroesofnewerth.com/match_history/public/accountid/123456/?token=yourtoken
api.heroesofnewerth.com/match_history/all/accountid/123456/?token=yourtoken


api.heroesofnewerth.com/match_history/ranked/nickname/testor3/?token=yourtoken
api.heroesofnewerth.com/match_history/casual/nickname/testor3/?token=yourtoken
api.heroesofnewerth.com/match_history/public/nickname/testor3/?token=yourtoken
api.heroesofnewerth.com/match_history/all/nickname/testor3/?token=yourtoken


Match

api.heroesofnewerth.com/match/settings/matchid/89520672/?token=yourtoken
api.heroesofnewerth.com/match/inventory/matchid/89520672/?token=yourtoken
api.heroesofnewerth.com/match/inventory/matchid/89520672/accountid/123456/?token=yourtoken
api.heroesofnewerth.com/match/inventory/matchid/89520672/nickname/testor3/?token=yourtoken
api.heroesofnewerth.com/match/statistics/matchid/89520672/?token=yourtoken
api.heroesofnewerth.com/match/statistics/matchid/89520672/accountid/123456/?token=yourtoken
api.heroesofnewerth.com/match/statistics/matchid/89520672/nickname/testor3/?token=yourtoken
api.heroesofnewerth.com/match/summ/matchid/89520672/?token=yourtoken
api.heroesofnewerth.com/match/all/matchid/89520672/?token=yourtoken
api.heroesofnewerth.com/match/all/matchid/89520672/accountid/123456/?token=yourtoken
api.heroesofnewerth.com/match/all/matchid/89520672/nickname/testor3/?token=yourtoken


Multi-Match

api.heroesofnewerth.com/multi_match/statistics/matchids/number+number+number/?token=yourtoken
api.heroesofnewerth.com/multi_match/all/matchids/number+number+number/?token=yourtoken


Heroes

api.heroesofnewerth.com/heroes/usage?token=yourtoken
api.heroesofnewerth.com/heroes/name/Hero_Accursed/?token=yourtoken
api.heroesofnewerth.com/heroes/id/2/?token=yourtoken
api.heroesofnewerth.com/heroes/all?token=yourtoken


Items

api.heroesofnewerth.com/items/name/Item_AcolytesStaff/?token=yourtoken
api.heroesofnewerth.com/items/id/2/?token=yourtoken
api.heroesofnewerth.com/items/all/?token=yourtoken
api.heroesofnewerth.com/items/usage/?token=yourtoken


api.heroesofnewerth.com/items/shop/all/?token=yourtoken
api.heroesofnewerth.com/items/shop/name/Shop_Weapons/?token=yourtoken
api.heroesofnewerth.com/items/shop/slot/1/?token=yourtoken






Note that the multi_match controller will allow up to 25 match submissions at a time. Take advantage of this leverage and find a way to gather stats efficiently.

If you've received a token, but subsequently lost it, you can look it up here:



Token Lookup
Enter IP address: