GET/gosugamers/articleapiKey1 credit/request
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.
Required: id.
Sampled 29 Oct 2026: 1 item. Filled in every item: name, url. In the sample: name: “Timaugustin”; url: gosugamers.net.
Open in Playground
GET/gosugamers/articlesapiKey1 credit/request
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.
Optional: section (15 allowed values: dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india, entertainment, genshin-impact, honkai-star-rail, zenless-zone-zero, honor-of-kings, umamusume-pretty-derby), type (2 allowed values: news, features), page, page_size.
Sampled 29 Oct 2026: 40 items. Filled in every item: id, type, title, teaser, section, published_at, image_url, url. Not in every item: author (3). In the sample: published_at: 2025-06-22 to 2026-10-21; section: valorant (33), general (7); image_url: static.gosugamers.net; title: median 80 characters; teaser: median 83 characters; url: gosugamers.net.
Open in Playground
GET/gosugamers/encountersapiKey1 credit/request
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.
Required: game (9 allowed values: dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india), match_id, team1_id, team2_id.
Sampled 29 Oct 2026: 1 item. Filled in every item: id, game, start_time, tournament, finished, teams, url. In the sample: start_time: 2022-12-10; game: “valorant”; url: gosugamers.net; finished: true in 1 of 1; teams: median 2 entries.
Open in Playground
GET/gosugamers/gamesapiKey1 credit/request
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.
Takes no parameters.
Sampled 29 Oct 2026: 9 items. Filled in every item: slug, name. In the sample: name: “Dota 2” and 8 other values.
Open in Playground
GET/gosugamers/match-gameapiKey1 credit/request
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.
Required: game_id.
Sampled 29 Oct 2026: 3 items. Filled in every item: period, overtime, team1_score, team2_score. In the sample: period: 0 to 2, median 1; overtime: true in 1 of 3; team1_score: 5 to 6, median 6; team2_score: 6 to 7, median 6.
Open in Playground
GET/gosugamers/matchapiKey1 credit/request
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.
Required: game (9 allowed values: dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india), tournament_id, match_id.
Sampled 29 Oct 2026: 16 fields returned with a value. In the sample: start_time: 2026-10-27; best_of: 3; game: “valorant”; url: gosugamers.net; finished: true; game_numbers: 3 entries; tournament.name: “VCT Threshold China 2026”; round: “Round 1”.
Open in Playground
GET/gosugamers/matchesapiKey1 credit/request
Returns the next upcoming and currently live esports matches from GosuGamers, for one `game` or across all games, 10 per page by default and up to 100 with `page` and `page_size`: start time, tournament, stage, round, both teams and the match URL. `total_rows` reports how many matches the site lists. Use gosugamers-match with the returned tournament and match ids.
Optional: game (9 allowed values: dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india), page, page_size.
Sampled 29 Oct 2026: 5 items. Filled in every item: id, game, start_time, tournament, stage, round, group, match_number and 3 more. Not in every item: venue (3). In the sample: start_time: 2026-10-30 to 2026-10-31; group: Week 2 (3), Playoffs (2); match_number: 1 to 4, median 1; round: “Quarterfinals” and 3 other values; url: gosugamers.net; finished: true in 0 of 5; teams: median 2 entries; venue: “The Hub(虹桥天地), Shanghai, China”.
Open in Playground
GET/gosugamers/playerapiKey1 credit/request
Returns one GosuGamers player: in-game name, real name, country, GosuGamers Elo rating and world and regional ranking, win/loss/draw record and win rate, streak, career earnings in USD, social links, the current team and previous teams with join and leave dates. A player of a different game than `game` returns not found.
Required: game (9 allowed values: dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india), player_id.
Sampled 29 Oct 2026: 6 items. Filled in every item: team_id, name, tag, slug, position, joined_at, left_at. In the sample: joined_at: 2021-01-29 to 2023-08-29; name: “Ninjas in Pyjamas” and 4 other values; tag: “NiP” and 3 other values; left_at: 2021-01-30 to 2024-01-16.
Open in Playground
GET/gosugamers/rankingsapiKey2 credits/request
Returns the GosuGamers Elo team ranking for one `game`, globally or for one ranking region (`region_id`, taken from the `regions` list in the response; 0 is Global), with an optional team name prefix `q`: rank, team id, name, tag, Elo, previous rank and rank change. Paged with `page` and `page_size` (up to 100); `total_rows` reports the size of the ranking. A `region_id` that the game does not list returns an invalid-parameter error.
Required: game (9 allowed values: dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india). Optional: region_id, q, page, page_size.
Sampled 29 Oct 2026: 40 items. Filled in every item: rank, id, name, tag, slug, logo_url, url, elo and 3 more. In the sample: rank: 1 to 33, median 17; name: “100 Thieves” and 39 other values; logo_url: static.gosugamers.net; tag: “100T” and 39 other values; url: “/valorant/teams/37547-100-thieves” and 39 other values; elo: 1,013 to 1,255, median 1,042; previous_rank: 1 to 33, median 17.
Open in Playground
GET/gosugamers/resultsapiKey1 credit/request
Returns the most recent completed esports matches from GosuGamers, for one `game` or across all games, 10 per page by default and up to 100 with `page` and `page_size`, with final scores and winner flags. `total_rows` reports how many results the site lists. Use gosugamers-match with the returned ids for opponents, ranking and streams.
Optional: game (9 allowed values: dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india), page, page_size.
Sampled 29 Oct 2026: 40 items. Filled in every item: id, game, start_time, tournament, stage, round, group, match_number and 3 more. In the sample: start_time: 2026-10-08 to 2026-10-29; group: Playoffs (25), Week 1 (9), Week 2 (6); match_number: 1 to 4, median 2; round: “Quarterfinals” and 12 other values; url: gosugamers.net; finished: true in 40 of 40; teams: median 2 entries.
Open in Playground
GET/gosugamers/stage-groupsapiKey1 credit/request
Returns the groups (child tournaments) of one stage of a GosuGamers tournament, each with its format (for example Knockout), result type (for example Bracket), status, start time and the teams in it with ranking and country. Take `tournament_id` from gosugamers-tournaments or gosugamers-matches and `stage_id` from the stages list of gosugamers-tournament. An unknown stage, or a stage of another tournament, returns an empty list.
Required: tournament_id, stage_id.
Sampled 29 Oct 2026: 5 items. Filled in every item: id, name, format, result_type, status, start_time, participant_count, participants. In the sample: start_time: 2026-09-24 to 2026-10-07; participant_count: 4 to 8, median 4; name: “Group C” and 4 other values; participants: median 4 entries.
Open in Playground
GET/gosugamers/team-resultsapiKey1 credit/request
Returns the completed matches of one GosuGamers team, newest first, across the games it plays: start time, tournament, both teams with ids and final scores, winner flags and the match URL. Paged with `page` and `page_size` (up to 100, default 10); `total_rows` is the team's full history. An unknown team id returns an empty list. Take `team_id` from gosugamers-rankings, gosugamers-results or gosugamers-team.
Required: team_id. Optional: page, page_size.
Sampled 29 Oct 2026: 40 items. Filled in every item: id, game, start_time, tournament, finished, teams, url. In the sample: start_time: 2025-12-13 to 2026-10-17; url: gosugamers.net; finished: true in 40 of 40; teams: median 2 entries.
Open in Playground
GET/gosugamers/teamapiKey1 credit/request
Returns one GosuGamers team: name, tag, country, logo, GosuGamers Elo rating and world and regional ranking, win/loss/draw record and win rate, current streak, career earnings in USD, social links, the roster with join dates and the team's next upcoming matches. A team of a different game than `game` returns not found.
Required: game (9 allowed values: dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india), team_id.
Sampled 29 Oct 2026: 6 items. Filled in every item: id, name, slug, country_code, country, joined_at. In the sample: joined_at: 2024-01-16 to 2026-07-04; country: China (4), Taiwan (1), Singapore (1); name: “Spring” and 5 other values.
Open in Playground
GET/gosugamers/tournament-participantsapiKey1 credit/request
Returns the teams entered in one GosuGamers tournament: id, name, slug, logo, GosuGamers ranking, country and team URL. Both `game` and `tournament_id` are required; the upstream does not narrow the list by game, and an unknown tournament id returns an empty list. Take the tournament id from gosugamers-tournaments, gosugamers-matches or gosugamers-results and use a team id with gosugamers-team or gosugamers-team-results.
Required: game (9 allowed values: dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india), tournament_id.
Sampled 29 Oct 2026: 16 items. Filled in every item: id, name, slug, type, logo_url, url, ranking, country_name and 1 more. In the sample: ranking: 1 to 77, median 9; name: “100T” and 15 other values; logo_url: static.gosugamers.net; url: gosugamers.net; country_name: “United States” and 9 other values.
Open in Playground
GET/gosugamers/tournament-talentsapiKey1 credit/request
Returns the casters, hosts and analysts assigned to one GosuGamers tournament: id, name, game, roles, broadcast language code, country, image and profile URL. An unknown tournament id, or a tournament with no listed crew, returns an empty list. Take the tournament id from gosugamers-tournaments, gosugamers-matches or gosugamers-results.
Required: tournament_id.
Sampled 29 Oct 2026: 10 items. Filled in every item: id, name, slug, game, roles, language_code, country_name, country_code and 2 more. In the sample: country_name: United Kingdom (5), United States (4), Australia (1); name: “Frankie” and 9 other values; image_url: static.gosugamers.net; roles: median 1 entry; url: gosugamers.net.
Open in Playground
GET/gosugamers/tournamentapiKey1 credit/request
Returns one GosuGamers tournament: name, status, start time, description, LAN flag, venue and country, prize pool in USD when listed, sponsors, stages with their status and the next upcoming matches. A tournament that belongs to a different game than `game` returns not found.
Required: game (9 allowed values: dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india), tournament_id.
Sampled 29 Oct 2026: 3 items. Filled in every item: id, game, start_time, tournament, stage, round, group, match_number and 4 more. In the sample: start_time: 2026-10-30 to 2026-10-31; match_number: 1 to 4, median 3; game: “valorant”; url: gosugamers.net; finished: true in 0 of 3; teams: median 2 entries; stage: “Main Event”; round: “Quarterfinals” and 1 other value.
Open in Playground
GET/gosugamers/tournamentsapiKey1 credit/request
Lists GosuGamers esports tournaments, optionally for one `game` and one `state` (`all`, `ongoing`, `upcoming`, `past`), with an optional name prefix `q`: id, name, game, status, start time, prize pool with currency and USD value, participant count, featured flag and the tournament URL. Paged with `page` and `page_size` (up to 100); `total_rows` reports the size of the filtered list. Use gosugamers-tournament with a returned id and game for stages and upcoming matches.
Optional: game (9 allowed values: dota2, counterstrike, lol, valorant, mobile-legends, pubg-mobile, wild-rift, free-fire, battlegrounds-mobile-india), state (4 allowed values: all, ongoing, upcoming, past), q, page, page_size.
Sampled 29 Oct 2026: 40 items. Filled in every item: id, name, slug, game, game_name, status, start_time, featured and 3 more. Not in every item: prize_pool (31), prize_currency (31), prize_pool_usd (31). In the sample: start_time: 2026-05-04 to 2026-09-23; prize_currency: USD (16), MXN (5), EUR (3) and 4 more; prize_pool: 2,350 to 43,500,000, median 200,000; name: “VALORANT Champions 2026” and 39 other values; image_url: static.gosugamers.net; featured: true in 5 of 40; prize_pool_usd: 2,350 to 2,250,000, median 21,436.82; participant_count: 2 to 100, median 12.
Open in Playground
GosuGamers API endpoints