{"id":13411269,"url":"https://github.com/iocodz/dota2-free-data-api","last_synced_at":"2026-01-23T04:40:07.834Z","repository":{"id":45973618,"uuid":"514965612","full_name":"iocodz/dota2-free-data-api","owner":"iocodz","description":"Dota2 free data API.","archived":false,"fork":false,"pushed_at":"2023-01-06T01:04:34.000Z","size":57,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-07-31T20:45:28.718Z","etag":null,"topics":["dota2","dota2-api","netlify-functions"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iocodz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-07-17T22:04:36.000Z","updated_at":"2023-03-04T21:02:33.000Z","dependencies_parsed_at":"2023-02-05T01:15:53.250Z","dependency_job_id":null,"html_url":"https://github.com/iocodz/dota2-free-data-api","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iocodz%2Fdota2-free-data-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iocodz%2Fdota2-free-data-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iocodz%2Fdota2-free-data-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iocodz%2Fdota2-free-data-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iocodz","download_url":"https://codeload.github.com/iocodz/dota2-free-data-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243618579,"owners_count":20320261,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dota2","dota2-api","netlify-functions"],"created_at":"2024-07-30T20:01:12.566Z","updated_at":"2026-01-23T04:40:07.778Z","avatar_url":"https://github.com/iocodz.png","language":"JavaScript","funding_links":[],"categories":["Web Applications"],"sub_categories":["Desktop"],"readme":"---\ndescription: \u003e-\n  Documentación de la API de Dota2.\n---\n\n[![Netlify Status](https://api.netlify.com/api/v1/badges/3e86324e-6ef3-4652-970f-f5c8de8095e5/deploy-status)](https://app.netlify.com/sites/dota-pro/deploys)\n\n# Referencia de la API\n\n## Introducción\n\nLa API se expone en el siguiente URL: [https://dota-pro.netlify.app/api](https://dota-pro.netlify.app/api)\n\n### Usando esta API podrás obtener:\n\n* Listado de póximos torneos.\n* Listado de próximos partidos.\n* Listado de equipos profesionales.\n* Equipo con su roster actual, mayores logros, ganancias estimadas.\n* Listado actualizado de héroes.\n* Listado actualizado de ítems.\n\n## Tipos\n\nLos objetos que maneja la API están definidos en los siguientes tipos:\n\n### HeroType\n\n`HeroType` define un héroe.\n\n| Campo | Tipo de dato | Descripción |\n| :--- | :--- | :--- |\n| `id` | `String` | Identificador del héroe |\n| `name` | `String` | Nombre del héroe |\n| `image` | `String` | Imagen del héroe HD |\n\n### ItemType\n\n`ItemType` define un ítem.\n\n| Campo | Tipo de dato | Descripción |\n| :--- | :--- | :--- |\n| `id` | `String` | Identificador del ítem |\n| `name` | `String` | Nombre del ítem |\n| `image` | `String` | Imagen del ítem |\n| `price` | `Number` | Costo del ítem |\n\n### PlayerType\n\n`PlayerType` define un jugador.\n\n| Campo | Tipo de dato | Descripción |\n| :--- | :--- | :--- |\n| `id` | `String` | Identificador del jugador |\n| `name` | `String` | Nombre del jugador |\n| `country` | `String` | País del jugador |\n| `position` | `String` | Logo del jugador |\n\n### TeamType\n\n`TeamType` define un equipos.\n\n| Campo | Tipo de dato | Descripción |\n| :--- | :--- | :--- |\n| `id` | `String` | Identificador del equipo |\n| `name` | `String` | Nombre del equipo |\n| `image` | `String` | Logo del equipo |\n| `country` | `String` | País del equipo |\n| `created` | `String` | Fecha de fundación del equipo |\n| `totalWinnings` | `String` | Ganancias estimadas del equipo |\n| `activeRoster` | `[PlayerType]` | Roster actual del equipo |\n\n### TournamentType\n\n`TournamentType` define un torneo.\n\n| Campo | Tipo de dato | Descripción |\n| :--- | :--- | :--- |\n| `id` | `String` | Identificador del torneo |\n| `name` | `String` | Nombre del torneo |\n| `image` | `String` | Logo del torneo |\n| `tier` | `String` | Nivel competitivo del torneo |\n| `date` | `String` | Fecha de Inicio |\n| `prize` | `String` | Premio total del torneo |\n| `location` | `String` | Localización del torneo |\n\n\n### MatchType\n\n`MatchType` define un partido.\n\n| Campo | Tipo de dat | Descripción |\n| :--- | :--- | :--- |\n| `firstTeam` | `TeamType` | Primer equipo |\n| `secondTeam` | `TeamType` | Segundo equipo |\n| `tournament` | `TournamentType` | Torneo |\n| `startDate` | `String` | Fecha de inicio |\n| `status` | `String` | Tipo de partida / Estado |\n\n## Consultas\n\nLa API permite realizar diferentes consultas que por el momento son públicas. En el futuro requeriremos una llave API para consumir los diferentes endpoints.\n\n### Heroes\n\nEl endpoint `heroes` permite consumir los héroes. El endpoint devuelve un `[HeroType]` codificado en formato JSON.\n\n#### Query\n\n```js\nlet response = await fetch(`${BASE_API_URL}/heroes`)\n```\n\n#### Response\n\n```json\n{\n  \"data\": {\n    \"heroes\": [\n      {\n        \"id\": \"Anti_Mage\",\n        \"name\": \"Anti-Mage\",\n        \"image\": \"http://cdn.dota2.com/apps/dota2/images/heroes/antimage_full.png\",\n      }\n    ]\n  }\n}\n```\n\n### Ítems\n\nEl endpoint `items` permite consumir los ítems del juego. El endpoint devuelve un `[ItemType]` codificado en formato JSON.\n\n#### Query\n\n```js\nlet response = await fetch(`${BASE_API_URL}/items`)\n```\n\n#### Response\n\n```json\n{\n  \"data\": {\n    \"items\": [\n      {\n        \"id\": \"Blink_Dagger\",\n        \"name\": \"Blink Dagger\",\n        \"price\": 2250,\n        \"image\": \"http://cdn.dota2.com/apps/dota2/images/items/blink_lg.png\"\n      }\n    ]\n  }\n}\n```\n\n### Matches\n\nEl endpoint `matches` permite consumir las partidas en vivo y las próximas. El endpoint devuelve un `[MatchType]` codificado en formato JSON.\n\n#### Query\n\n```js\nlet response = await fetch(`${BASE_API_URL}/matches`)\n```\n\n#### Response\n\n```json\n{\n  \"data\": [\n    {\n      \"firstTeam\": {\n        \"id\": \"Hokori\",\n        \"name\": \"HKR\",\n        \"image\": \"/commons/images/thumb/d/d0/Hokori_2021_allmode.png/50px-Hokori_2021_allmode.png\"\n      },\n      \"secondTeam\": {\n        \"id\": \"Arkosh_Gaming\",\n        \"name\": \"Arkosh\",\n        \"image\": \"/commons/images/thumb/c/c6/Arkosh_Gaming_allmode.png/53px-Arkosh_Gaming_allmode.png\"\n      },\n      \"tournament\": {\n        \"id\": \"FISSURE/Bitcoin_Series/1\",\n        \"name\": \"TP Bitcoin Series\"\n      },\n      \"startDate\": \"2022-07-18T21:00:00.000Z\",\n      \"status\": \"0:0(Bo3)\"\n    }\n  ]\n}\n```\n\n### Teams\n\nEl endpoint `teams` permite consumir los equipos en activo. El endpoint devuelve un `[TeamType]` codificado en formato JSON.\n\n#### Query\n\n```js\nlet response = await fetch(`${BASE_API_URL}/teams`)\n```\n\n#### Response\n\n```json\n{\n  \"data\": {\n    \"teams\": [\n      {\n        \"id\": \"OG\",\n        \"name\": \"OG\",\n        \"image\": \"/commons/images/thumb/7/70/OG_RB_allmode.png/34px-OG_RB_allmode.png\"\n      }\n    ]\n  }\n}\n```\n\n### Team\n\nEl endpoint `teams?id=id` permite consumir la informacion de un equipos según su id. El endpoint devuelve un `TeamType` codificado en formato JSON.\n\n#### Query\n\n```js\nlet response = await fetch(`${BASE_API_URL}/teams?id=OG`)\n```\n\n#### Response\n\n```json\n{\n  \"data\": {\n    \"teams\": [\n      {\n        \"id\": \"OG\",\n        \"name\":\"OG\",\n        \"country\":\"Europe\",\n        \"created\":\"2015-10-31\",\n        \"totalWinnings\":\"$35,191,685\",\n        \"activeRoster\":[\n          {\n            \"id\":\"Yuragi\",\n            \"name\":\"(Artem Golubiev)\",\n            \"country\":\"Ukraine\",\n            \"position\":\"Position:Â 1\",\n            \"joinDate\":\"2021-11-21[37]\"\n          }\n        ],\n        \"archivements\":[\n          {\n            \"place\":\"AA1st\",\n            \"date\":\"2022-05-22\",\n            \"tournament\":{\n              \"id\":\"Dota_Pro_Circuit\",\n              \"name\":\"Dota Pro Circuit\",\n              \"logo\":\"/commons/images/8/8a/ESL_One_2019_new_icon.png\"\n            },\n            \"prize\":\"$200,000\"\n          }\n        ]\n      }\n    ]\n  }\n}\n```\n\n### Tournaments\n\nEl endpoint `tournaments` permite consumir los próximos torneos. El endpoint devuelve un `[TournamentType]` codificado en formato JSON.\n\n#### Query\n\n```js\nlet response = await fetch(`${BASE_API_URL}/tournaments`)\n```\n\n#### Response\n\n```json\n{\n  \"data\": {\n    \"tournaments\": [\n      {\n        \"id\":\"The_International/2022\",\n        \"tier\":\"Tier 1\",\n        \"name\":\"The International 2022\",\n        \"image\":\"/commons/images/thumb/b/ba/Dota2_Aegis_allmode.png/50px-Dota2_Aegis_allmode.png\",\n        \"date\":\"Oct 15 - 30, 2022\",\n        \"prize\":\"$1,600,000\",\n        \"location\":\"Singapore\"\n      }\n    ]\n  }\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiocodz%2Fdota2-free-data-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiocodz%2Fdota2-free-data-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiocodz%2Fdota2-free-data-api/lists"}