Dotapedia transparency

APIs, sources, and feedback

Here you can find the API, links to source sites, and my contact details for feedback, suggestions, and comments. If you find a bug or have ideas for improving the site, I’ll certainly look into them. Thanks for using DotaPedia!
https://www.dotapedia.org

Public API

These read-only endpoints are available to the website and other clients. Numeric hero and item IDs are Dotapedia database IDs unless a response says otherwise.

GET/health

Checks database connectivity. Returns 200 when healthy or 503 when unavailable.

GET/api/heroes?page=1&pageSize=20

Returns a paginated hero catalog.page starts at 1; pageSize accepts 1–100.

GET/api/heroes/{id}

Returns one hero with profile, roles, base stats, rates, and media URLs.

GET/api/heroes/{id}/aghanim

Returns the hero’s Aghanim’s Scepter and Aghanim’s Shard upgrades.

GET/api/heroes/{id}/counterpicks

Returns cached favorable and unfavorable matchups for the selected hero.

GET/api/heroes/{id}/build

Returns cached starting, core, and popular items with timings and source metadata.

GET/api/items?group=&category=

Returns the item catalog. Optional group and category filters narrow the result.

GET/api/items/{itemId}/recipe

Returns an item and its recipe components or the upgrades that use it.

GET/api/leaderboards/{region}

Returns players for americas, europe, se_asia, or china.

Protected maintenance API

Hero creation, editing, and deletion require the private X-Admin-Key header and are not intended for anonymous clients. The key itself is never published.

POST/api/heroes/

Creates a validated hero record.

PUT/api/heroes/{id}

Replaces the editable data for an existing hero.

DELETE/api/heroes/{id}

Deletes a hero and returns 204 on success.

Data sources

Dotapedia stores and normalizes source data so ordinary page loads use the local database instead of repeatedly querying third-party sites.

Valve · Dota 2

Official English hero localization, Aghanim text, and regional leaderboard data.

Visit Dota 2

Valve · Steam CDN

Hero, ability, and item artwork; Steam Community country flags appear in rankings.

Visit Dota 2 on Steam

Dotabuff

Public hero meta statistics and matchup information used by counter picks.

Visit Dotabuff

Dota2ProTracker

High-level and professional-match item build trends and item timings.

Visit Dota2ProTracker

OpenDota

Public match data used to calculate hero-specific starting-item popularity.

Visit OpenDota

OpenDota dotaconstants

Open-source constants used to identify and normalize the item catalog.

View dotaconstants

Jina Reader

A read-only extraction bridge used when a source page has no suitable structured endpoint.

Visit Jina Reader

Independent project: Dotapedia is not affiliated with or endorsed by Valve, Dotabuff, Dota2ProTracker, OpenDota, or Jina AI. Dota and Dota 2 are trademarks of Valve Corporation. Source availability and update times may vary.

Contact

Project owner Apelsinka

Email: apelsinkadev@gmail.com

Discord: apelsikpa

Steam: https://steamcommunity.com/profiles/76561199208698486/