View source for User:RJackson/Dota2API

{{ambox 
| image = Pictogram info.png
| contents = This API is not actively documented, under development, and not meant for public consumption.  It may change at any time without notice.
}}

Rough documentation for the Dota2.com API.  Data is returned in JSON format.

=== Global parameters ===
Parameters observed to be used on most methods:
:;{{API optional|l}}: For localized strings; takes English name of language (none of those fancy ISO distractions).
:;{{API optional|v}}: Unknown.

== itemdata ==
Data on gameplay (non-cosmetic) items.

<pre>GET http://www.dota2.com/jsfeed/itemdata</pre>

=== Result data ===
:;itemdata:
::;''item token'':
:::;id:
:::;img: Filename of the item's image, relative to <code>http://media.steampowered.com/apps/dota2/images/items/</code>
:::;dname: Item's display name.
:::;qual: Token representing item quality? Observed tokens:
::::;artifact:
::::;common:
::::;component:
::::;consumable:
::::;epic:
::::;rare:
::::;secret_shop:
:::;cost: Gold cost of the item.
:::;desc: Localized description.
:::;attrib: HTML representing the items attributes.
:::;mc: Mana cost
:::;cd: Cooldown
:::;lore: Localized item lore.
:::;components: List of tokens for items combine to create this item; returns list or null.
:::;created: Whether the item is created from components.

== abilitydata ==
Data on abilities.

<pre>GET http://www.dota2.com/jsfeed/abilitydata</pre>

=== Result data ===
:;abilitydata:
::;''Ability token'':
:::;dname: Display name
:::;affects: HTML noting target type, affected units, damage type.
:::;desc:
:::;dmg: HTML noting damage.
:::;attrib: HTML noting ability's attributes, e.g. radius, chances, stun duration.
:::;cmb: HTML noting cooldown and mana cost.
:::;lore:
:::;hurl: Hero URL, <code>http://dota2.com/hero/_hurl_/</code>

== heropickerdata ==
Data on heroes intended for the hero picker.
<pre>GET http://www.dota2.com/jsfeed/heropickerdata</pre>

=== Parameters ===
:;v: This parameter is required on this method, seems to accept any value.

=== Result data ===
:;''hero token'':
::;name: Localized name.
::;bio: Localied bio.
::;atk: Token representing attack type. Observed tokens:
:::*melee
:::*ranged
::;atk_l: Localized string representing attack type.
::;roles: List containing tokens representing hero roles.  Observed tokens:
:::*Disabler
:::*Nuker
:::*Support
:::*Escape
:::*Initiator
:::*LaneSupport
:::*Durable
:::*Carry
:::*Pusher
:::*Jungler
::;roles_l: List containing strings representing hero roles.  Doesn't appear to be localized.

== uniqueusers ==
<pre>GET http://www.dota2.com/jsfeed/uniqueusers</pre>

=== Result data ===
:;users_last_month:

== heropediadata ==
<pre>GET http://www.dota2.com/jsfeed/heropediadata</pre>

=== Parameters ===
:;feeds: Known values: itemdata, herodata, abilitydata.

=== Result data ===
==== itemdata feed ====
Returns same data as  [[#itemdata]]

==== abilitydata feed ====
Returns same data as  [[#abilitydata]]

==== herodata feed ====
;herodata:
:;''Hero token'':
::;dname: Hero's display name.
::;u: Hero token.
::;pa: Primary attribute.  Values:
:::*str:
:::*int:
:::*agi:
::;attribs:
:::;str:
::::;b: Base.
::::;g: Gain.
:::;int:
::::;b:
::::;g:
:::;agi:
::::;b:
::::;g:
:::;ms: Move speed.
:::;dmg: Starting damage.
::::;min:
::::;max:
:::;armor: Starting armour.
::;dac: Localized string for attack type, Melee or Ranged.
::;droles: Display string for roles.


== intlprizepool ==
The current size of The International 2013's prize pool.
<pre>GET http://www.dota2.com/jsfeed/intlprizepool</pre>

=== Result data ===
:;dollars: