Esports schedule and results research
Usa los endpoints de GosuGamers para convertir esports schedule and results research en solicitudes API repetibles con inputs documentados y respuestas JSON.
Traducción en curso. Esta página se muestra temporalmente en inglés mientras se prepara la traducción al español.
Deportes y juegos17 endpoints activosapiKey
GosuGamers Esports API
Follow GosuGamers from cross-game competition records into dated news and features, keeping source IDs and bylines attached to each item.
Collect GosuGamers esports schedules, tournament and player records, plus its paged news and features archive with article text.
Familias de endpoints
6
Parámetros documentados
60
Ejemplos
17
Snapshot en vivo del catálogo
Cobertura de GosuGamers
Endpoints activos
17
Métodos
GET
Parámetros obligatorios
39
Referencias de esquema
17
Article1
Articles1
Encounters1
Games1
{
"platform": "GosuGamers",
"endpoint": "gosugamers-article",
"method": "GET",
"path": "/gosugamers/article",
"auth": "apiKey"
}Casos de uso
Workflows que encajan con GosuGamers
Collect GosuGamers esports schedules, tournament and player records, plus its paged news and features archive with article text.
Tournament, team, and player history
Usa los endpoints de GosuGamers para convertir tournament, team, and player history en solicitudes API repetibles con inputs documentados y respuestas JSON.
News and feature archive analysis
Usa los endpoints de GosuGamers para convertir news and feature archive analysis en solicitudes API repetibles con inputs documentados y respuestas JSON.
Ejecución gestionada
Cómo maneja Crawlora esta plataforma
Cada cifra de abajo se lee directamente del catálogo de endpoints en vivo de GosuGamers — 17 endpoints, 60 parámetros de solicitud documentados y 17 esquemas de respuesta publicados — el mismo catálogo contra el que corren Docs y Playground.
Documented endpoint coverage
17 documented GosuGamers endpoints, grouped into 17 request families — Article, Articles and Encounters, plus 14 more.
Published request surface
60 request parameters are documented across those GosuGamers endpoints, 39 of them required — the full input contract is public before you write any integration code.
Known response shape
17 of the 17 GosuGamers endpoints ship a recorded example response, and 17 carry a documented response schema — you can code against the real JSON before the first request.
Documented failure modes
GosuGamers endpoints document their error responses (400, 404, 429 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
Agent-callable MCP tools
17 hosted MCP tools back the GosuGamers endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Mapa de cobertura
Descubre qué puede recopilar la API antes de integrarla
1 endpoints
Article
/gosugamers/article
GETapiKey
1 endpoints
Articles
/gosugamers/articles
GETapiKey
1 endpoints
Encounters
/gosugamers/encounters
GETapiKey
1 endpoints
Games
/gosugamers/games
GETapiKey
1 endpoints
Match
/gosugamers/match
GETapiKey
1 endpoints
Match Game
/gosugamers/match-game
GETapiKey
Endpoints destacados
Endpoints de la API de GosuGamers
GETapiKeyexample
/gosugamers/articleGosuGamers article
Returns one GosuGamers news or features article by numeric id: type, title, teaser, section, publish and update times, headline image with caption, authors, the full text as plain text and related articles. An unknown id returns not found. Take `id` from gosugamers-articles.
Notas de la respuesta
- The response has `id`, `type` (`news` or `features`), `title`, `teaser`, `section`, `published_at`, `updated_at`, `image_url`, `image_caption`, `authors` (`name`, `url`), `text` (the article body as plain text, without markup), `related` (`id`, `title`, `section`, `url`) and `url`. - An id that does not exist returns `404`. - Read from the site's signed JSON API, which uses a public key the site ships in its own scripts; the service rediscovers it if the site rotates it. The response is cached for up to ten minutes.
Herramienta MCP gosugamers_article
x-api-key:headerid:query
GETapiKeyexample
/gosugamers/articlesGosuGamers news and features archive
Pages the GosuGamers news and features archive (51,051 articles), newest first, with optional `section` and `type` filters: id, type, title, teaser, section, publish time, author, image and URL. `section` is one of the 15 sections that carry articles (the six esports titles, Wild Rift, Free Fire, Battlegrounds Mobile India and the editorial sections entertainment, genshin-impact, honkai-star-rail, zenless-zone-zero, honor-of-kings and umamusume-pretty-derby); an article can belong to several sections. `type` is `news` or `features`. Paged with `page` and `page_size` (up to 100). Use gosugamers-article with a returned id for the text.
Notas de la respuesta
- Each article has `id`, `type` (`news` or `features`), `title`, `teaser`, `section` (the section it is filed under on the site), `published_at`, `author`, `image_url` and `url`. Use the `id` with [gosugamers-article](gosugamers-article.md) for the text. - `total_rows` and `total_pages` describe the filtered archive. A page past the end, and a section with no articles (`free-fire`, `battlegrounds-mobile-india`), return an empty `articles` list. - Section totals on 2026-10-29: `dota2` 12,018, `counterstrike` 4,357, `lol` 4,086, `entertainment` 3,869, `mobile-legends` 921, `valorant` 757, `genshin-impact` 170, `pubg-mobile` 156, `zenless-zone-zero` 140, `honor-of-kings` 110, `honkai-star-rail` 86, `wild-rift` 68, `umamusume-pretty-derby` 46. - Read from the site's signed JSON API, which uses a public key the site ships in its own scripts; the service rediscovers it if the site rotates it. The response is cached for up to five minutes.
Herramienta MCP gosugamers_articles
x-api-key:headersection:querytype:query+2 más
GETapiKeyexample
/gosugamers/encountersGosuGamers head-to-head meetings
Returns the other recorded meetings between two GosuGamers teams as seen from one match: tournament, start time, both teams with ids, tags and final scores, winner flags and the match URL. The given `match_id` itself is left out; `game` is required by the upstream but does not narrow the list. Take the ids from gosugamers-matches, gosugamers-results or gosugamers-rankings. Two teams with no other meeting return an empty list.
Notas de la respuesta
- Each meeting has `id`, `game`, `start_time`, `tournament` (`id`, `name`, `slug`), both `teams` (`id`, `name`, `tag`, `slug`, `logo_url`, `score`, `winner`) and `url`. `game` is the requested game, not a value read from the row. - The side order follows the upstream rather than your `team1_id`/`team2_id`; match teams by `id`. - Two teams with no other meeting, or ids that do not exist, return an empty `matches` list. There is no paging. - Read from the site's signed JSON API, which uses a public key the site ships in its own scripts; the service rediscovers it if the site rotates it. - The response is cached for up to ten minutes.
Herramienta MCP gosugamers_encounters
x-api-key:headergame:querymatch_id:query+2 más
GETapiKeyexample
/gosugamers/gamesGosuGamers game sections
Returns the game sections whose match pages this API reads: `dota2`, `counterstrike`, `lol`, `valorant`, `mobile-legends`, `pubg-mobile`, `wild-rift`, `free-fire` and `battlegrounds-mobile-india`, with display names. Use a slug as `game` in the other gosugamers endpoints.
Notas de la respuesta
- The slugs are the URL segments GosuGamers uses: `dota2`, `counterstrike`, `lol`, `valorant`, `mobile-legends`, `pubg-mobile`, `wild-rift`, `free-fire`, `battlegrounds-mobile-india`. - The set is the six sections in the site's game menu (checked 2026-10-27) plus `wild-rift`, `free-fire` and `battlegrounds-mobile-india`, which the site's sitemap lists with matches, results, tournaments, rankings and broadcast-talents pages (checked 2026-10-28). `free-fire` and `battlegrounds-mobile-india` currently have no matches, tournaments or rankings, so their lists come back empty. The editorial sections (`entertainment`, `genshin-impact`, `honkai-star-rail`, `zenless-zone-zero`, `honor-of-kings`, `umamusume-pretty-derby`) have no match pages and are not exposed.
Herramienta MCP gosugamers_games
x-api-key:header
GETapiKeyexample
/gosugamers/matchGosuGamers esports match detail
Returns one GosuGamers match: start time, tournament, stage, round, best-of, finished flag, both opponents with score, placement, world ranking and country, the number of games in the series and linked streams with language and viewer count. All of `game`, `tournament_id` and `match_id` are required; an id that does not belong to the stated tournament returns not found. Battle-royale titles can list more than two opponents. The `games` list gives each game's id for gosugamers-match-game.
Notas de la respuesta
- `games` lists each game of the series as `number` and `id`; pass an `id` as `game_id` to [gosugamers-match-game](gosugamers-match-game.md) for the map, picks, round scores and VODs. `game_numbers` is the same list of numbers only. - `opponents[].winner` is true for the series winner of a finished match. `world_ranking` is GosuGamers' own team ranking when it exists. - `streams[].platform_id` is GosuGamers' numeric stream platform code; `viewer_count` is omitted when unknown. - Battle-royale titles such as `pubg-mobile` list every squad in `opponents`. - An unknown match or a match from another tournament returns `404`. The response is cached for up to one minute.
Herramienta MCP gosugamers_match
x-api-key:headergame:querytournament_id:query+1 más
GETapiKeyexample
/gosugamers/match-gameGosuGamers single game (map) of a match
Returns one game of a GosuGamers match: the map, each team's score, side and first-pick flag, the picks or bans with the player (agents, heroes or champions where the title publishes them), the lineups, round or half scores (Counter-Strike and Valorant), every team's placement, kills and points for battle-royale games (PUBG Mobile) and VODs. Take `game_id` from the `games` list of gosugamers-match. Fields a title does not publish are empty. An unknown game id returns not found.
Notas de la respuesta
- `map` is the map or arena (`Summit`, `Ancient`, `Summoner's Rift`, `Tournament Version` seen). Each team has `score` (kills, rounds or points depending on the title), `placement`, `side`, `first_pick`, `winner`, `picks` and `lineup`. - `picks` list agents, heroes or champions with a `slot`, a `type` code and the `player` who played it where the title publishes that (Valorant did; League of Legends and Dota 2 games sampled had none). `side` is empty when the title has no sides data. - `rounds` are the period scores for round-based titles (`period` 0 and 1 are the halves, `overtime` marks extra periods; `team1_score` and `team2_score` follow the order of `teams`). It is empty for titles without rounds. - Battle-royale games (PUBG Mobile) have no two sides: `teams` is empty and `battle_royale_teams` lists every team with `placement`, `kills`, `placement_points`, `kill_points`, `points_addition`, `points_deduction`, `total_points`, `country_code` and its `players`. - `vods` list the recordings with a video id and host code; a game without VODs has an empty list. - Read from the site's signed JSON API, which uses a public key the site ships in its own scripts; the service rediscovers it if the site rotates it. - The response is cached for up to one minute.
Herramienta MCP gosugamers_match_game
x-api-key:headergame_id:query
APIs relacionadas
Más cobertura de deportes y juegos
Sports & Gaming
FanDuel Sportsbook
Browse public sports and event data from FanDuel Sportsbook. Discover market-specific event types, follow a league or schedule, and read the markets and prices FanDuel publishes for that event and market.
Sports & Gaming
FanDuel Racing
Follow public horse-racing cards across tracks and countries. Discover today's tracks, inspect races and runners, and read official results, wager-type reference data, and published pool information without placing a wager.
Sports & Gaming
FanDuel Research
Explore FanDuel Research's public editorial and sports-data surfaces. Discover sport slugs and teams, read articles and player updates, inspect live fixtures, and retrieve the published projection tables with their source-specific slate identifiers.
Cómo hacer scraping de GosuGamers
Extrae datos de GosuGamers en 5 pasos
GosuGamers describes itself as an esports and gaming publication founded in 2002, combining tournament coverage and analysis with data, news, and video; its about page names Counter-Strike, Dota 2, League of Legends, VALORANT, and Mobile Legends among its core games. Crawlora's 17 production-published routes cover both the competition database and editorial archive: match, tournament, team, and player records plus a paged news/features archive and single-article text. On 2026-10-29, the Dota 2 features query returned 1,348 rows across 450 pages; opening a returned article ID produced 4,555 characters of plain text with a byline URL. Article records can carry author metadata, but there is no separate author-profile or arbitrary byline-search route. A second pull on 2026-10-30 found nine game sections, 57 upcoming matches across twelve five-row pages, and 19 ongoing tournaments, led by the featured PGL Masters Bucharest 2026 (CS2, USD 1,250,000, 101 participants); the news-only archive held 47,048 rows. Keep game IDs with competition IDs, and retain each article's section and publication time.
- Paso 1
Separate competition games from editorial sections
/gosugamers/games supplies current game keys for competition routes. The article archive has its own section taxonomy, including entertainment and several game communities; do not assume every editorial section is a match-data game. Keep the section and game fields with the route that produced them.
- Paso 2
Page match and tournament snapshots
/gosugamers/matches, /gosugamers/results, and /gosugamers/tournaments accept page/page_size; the default is ten rows and page_size tops out at 100. Follow returned tournament.id, match.id, team IDs, and roster[].id values into the matching detail route with the same game slug where required. Prize pools carry prize_pool in the event's own currency plus prize_pool_usd: on 2026-10-30 the DFRAG Invitational 2026 listed 40,000 AUD and 28,879.14 USD, and the live Stake Ranked Episode 6 showed participant_count 0, so a zero is not a field size.
- Paso 3
Follow IDs through the hierarchy
Use tournament_id and match_id from a match or result row with /gosugamers/match; use tournament_id with /gosugamers/tournament. Team IDs from teams[] open /gosugamers/team, whose roster[].id values open /gosugamers/player. A numeric ID without the matching game may resolve to 404.
- Paso 4
Read Elo rankings with their regions
/gosugamers/rankings requires a game and returns rank, Elo, previous_rank and rank_change for every team in the 3,432-team Dota 2 table on 2026-10-30 (Team Yandex 1494, Team Spirit 1491, PARIVISION 1483). region_id comes from the response's own regions list, seven entries including 0 for Global. Compute movement from previous_rank: all five top rows carried rank_change 3 alongside rank_change_name Unchanged and a previous_rank equal to rank.
- Paso 5
Page the archive, then fetch article text
/gosugamers/articles accepts section, type=news|features, 1-based page, and page_size 1–100. Pass a returned article ID to /gosugamers/article for plain-text body, timestamps, author names/URLs, and related-story metadata; there is no separate author-profile or arbitrary byline-search route.
Preguntas frecuentes
Scraping de GosuGamers: preguntas frecuentes
Can I page through the archive?
Yes. The article archive and several match, tournament, ranking, and team-history lists accept page/page_size. Totals describe the filtered snapshot at retrieval time, not an immutable corpus.
Where do detail IDs come from?
Read tournament.id and match id from matches or results, team IDs from the returned teams array, and player IDs from a team's roster. Pass the same game slug with each required ID.
Does the API return article text?
Yes. Select a row from `/gosugamers/articles`, then pass its ID to `/gosugamers/article`; the detail response contains plain-text content, timestamps, author metadata, and a source URL.
Is rank_change a signed movement?
Not reliably. On 2026-10-30 every top-five Dota 2 row paired rank_change 3 with rank_change_name Unchanged and identical rank and previous_rank. Treat rank_change_name and the previous_rank difference as the movement, and keep the numeric field only as source metadata.
Does every article row have an author and a matching section?
No. The newest three news rows on 2026-10-30 included one with no author field, and a row whose section read gaming sat under an /entertainment/ URL. Filter with the documented section values, store the URL path with the row, and allow author to be absent.
Can I search for a writer or open an author profile?
No separate author-profile or byline-search operation is published. Article rows and detail responses can include author names and URLs as source metadata.