Docs menu

OpenDota API endpoint

OpenDota Item Directory API

Returns Dota 2 items from OpenDota's constants table as compact summaries (key, id, display name, quality, gold cost, behavior, cooldown, mana cost, components, active and passive abilities, numeric attributes), sorted by key. `q` searches the key and display name, `quality` filters by quality, and `qualities` lists the quality values present.

GETapiKey2 credits/requestOpenDota/opendota/items

Endpoint facts

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

OpenDota API for Dota 2 Data Try OpenDota Item Directory API in Playground OpenDota API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

q: optional case-insensitive search on the item key or display name.
quality: optional item quality; the values present today are artifact, common, component, consumable, consumable;laning, epic, rare and secret_shop. The response lists the live values in qualities, and any other value returns 400.
limit: optional number of items, 1 to 500; defaults to 50.

Notable response behavior:

Items with no quality (neutral items, recipes) have an empty quality. total counts every match before limit.
Descriptions of active and passive abilities are included; lore and long notes are not. The response is cached for up to one day.

Sampled response

Request, 29 Oct 2026: GET /opendota/items?q=blink&limit=40
Items in items: 8
Fields filled in every checked item: 2
Fields empty in some or all items: 8

Field	Filled in, of 8 checked	Values in the sample
key	8
id	8
name	7	“Arcane Blink” and 6 other values
quality	4	component in all 4
cost_gold	7	1,750 to 6,800, median 2,250
behavior	5	Point Target in all 5
cooldown	5	9 to 15, median 15
components	3	median 2 entries
abilities	4	median 1 entry
attributes	5	median 7 entries

Request parameters

Parameter	Type	Required	Default	Description
x-api-key (header)	string	Yes		API key required
q	string	No		Case-insensitive search on the item key or display name, for example blink
quality	string	No		Item quality from the qualities list in the response; currently artifact, common, component, consumable, consumable;laning, epic, rare, secret_shop
limit	integer	No	50	Number of items to return, 1 to 500; defaults to 50 Minimum: 1. Maximum: 500.

cURL example

curl -X GET "https://api.crawlora.net/api/v1/opendota/items?q=coffee&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://api.opendota.com/api/items",
    "fetched_at": "2026-10-28T10:00:00Z",
    "total": 1,
    "count": 1,
    "qualities": [
      "common",
      "component",
      "epic"
    ],
    "items": [
      {
        "key": "blink",
        "id": 1,
        "name": "Blink Dagger",
        "quality": "component",
        "cost_gold": 2250,
        "behavior": "Point Target",
        "cooldown": "15",
        "components": [],
        "abilities": [
          {
            "type": "active",
            "title": "Blink",
            "description": "Teleport to a target point up to 1200 units away."
          }
        ],
        "attributes": [
          {
            "key": "blink_range",
            "value": "1200"
          }
        ]
      }
    ]
  }
}

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.ItemsResponse	No
data.count	integer	No	50
data.fetched_at	string	No	2026-10-27T10:00:00Z
data.items	array	No
data.items[].abilities	array	No
data.items[].abilities[].description	string	No
data.items[].abilities[].title	string	No	Blink
data.items[].abilities[].type	string	No	active
data.items[].attributes	array	No
data.items[].attributes[].key	string	No	blink_range
data.items[].attributes[].value	string	No	1200
data.items[].behavior	string	No	Point Target
data.items[].components	array	No
data.items[].cooldown	string	No	15
data.items[].cost_gold	integer	No	2250
data.items[].id	integer	No	1
data.items[].key	string	No	blink
data.items[].mana_cost	string	No	0
data.items[].name	string	No	Blink Dagger
data.items[].quality	string	No	component
data.qualities	array	No
data.source_url	string	No
data.total	integer	No	501
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
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/items?q=coffee&limit=10" \
  -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 Item Directory API

GETapiKey2 credits/requestOpenDota/opendota/items

Endpoint facts

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

OpenDota API for Dota 2 Data Try OpenDota Item Directory API in Playground OpenDota API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

q: optional case-insensitive search on the item key or display name.
quality: optional item quality; the values present today are artifact, common, component, consumable, consumable;laning, epic, rare and secret_shop. The response lists the live values in qualities, and any other value returns 400.
limit: optional number of items, 1 to 500; defaults to 50.

Notable response behavior:

Items with no quality (neutral items, recipes) have an empty quality. total counts every match before limit.
Descriptions of active and passive abilities are included; lore and long notes are not. The response is cached for up to one day.

Sampled response

Request, 29 Oct 2026: GET /opendota/items?q=blink&limit=40
Items in items: 8
Fields filled in every checked item: 2
Fields empty in some or all items: 8

Field	Filled in, of 8 checked	Values in the sample
key	8
id	8
name	7	“Arcane Blink” and 6 other values
quality	4	component in all 4
cost_gold	7	1,750 to 6,800, median 2,250
behavior	5	Point Target in all 5
cooldown	5	9 to 15, median 15
components	3	median 2 entries
abilities	4	median 1 entry
attributes	5	median 7 entries

Request parameters

Parameter	Type	Required	Default	Description
x-api-key (header)	string	Yes		API key required
q	string	No		Case-insensitive search on the item key or display name, for example blink
quality	string	No		Item quality from the qualities list in the response; currently artifact, common, component, consumable, consumable;laning, epic, rare, secret_shop
limit	integer	No	50	Number of items to return, 1 to 500; defaults to 50 Minimum: 1. Maximum: 500.

cURL example

curl -X GET "https://api.crawlora.net/api/v1/opendota/items?q=coffee&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://api.opendota.com/api/items",
    "fetched_at": "2026-10-28T10:00:00Z",
    "total": 1,
    "count": 1,
    "qualities": [
      "common",
      "component",
      "epic"
    ],
    "items": [
      {
        "key": "blink",
        "id": 1,
        "name": "Blink Dagger",
        "quality": "component",
        "cost_gold": 2250,
        "behavior": "Point Target",
        "cooldown": "15",
        "components": [],
        "abilities": [
          {
            "type": "active",
            "title": "Blink",
            "description": "Teleport to a target point up to 1200 units away."
          }
        ],
        "attributes": [
          {
            "key": "blink_range",
            "value": "1200"
          }
        ]
      }
    ]
  }
}

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.ItemsResponse	No
data.count	integer	No	50
data.fetched_at	string	No	2026-10-27T10:00:00Z
data.items	array	No
data.items[].abilities	array	No
data.items[].abilities[].description	string	No
data.items[].abilities[].title	string	No	Blink
data.items[].abilities[].type	string	No	active
data.items[].attributes	array	No
data.items[].attributes[].key	string	No	blink_range
data.items[].attributes[].value	string	No	1200
data.items[].behavior	string	No	Point Target
data.items[].components	array	No
data.items[].cooldown	string	No	15
data.items[].cost_gold	integer	No	2250
data.items[].id	integer	No	1
data.items[].key	string	No	blink
data.items[].mana_cost	string	No	0
data.items[].name	string	No	Blink Dagger
data.items[].quality	string	No	component
data.qualities	array	No
data.source_url	string	No
data.total	integer	No	501
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
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/items?q=coffee&limit=10" \
  -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 Item 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 Item Directory API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related