GET/vlr/event-agentsapiKey1 credit/request
Returns the agent pick-rate matrix of one VLR.gg event: for the whole event and for each map, the number of games, the attack-side and defense-side round win rates and the share of games in which each agent was played. Also returns, per map, each team's agents used and the agents picked in each of its matches (compositions). Use it to see an event's meta; vlr-stats gives per-player agent usage.
Required: id.
Sampled 29 Oct 2026: 8 fields returned with a value. In the sample: overall.games: 39; agents: 29 entries; overall.attack_win_percent: 49; overall.defense_win_percent: 51; overall.pick_rates: 29 entries; maps: 7 entries; compositions: 7 entries.
Open in Playground
GET/vlr/event-matchesapiKey1 credit/request
Returns every match of one VLR.gg event (upcoming, live and completed) with teams, scores, stage and whether stats or VODs exist. Use vlr-match with a returned `id` for map detail.
Required: id. Optional: series_id, group (2 allowed values: completed, upcoming).
Sampled 29 Oct 2026: 22 items. Filled in every item: id, url, date, time_label, status, eta, teams, event and 3 more. In the sample: date: 2026-10-21 to 2026-11-01; status: completed (17), upcoming (5); time_label: “12:00 AM” and 9 other values; url: vlr.gg; has_stats: true in 17 of 22; teams: median 2 entries; eta: “1w 1d” and 17 other values; event: Week 1 (11), Week 2 (11).
Open in Playground
GET/vlr/event-statsapiKey1 credit/request
Returns the player statistics table of one VLR.gg event (rating, ACS, K:D, KAST, ADR, per-round rates, first kills, clutches, totals) for every player who appeared, optionally for one `side` (`all`, `t` attack, `ct` defend). For league-wide filtered statistics use vlr-stats.
Required: id. Optional: side (3 allowed values: all, t, ct), role, agent, map, stage, min_rounds, sort, dir (2 allowed values: desc, asc).
Sampled 29 Oct 2026: 66 items. Filled in every item: player, agents, agent_usage, maps, rounds, acs, kd, kills_per_round and 7 more. In the sample: maps: 3 to 10, median 7; agents: median 3 entries; agent_usage: median 3 entries; rounds: 65 to 221, median 138; acs: 142 to 279, median 200; kd: 0.64 to 1.61, median 0.94; kills_per_round: 0.45 to 1.02, median 0.69; assists_per_round: 0.08 to 0.52, median 0.25.
Open in Playground
GET/vlr/eventapiKey1 credit/request
Returns one VLR.gg event: name, series, dates, prize, location and the participating teams with ids. Use vlr-event-matches for its matches and vlr-team for a team.
Required: id.
Sampled 29 Oct 2026: 12 items. Filled in every item: id, name, logo_url, url. In the sample: name: “Rare Atom” and 11 other values; logo_url: owcdn.net; url: vlr.gg.
Open in Playground
GET/vlr/eventsapiKey1 credit/request
Returns Valorant events from VLR.gg: ongoing, upcoming and completed events with prize pool, dates and region flag. Filter by `tier` (`all`, `vct`, `vcl`, `t3`, `gc`, `cg`, `off`) and `region` (`all`, `americas`, `emea`, `pacific`, `china`); `page` pages through completed events. Use vlr-event with a returned `id`.
Optional: tier (7 allowed values: all, vct, vcl, t3, gc, cg, off), region (5 allowed values: all, americas, emea, pacific, china), page.
Sampled 29 Oct 2026: 73 items. Filled in every item: id, name, url, status, prize, dates, country_code, image_url. In the sample: status: completed (50), upcoming (22), ongoing (1); name: “VCT 2026: China Threshold” and 72 other values; url: vlr.gg; prize: TBD (31), $0 (21), $250,000 (11) and 4 more; dates: “Oct 21—Nov 1” and 67 other values; image_url: owcdn.net.
Open in Playground
GET/vlr/forum-categoriesapiKey1 credit/request
Returns the VLR.gg forum directory: each category with slug, name, group, description, thread and post counts and the last poster, time and thread. `slug` is one of `valorant-discussion`, `off-topic`, `site-feedback`; use it as `category` in vlr-forum-threads.
Takes no parameters.
Sampled 29 Oct 2026: 3 items. Filled in every item: slug, name, group, description, threads, posts, last_poster, last_post_time and 1 more. In the sample: threads: 3,566 to 578,533, median 61,856; name: “Valorant Discussion” and 2 other values; group: “Valorant” and 1 other value; description: “Anything and everything Valorant” and 2 other values; posts: 35,627 to 5,550,214, median 889,911; last_post_time: “Oct 30, 2026 at 00:07 IST” and 1 other value.
Open in Playground
GET/vlr/forum-threadsapiKey1 credit/request
Returns a page (30) of VLR.gg forum threads, newest activity first, for one `category` (`valorant-discussion`, `off-topic`, `site-feedback`) or the combined list: title, reply count, pinned flag, category, author, post age, frags (score) and the last poster. Thread titles and usernames are public community content; thread bodies and replies are not returned.
Optional: category (3 allowed values: valorant-discussion, off-topic, site-feedback), page, sort (3 allowed values: hot, new, top).
Sampled 29 Oct 2026: 29 items. Filled in every item: id, url, title, replies, pinned, category, category_name, author and 3 more. Not in every item: frags (1). In the sample: replies: 1 to 30, median 6; url: vlr.gg; pinned: true in 0 of 29.
Open in Playground
GET/vlr/match-economyapiKey2 credits/request
Returns the Economy tab of one VLR.gg match for every map and for the whole match: each team's pistol rounds, pistol conversion and bonus-round records, win records by buy level (`eco` under 10k, `half` 10k to 18k, `full` 18k and over) against each opponent buy level, and round by round banks, loadout values, buy levels, the winner and the winning side. `available` is false while VLR has not published the tab, which is normal for a match that just ended.
Required: id.
Sampled 29 Oct 2026: 4 items. Filled in every item: game_id, map_number, map, teams, buy_buckets, rounds. In the sample: map_number: 1 to 4, median 2; map: “Summit” and 3 other values; teams: median 2 entries; buy_buckets: median 3 entries; rounds: median 25 entries.
Open in Playground
GET/vlr/match-performanceapiKey2 credits/request
Returns the Performance tab of one VLR.gg match for every map and for the whole match: player-versus-player kill matrices (overall kills and deaths, first kills and deaths, and Operator kills and deaths) and per-player advanced stats (2K to 5K multi-kills, 1v1 to 1v5 clutches, econ rating, spike plants and defuses). `available` is false while VLR has not published the tab.
Required: id.
Sampled 29 Oct 2026: 10 items. Filled in every item: player, agent, multikills_2k, multikills_3k, multikills_4k, multikills_5k, clutches_1v1, clutches_1v2 and 6 more. In the sample: multikills_2k: 6 to 18, median 11; multikills_3k: 1 to 7, median 2; multikills_4k: 0 to 1, median 0; multikills_5k: 0 to 1, median 0; clutches_1v1: 0 to 2, median 1; clutches_1v2: 0 to 1, median 0; econ_rating: 43 to 60, median 50; plants: 0 to 11, median 3.
Open in Playground
GET/vlr/match-roundsapiKey3 credits/request
Returns the round log (the 2D replay data) of one VLR.gg match for every map that has one: for each round the score after it, the winner, the attacking team, every player's agent, credits left, spend, armor and weapon, and the ordered events (kills with weapon, spike plants and defuses) with their round clock. `available` is false when VLR has no replay for the match.
Required: id.
Sampled 29 Oct 2026: 1 item. Filled in every item: game_id, map_number, map, rounds. In the sample: map: “Summit”; rounds: median 24 entries.
Open in Playground
GET/vlr/matchapiKey2 credits/request
Returns one VLR.gg match: event and stage, exact UTC start time, status (`final`, `live`, `upcoming`), format such as `Bo3`, both teams with series score, the pick/ban note, and every map with picker, round scores split into attack, defend and overtime, duration and per-player lines (agents, rating, ACS, K/D/A, KAST, ADR, headshot percent, first kills and deaths). `all_maps_players` holds the aggregate across maps. Also returns the teams' head-to-head history and each team's recent results. Player fields are omitted when VLR has not published them yet. Use vlr-match-economy, vlr-match-performance and vlr-match-rounds for the economy, kill-matrix and round-by-round tabs.
Required: id.
Sampled 29 Oct 2026: 10 items. Filled in every item: id, name, team, country_code, agents, acs, kills, deaths and 2 more. In the sample: team: UR (5), VLG (5); acs: 157 to 226, median 204; name: “Hopedawn” and 9 other values; agents: median 2 entries; kills: 42 to 65, median 58; deaths: 48 to 67, median 57; assists: 12 to 43, median 17; kd_diff: -16 to 12, median 1.
Open in Playground
GET/vlr/matchesapiKey1 credit/request
Returns the Valorant match schedule from VLR.gg: upcoming and live matches grouped by day with both teams, country flags, event, stage, ETA and whether stats or VODs exist. `status` is `upcoming`, `live` or `completed`. `time_label` is the time shown on the site, whose timezone is not guaranteed; use vlr-match for an exact UTC start time. Use vlr-results for finished matches.
Optional: page.
Sampled 29 Oct 2026: 9 items. Filled in every item: id, url, date, time_label, status, eta, teams, event and 3 more. In the sample: date: 2026-10-30 to 2026-11-01; event: VCT 2026: China Threshold (5), Game Changers 2026: Championshi… (4); time_label: “5:00 AM” and 5 other values; url: vlr.gg; has_stats: true in 0 of 9; teams: median 2 entries; eta: “14h 21m” and 8 other values; series: “Week 2–Quarterfinals” and 6 other values.
Open in Playground
GET/vlr/news-articleapiKey1 credit/request
Returns one VLR.gg news article: title, author, UTC publish time, the body as plain-text paragraphs, the teams, players and events it links to (type `team`, `player` or `event`, with id, slug and name), external links and image URLs. Reader comments are not included. Forum threads share the same numeric id space, so an id that is a thread, or does not exist, returns not found. Take `id` from vlr-news.
Required: id.
Open in Playground
GET/vlr/newsapiKey1 credit/request
Returns the latest Valorant esports news headlines from VLR.gg, 30 per page, with title, summary line, date, author and country flag. Page back through older news with `page`.
Optional: page.
Sampled 29 Oct 2026: 30 items. Filled in every item: id, url, title, description, date, author, country_code. In the sample: date: 2026-10-22 to 2026-10-29; url: vlr.gg; title: median 51 characters; description: median 66 characters.
Open in Playground
GET/vlr/player-matchesapiKey1 credit/request
Returns a player's match history from VLR.gg, 50 per page, newest first: event, stage, the player's team and opponent, series score, win or loss and date. Use vlr-match with a returned `id` for the player's map statistics.
Required: id. Optional: page.
Sampled 29 Oct 2026: 50 items. Filled in every item: id, url, event, stage, team, opponent, score, result and 1 more. In the sample: team: Team Vitality (49), BBL Esports (1); event: “Champions 2026” and 8 other values; url: vlr.gg; stage: “Playoffs ⋅ GF” and 35 other values; opponent: “LOUD” and 29 other values; score: “1:3” and 9 other values; result: win (32), loss (18); date: “2026/10/18” and 48 other values.
Open in Playground
GET/vlr/playerapiKey1 credit/request
Returns one VLR.gg player: alias, real name, country, social links, agent-by-agent statistics (use, rounds, rating, ACS, K:D, KAST, ADR, KPR, APR and first kills), current and past teams and recent results.
Required: id. Optional: timespan (4 allowed values: all, 30d, 60d, 90d).
Sampled 29 Oct 2026: 5 items. Filled in every item: agent, use, rounds, rating, acs, kd, kast_percent, adr and 8 more. In the sample: rounds: 18 to 137, median 122; use: “(6) 29%” and 3 other values; rating: 0.45 to 1.3, median 0.95; acs: 125 to 257.5, median 206.5; kd: 0.38 to 1.43, median 1.04; kast_percent: 61 to 78, median 71; adr: 89.3 to 167.1, median 128.8; kills_per_round: 0.33 to 0.94, median 0.74.
Open in Playground
GET/vlr/rankingsapiKey2 credits/request
Returns VLR.gg's team ranking for one region: rank, team, country, rating, record, streak, earnings and last match. `region` is one of north-america, europe, brazil, asia-pacific, korea, china, japan, la-s, la-n, oceania, mena, gc, collegiate. `limit` returns the top 1 to 250 teams (default 50).
Optional: region (13 allowed values: north-america, europe, brazil, asia-pacific, korea, china, japan, la-s, la-n, oceania, mena, gc, collegiate), limit.
Sampled 29 Oct 2026: 40 items. Filled in every item: rank, team, country, rating, streak, record, earnings, last_match_id. In the sample: rank: 1 to 40, median 20; country: “Europe” and 10 other values; rating: 1,562 to 2,000, median 1,636; streak: “1L” and 10 other values; record: “32–17” and 38 other values; earnings: “$579,736” and 37 other values.
Open in Playground
GET/vlr/resultsapiKey1 credit/request
Returns completed Valorant matches from VLR.gg, newest first, 50 per page, with final series scores, winner flags, event, stage and whether stats or VODs are listed. For a completed match `eta` is the time since it ended. Use vlr-match with a returned `id` for map-by-map player statistics.
Optional: page.
Sampled 29 Oct 2026: 50 items. Filled in every item: id, url, date, time_label, status, eta, teams, event and 3 more. In the sample: date: 2026-10-18 to 2026-10-29; event: VCT 2026: China Threshold (17), Project Blender 2026 (15), Game Changers 2026: Championshi… (14) and 2 more; time_label: “8:00 AM” and 28 other values; url: vlr.gg; has_stats: true in 50 of 50; teams: median 2 entries; eta: “6h 46m” and 30 other values; series: “Week 2–Quarterfinals” and 18 other values.
Open in Playground
GET/vlr/searchapiKey1 credit/request
Searches VLR.gg for teams, events and players by name and returns every match on one page: kind, id, name, canonical URL and logo, plus the event date range and prize pool and, for retired teams, the `inactive` flag and the team that replaced them (`successor`). `type` limits the search to `teams`, `events` or `players`; the default `all` returns all three groups with per-group counts. Use the returned id with vlr-team, vlr-event or vlr-player.
Required: q. Optional: type (4 allowed values: all, teams, events, players).
Sampled 29 Oct 2026: 3 items. Filled in every item: kind, id, name, url, image_url. In the sample: kind: “team”; url: vlr.gg; name: “Sentinels” and 2 other values; image_url: owcdn.net and 1 other host.
Open in Playground
GET/vlr/statsapiKey2 credits/request
Returns VLR.gg's player statistics table (100 rows per page): agents played, maps, rounds, rating, ACS, K:D, KAST, ADR, KPR, APR, first-kill and clutch rates and totals. Filter with comma-separated `tier` (vct, vcl, t3, gc, cg, off), `region` (americas, emea, pacific, china, intl), `role` (controller, initiator, sentinel, duelist), `agent` and `map` names, plus `timespan` (all, 30d, 60d, 90d or a season year from 2020 up to the current year), `side` (all, t, ct), `min_rounds` and `min_rating`; sort with `sort` and `dir`.
Optional: tier, region, timespan, side (3 allowed values: all, t, ct), role, agent, map, min_rounds, from, to, min_rating (8 allowed values: 0, 1300, 1400, 1500, 1550, 1650, 1750, 1850), sort (21 allowed values: rating, maps, rnd, acs, kd, kast, adr, kpr, apr, fkfd, fkpr, fdpr, hsp, clp, cl, kmax, k, d, a, fk, fd), dir (2 allowed values: asc, desc), page.
Sampled 29 Oct 2026: 11 items. Filled in every item: player, agents, agent_usage, maps, rounds, acs, kd, adr and 11 more. Not in every item: rating (10), kast_percent (10), headshot_percent (10), clutch_percent (7), clutches_won (7), clutches_total (7). In the sample: maps: 5 to 18, median 6; agents: median 1 entry; agent_usage: median 1 entry; rounds: 113 to 380, median 141; rating: 0.79 to 1.29, median 1.01; acs: 175 to 276, median 235; kd: 0.88 to 1.47, median 1.12; kast_percent: 65 to 76, median 71.
Open in Playground
GET/vlr/team-mapsapiKey2 credits/request
Returns a team's per-map record from VLR.gg: maps played, win percent, wins and losses, plus attack-side and defense-side round win percent, rounds won and lost and first-round counts. Use it to compare map strengths; vlr-team-matches lists the underlying matches.
Required: id.
Sampled 29 Oct 2026: 13 items. Filled in every item: map, played, win_percent, wins, losses, attack, defense. In the sample: played: 6 to 80, median 45; map: “Bind” and 12 other values; win_percent: 44 to 100, median 62; wins: 4 to 48, median 20; losses: 0 to 36, median 14.
Open in Playground
GET/vlr/team-matchesapiKey1 credit/request
Returns a team's complete match history from VLR.gg, 50 per page, newest first: event, stage, opponent, series score, win or loss and date. Use vlr-match with a returned `id` for map detail, or vlr-team for the roster.
Required: id. Optional: page, group (2 allowed values: completed, upcoming).
Sampled 29 Oct 2026: 50 items. Filled in every item: id, url, event, stage, team, opponent, score, result and 1 more. In the sample: result: win (32), loss (18); event: “Champions 2026” and 8 other values; url: vlr.gg; stage: “Playoffs ⋅ GF” and 35 other values; opponent: “LOUD” and 29 other values; score: “1:3” and 8 other values; date: “2026/10/18” and 48 other values.
Open in Playground
GET/vlr/teamapiKey1 credit/request
Returns one VLR.gg team: name, tag, country, links, the roster (players with captain flag, plus coach, manager and analyst staff, each with a player id) and recent matches with scores and results, plus related news. Use vlr-player with a roster `id`.
Required: id.
Sampled 29 Oct 2026: 7 items. Filled in every item: id, alias, real_name, country_code, role, image_url. In the sample: alias: “Jamppi” and 6 other values; image_url: owcdn.net; role: “captain” and 4 other values.
Open in Playground
VLR API endpoints