Docs menu

OpenDota API endpoint

OpenDota team hero pool API

Returns the heroes a team has played with games, wins and win rate, sorted by games played. Heroes the team never played are omitted. An unknown team id returns not found.

GETapiKey1 credit/requestOpenDota/opendota/team-heroes

Endpoint facts

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

OpenDota API for Dota 2 Data Try OpenDota team hero pool API in Playground OpenDota API documentation

How this endpoint behaves

Returns a team's hero pool with games, wins and win rate.

Header: x-api-key required.

Parameters:

team_id: required positive OpenDota team id from opendota-teams or a match response.

Notable response behavior:

Sorted by games played; win_rate_percent is a percentage.
An unknown team returns 404; an existing team without games returns an empty list. The response is cached for up to one hour.

Sampled response

Request, 29 Oct 2026: GET /opendota/team-heroes?team_id=8255888
Items in heroes: 127
Fields filled in every checked item: 5

Field	Filled in, of 127 checked	Values in the sample
hero_id	127
localized_name	127	“Beastmaster” and 126 other values
games	127	1 to 144, median 45
wins	127	0 to 95, median 27
win_rate_percent	127	0 to 100, median 55.1

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required
team_id	integer	Yes		Positive OpenDota team ID from opendota-teams or a match response	8255888

cURL example

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

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://api.opendota.com/api/team-heroes",
    "fetched_at": "2026-10-28T10:00:00Z",
    "team_id": 8255888,
    "count": 1,
    "heroes": [
      {
        "hero_id": 38,
        "localized_name": "Beastmaster",
        "games": 144,
        "wins": 95,
        "win_rate_percent": 65.97
      }
    ]
  }
}

Request schema

No body schema

Response schema

Inline response schema

Field	Type	Required	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.TeamHeroesResponse	No
data.count	integer	No	127
data.fetched_at	string	No	2026-10-27T10:00:00Z
data.heroes	array	No
data.heroes[].games	integer	No	82
data.heroes[].hero_id	integer	No	17
data.heroes[].localized_name	string	No	Storm Spirit
data.heroes[].win_rate_percent	number	No	50
data.heroes[].wins	integer	No	41
data.source_url	string	No
data.team_id	integer	No	8255888
msg	unknown	No		Msg is the message that describes the result of the request @example "Request successful"

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
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/team-heroes?team_id=8255888" \
  -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 team hero pool API

Returns the heroes a team has played with games, wins and win rate, sorted by games played. Heroes the team never played are omitted. An unknown team id returns not found.

GETapiKey1 credit/requestOpenDota/opendota/team-heroes

Endpoint facts

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

OpenDota API for Dota 2 Data Try OpenDota team hero pool API in Playground OpenDota API documentation

How this endpoint behaves

Returns a team's hero pool with games, wins and win rate.

Header: x-api-key required.

Parameters:

team_id: required positive OpenDota team id from opendota-teams or a match response.

Notable response behavior:

Sorted by games played; win_rate_percent is a percentage.
An unknown team returns 404; an existing team without games returns an empty list. The response is cached for up to one hour.

Sampled response

Request, 29 Oct 2026: GET /opendota/team-heroes?team_id=8255888
Items in heroes: 127
Fields filled in every checked item: 5

Field	Filled in, of 127 checked	Values in the sample
hero_id	127
localized_name	127	“Beastmaster” and 126 other values
games	127	1 to 144, median 45
wins	127	0 to 95, median 27
win_rate_percent	127	0 to 100, median 55.1

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required
team_id	integer	Yes		Positive OpenDota team ID from opendota-teams or a match response	8255888

cURL example

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

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://api.opendota.com/api/team-heroes",
    "fetched_at": "2026-10-28T10:00:00Z",
    "team_id": 8255888,
    "count": 1,
    "heroes": [
      {
        "hero_id": 38,
        "localized_name": "Beastmaster",
        "games": 144,
        "wins": 95,
        "win_rate_percent": 65.97
      }
    ]
  }
}

Request schema

No body schema

Response schema

Inline response schema

Field	Type	Required	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.TeamHeroesResponse	No
data.count	integer	No	127
data.fetched_at	string	No	2026-10-27T10:00:00Z
data.heroes	array	No
data.heroes[].games	integer	No	82
data.heroes[].hero_id	integer	No	17
data.heroes[].localized_name	string	No	Storm Spirit
data.heroes[].win_rate_percent	number	No	50
data.heroes[].wins	integer	No	41
data.source_url	string	No
data.team_id	integer	No	8255888
msg	unknown	No		Msg is the message that describes the result of the request @example "Request successful"

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
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/team-heroes?team_id=8255888" \
  -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 team hero pool API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

OpenDota team hero pool API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related