Docs menu

OpenDota API endpoint

OpenDota hero directory API

Returns the live OpenDota hero lookup needed to resolve `hero_id` values in live and detailed match responses. It includes every current hero ID with its internal name, localized name, primary attribute (`agi`, `all`, `int`, or `str`) and attack type (`Melee` or `Ranged`).

GETapiKey1 credit/requestOpenDota/opendota/heroes

Endpoint facts

Method: GET
API path: /opendota/heroes
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: OpenDota

OpenDota API for Dota 2 Data Try OpenDota hero directory API in Playground OpenDota API documentation

How this endpoint behaves

Returns OpenDota's current hero lookup for resolving hero_id values in live and detailed match responses.

Header: Crawlora x-api-key required; no OpenDota API key is needed upstream.

Parameters: none.

Notable response behavior:

The response contains every current hero supplied by OpenDota. The set and count may change with game updates.
primary_attr has these values: agi, all, int, str.
attack_type has these values: Melee, Ranged.
The endpoint caches the directory for up to 24 hours.

Sampled response

Request, 28 Oct 2026: GET /opendota/heroes
Items in heroes: 127
Fields filled in every checked item: 5

Field	Filled in, of 127 checked
id	127
name	127
localized_name	127
primary_attr	127
attack_type	127

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/opendota/heroes" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://api.opendota.com/api/heroes",
    "fetched_at": "2026-10-27T09:50:00Z",
    "count": 2,
    "heroes": [
      {
        "id": 1,
        "name": "npc_dota_hero_antimage",
        "localized_name": "Anti-Mage",
        "primary_attr": "agi",
        "attack_type": "Melee"
      },
      {
        "id": 138,
        "name": "npc_dota_hero_muerta",
        "localized_name": "Muerta",
        "primary_attr": "int",
        "attack_type": "Ranged"
      }
    ]
  }
}

Request schema

No body schema

Response schema

Inline response schema

Field	Type	Required	Enum	Example	Description
code	integer	No			Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
data	opendota.HeroesResponse	No
data.count	integer	No		127
data.fetched_at	string	No		2026-10-27T10:00:00Z
data.heroes	array	No
data.heroes[].attack_type	string	No	Melee, Ranged	Melee
data.heroes[].id	integer	No		93
data.heroes[].localized_name	string	No		Slark
data.heroes[].name	string	No		npc_dota_hero_slark
data.heroes[].primary_attr	string	No	agi, all, int, str	agi
data.source_url	string	No
msg	unknown	No			Msg is the message that describes the result of the request @example "Request successful"

Failure responses

Status	Description	Schema
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/opendota/heroes" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More OpenDota endpoint docs OpenDota API for Dota 2 Data OpenDota Ability Directory API documentation OpenDota Benchmarks API documentation OpenDota constants lookup API documentation OpenDota matches by hero lineup API documentation OpenDota Hero Abilities API documentation OpenDota Aghanim descriptions API documentation

Open in Playground Back to group

Docs menu

OpenDota API endpoint

OpenDota hero directory API

GETapiKey1 credit/requestOpenDota/opendota/heroes

Endpoint facts

Method: GET
API path: /opendota/heroes
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: OpenDota

OpenDota API for Dota 2 Data Try OpenDota hero directory API in Playground OpenDota API documentation

How this endpoint behaves

Returns OpenDota's current hero lookup for resolving hero_id values in live and detailed match responses.

Header: Crawlora x-api-key required; no OpenDota API key is needed upstream.

Parameters: none.

Notable response behavior:

The response contains every current hero supplied by OpenDota. The set and count may change with game updates.
primary_attr has these values: agi, all, int, str.
attack_type has these values: Melee, Ranged.
The endpoint caches the directory for up to 24 hours.

Sampled response

Request, 28 Oct 2026: GET /opendota/heroes
Items in heroes: 127
Fields filled in every checked item: 5

Field	Filled in, of 127 checked
id	127
name	127
localized_name	127
primary_attr	127
attack_type	127

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/opendota/heroes" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://api.opendota.com/api/heroes",
    "fetched_at": "2026-10-27T09:50:00Z",
    "count": 2,
    "heroes": [
      {
        "id": 1,
        "name": "npc_dota_hero_antimage",
        "localized_name": "Anti-Mage",
        "primary_attr": "agi",
        "attack_type": "Melee"
      },
      {
        "id": 138,
        "name": "npc_dota_hero_muerta",
        "localized_name": "Muerta",
        "primary_attr": "int",
        "attack_type": "Ranged"
      }
    ]
  }
}

Request schema

No body schema

Response schema

Inline response schema

Field	Type	Required	Enum	Example	Description
code	integer	No			Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
data	opendota.HeroesResponse	No
data.count	integer	No		127
data.fetched_at	string	No		2026-10-27T10:00:00Z
data.heroes	array	No
data.heroes[].attack_type	string	No	Melee, Ranged	Melee
data.heroes[].id	integer	No		93
data.heroes[].localized_name	string	No		Slark
data.heroes[].name	string	No		npc_dota_hero_slark
data.heroes[].primary_attr	string	No	agi, all, int, str	agi
data.source_url	string	No
msg	unknown	No			Msg is the message that describes the result of the request @example "Request successful"

Failure responses

Status	Description	Schema
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/opendota/heroes" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

OpenDota hero directory API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

OpenDota hero directory API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related