# Valorant & CS2 Match Data API – Round-by-Round Esports Timeline (`tubetext/esports-match-timeline`) Actor

Get Valorant and CS2 match data from broadcast VOD links (YouTube, Twitch). Returns one row per round: map, round number, score after the round, winner and VOD timestamp, plus map and match rows; optional VLR.gg check. $1.00 per VOD hour ($0.25 per 15 min); unreadable VODs are free. · by TubeText

- **URL**: https://apify.com/tubetext/esports-match-timeline.md
- **Developed by:** [TubeText Labs](https://apify.com/tubetext) (community)
- **Categories:** Videos, AI, Other
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $180.00 / 1,000 video processed (per started 15 minutes)s

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Valorant & CS2 Match Data API – Round-by-Round Esports Timeline

> **TubeText** · Esports & sports data · Pay per result. No login. Ready for AI agents. [All tools](https://apify.com/tubetext)

### Quick start (no coding)

1. Click **Try for free** at the top of this page. A free Apify account is enough – it includes monthly credit.
2. In **Broadcast VOD links**, paste one YouTube or Twitch VOD link of a Valorant or CS2 match per line.
3. Click **Start**. About 10 minutes per VOD hour. To test quickly, set **Start at** / **End at** to one map.
4. When it says **Succeeded**, open the **Output** tab and click **Export** → **Excel** (or CSV). One row per round (map, round, score after the round, winner, VOD timestamp), plus one row per map and one per match.

**Cost:** $0.25 per started 15 minutes of video processed ($1.00 per VOD hour) – one 45-minute map ≈ $0.75. VODs that can't be opened are free.

**Common mistakes**

- CS2 winners show as "A"/"B" → add the two team names in **Team names**.
- A round is missing → it ended while the broadcast showed a replay; it's counted in `gapBefore`, never guessed.
- A live stream link → not supported yet; use the VOD after the match.

**Questions or problems?** [Open an issue](https://apify.com/tubetext/esports-match-timeline/issues) (we read every one). **Need a custom version?** Ask in an issue or [email us](mailto:tubettext@gmail.com) – we build it as a private Actor on Apify.

### Use from Claude, Cursor or any MCP client

Add `https://mcp.apify.com?tools=tubetext/esports-match-timeline` as a remote MCP server and sign in to Apify (Claude: **Settings → Connectors → Add custom connector**). Claude Code:

```bash
claude mcp add --transport http tubetext "https://mcp.apify.com?tools=tubetext/esports-match-timeline"
```

Then ask, for example: *"Get the round-by-round score of every map in this Valorant VOD: \[link]"* or *"List the VOD timestamps where each map of this CS2 final starts, with the final scores: \[link]"*

🆓 **Free to try:** Apify's free plan includes $5 of usage every month, no credit card needed – enough for about 5 VOD hours with this tool.

**What you get** – real output from a test run, shortened. One row per round (plus map and match rows) – here map 2 of VIT vs 100T, VALORANT Champions Lower Final:

| Map | Round | Score | Winner | VOD time |
|---|---|---|---|---|
| Summit | 1 | VIT 1 – 0 100T | VIT | 0:47:12 |
| Summit | 4 | VIT 2 – 2 100T | 100T | 0:52:00 |
| Summit | 11 | VIT 6 – 5 100T | VIT | 1:07:27 |

### Valorant and CS2 match data API

Call it from your back end with the Apify API. One request runs the Actor and returns the rows as JSON:

```bash
curl -X POST "https://api.apify.com/v2/acts/tubetext~esports-match-timeline/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H 'Content-Type: application/json' -d '{"videoUrls":["https://www.youtube.com/watch?v=MZjaOtjtRlU"],"startSeconds":2690,"endSeconds":3590}'
```

- **Big batches:** Processing takes about 10 minutes per VOD hour and the sync endpoint waits up to 5 minutes, so sync calls suit short windows (one map or less, via `startSeconds`/`endSeconds`). For full VODs, start the run with `POST /v2/acts/tubetext~esports-match-timeline/runs` and a webhook, then fetch the dataset.
- **Monitoring:** Tournament coverage: schedule the run after each match day with the new VOD links; every round row has a VOD timestamp to link back to. Add an Apify webhook to get notified when each run finishes.
- **Cost at volume:** 20 VOD hours a month ≈ $20 at the free-plan price ($0.25 per started 15 minutes). VODs that can't be opened are free.
- **Stable output:** field names don't change between runs. Failed or empty items come back as status rows that aren't billed, and every row has `charged: true/false`.
- **Why not the official API:** Official game APIs don't cover pro broadcasts round by round for every event. This reads the broadcast scoreboard itself, so it works on VODs of events without a public data feed.

### What does Esports Match Timeline do?

Paste the link of a **Valorant or CS2 broadcast VOD** on YouTube or Twitch and get the match as data: **one row per round** with the map, round number, **score after the round**, the round winner and **the second in the VOD where it happened**, plus a summary row per map and per match. It reads the scoreboard that the broadcast shows on screen, so it isn't limited to events with an official data feed: we tested it on global, regional and Twitch productions (see Accuracy). No login, no game API key.

### Who it's for

- **Analysts and coaches**: jump straight to round 14 of map 2 in a long VOD, or build a round-by-round dataset of an opponent's recent series for review.
- **Researchers**: momentum, comeback and pacing studies across many matches, with every round tied to a VOD timestamp you can check.
- **Media and content teams**: timestamped chapters and highlight lists for long broadcasts, and score graphs for recaps.
- **Developers and AI agents**: one call returns structured match progress (see the API section).

### What data can you get?

- 🎯 **Round rows**: `map`, `mapName`, `round`, `scoreA`, `scoreB`, `winner`, `firstSeenAt` (seconds) and `firstSeenAtHms` ("0:52:00"), `gapBefore` (rounds the broadcast didn't show before this one), `inferred` (true when a round was worked out rather than seen) and `evidenceFrames`.
- 🗺️ **Map rows**: final score, `winner`, start and end time in the VOD, `roundsSeen` vs `roundsTotal`, `gapRounds`, `finalInferred`, `mapComplete`, and `validation` when you give a VLR.gg link.
- 🏆 **Match row**: maps played, maps won per team, frames read and `hudCoverage` (the share of sampled frames where the score HUD was visible).
- ✅ **Optional check against VLR.gg** (Valorant): paste the match page and each map's rounds are compared with VLR's round history.

### Accuracy (measured)

Tested on 4 full productions (October 2026): VCT Champions (YouTube), Game Changers Americas (YouTube), VCT EMEA (Twitch) and an ESL CS2 final (YouTube).

| Production | Maps found / real | Rounds correct | Wrong scores |
|---|---|---|---|
| Game Changers Americas, Valorant, YouTube | 5 / 5 | 95 / 96 | 0 |
| ESL Pro League final, CS2, YouTube | 3 / 3 | 66 / 69 | 0 |
| VCT Champions, Valorant, YouTube (one map) | 1 / 1 | 23 / 23 | 0 |
| VCT EMEA final, Valorant, Twitch | 4 / 4 | 82 / 82 | 0 |
| **Total** | **13 / 13** | **266 / 271 (98.2%)** | **0 in about 6,500 frames** |

The 5 missed rounds ended while the broadcast cut away (replays, interviews); they're flagged with `gapBefore`, never guessed. On both Valorant matches with a VLR.gg check, every map matched VLR's round history.

### Input

- **Broadcast VOD links** (`videoUrls`): YouTube videos or Twitch VODs, one per line.
- **Game** (`game`): auto, Valorant or CS2.
- **Team names** (`teams`): recommended for CS2, whose broadcast HUD often shows logos instead of names.
- **Start at / End at** (`startSeconds`, `endSeconds`): process only part of a VOD (and pay only for that part).
- **Seconds between frames** (`sampleSeconds`): default 5.
- **VLR.gg match link** (`validateWith`): optional check for Valorant.
- **Include raw per-frame reads** (`includeFrameRows`): for debugging; off by default.

### Output

Real rows from VIT vs 100T, VALORANT Champions Lower Final, map 2 (Summit), shortened:

```json
{"rowType": "round", "game": "valorant", "teamA": "VIT", "teamB": "100T", "map": 2, "mapName": "Summit",
 "round": 4, "scoreA": 2, "scoreB": 2, "winner": "100T", "firstSeenAt": 3120.62, "firstSeenAtHms": "0:52:00",
 "gapBefore": 0, "inferred": false, "evidenceFrames": 2}
```

```json
{"rowType": "map", "map": 2, "mapName": "Summit", "finalA": 13, "finalB": 10, "winner": "VIT",
 "finalInferred": true, "mapComplete": true, "startAtHms": "0:44:57", "endAtHms": "1:34:31",
 "roundsSeen": 22, "roundsTotal": 23, "gapRounds": 0}
```

Here the broadcast never showed the final 13-10 on the scoreboard, so the last round is `inferred: true` and the map row says `finalInferred: true`.

### How much does it cost?

**$0.25 per started 15 minutes of video processed** ($1.00 per VOD hour, $0.25 minimum) at the Apify free-plan price, cheaper on higher plans. A 2.5-hour best-of-three costs about $2.50; limit it to one map with Start at / End at and you pay for that part only. If a run hits its time limit or is aborted, you get the rounds read so far and pay only for the 15-minute blocks that were read.
**Free:** VOD links that can't be opened (private, deleted, live, Twitch subscriber-only), VODs our datacenter IPs can't fetch (try again later), runs stopped by your cost limit, and any failure on our side (AI outage, internal error). Each case gets an explanation row with `costCase: free`.
**Processing fee ($0.02 per started 15 minutes read, at cost):** only when the AI read the video but no scoreboard or round was found (for example a non-match video, or a window inside a single round). It is never added on top of a normal charge.
Processing takes about 10 minutes per VOD hour.

### Limits

- **Team scores and rounds only**: no economy, kills, players or agents in v1.
- **Gaps when the broadcast cuts away**: a round that starts and ends during a replay or an interview is counted in `gapBefore` but not shown.
- **The final round of a map may be inferred** when the broadcast skips the final scoreboard. It's always flagged.
- **CS2**: pass `teams`, because many CS2 HUDs show logos rather than names.
- **Side changes without team names**: on a CS2 HUD with logos only, a 6-6 half can leave the side assignment ambiguous; the map row then says `sideAmbiguous: true`. Passing `teams` doesn't change this, but names let you read the rows. (Valorant overtime without readable tags isn't covered either; Valorant HUDs show tags, so this hasn't come up.)
- **Not supported yet**: live streams, Twitch subscriber-only VODs, one match split across several VOD links.

### Ready-made examples

- [Valorant Match Round Data from a VOD](https://apify.com/tubetext/esports-match-timeline/examples/valorant-match-round-data)
- [CS2 Round-by-Round Scores from a VOD](https://apify.com/tubetext/esports-match-timeline/examples/cs2-round-by-round-scores)

### TubeText Labs tools

**TubeText Labs** builds 33 pay-per-result Apify Actors for video, social and e-commerce data – no login, JSON/CSV/Excel output, and ready for ChatGPT and Claude (Apify MCP), n8n, Make and Zapier. All tools: [apify.com/tubetext](https://apify.com/tubetext)

**Transcripts**

- [YouTube Transcript Scraper](https://apify.com/tubetext/youtube-transcript-fast) – videos, Shorts, playlists and whole channels to text; Whisper AI when there are no captions
- [TikTok Transcript Scraper](https://apify.com/tubetext/tiktok-transcript) – TikTok captions plus Whisper AI, SRT and timestamps
- [Instagram Reels Transcript](https://apify.com/tubetext/instagram-reels-transcript) – reel links or @usernames to text with Whisper AI
- [Podcast & Video Transcript](https://apify.com/tubetext/any-video-podcast-transcript) – podcast RSS / Apple Podcasts, X, Facebook, Loom, Twitch and audio files to text
- [Facebook Video Transcript](https://apify.com/tubetext/facebook-video-transcript) – public Facebook videos and Reels to text with Whisper AI
- [X (Twitter) Video Transcript](https://apify.com/tubetext/twitter-x-video-transcript) – X/Twitter video posts to text with Whisper AI
- [Reddit Video Transcript](https://apify.com/tubetext/reddit-video-transcript) – videos in public Reddit posts (v.redd.it) to text with Whisper AI, with SRT and timestamps
- [Bilibili Video Transcript](https://apify.com/tubetext/bilibili-video-transcript) – Bilibili (B站) videos to text with Whisper AI, plus optional English summaries
- [Podcast Transcript](https://apify.com/tubetext/podcast-transcript) – podcast RSS feeds and Apple Podcasts episodes to text with Whisper AI

**Video & ad analysis**

- [Video Breakdown AI](https://apify.com/tubetext/video-breakdown-ai) – hook analysis, shot list, cut pacing, products shown and script of any TikTok, Reel or YouTube video
- [Shot-by-Shot Video Analysis Pro](https://apify.com/tubetext/shot-by-shot-video-analysis) – director-level storyboard of any video: framing, camera move, emotion and why each shot works, plus replay peaks, danmaku and comments tied to shots
- [YouTube & TikTok Comments API](https://apify.com/tubetext/youtube-tiktok-comments-api) – comments with like-weighted sentiment and themes, plus the moments viewers react to on long YouTube and Bilibili videos
- [Video Ad Analyzer](https://apify.com/tubetext/video-ad-analyzer) – competitors' YouTube video ads by brand or domain (Google Ads Transparency), torn down by AI
- [Meta Ad Library Scraper](https://apify.com/tubetext/meta-ad-library-videos) – Facebook and Instagram ads by brand or keyword: video URLs, images, ad copy, CTA and landing page

**Social, apps & trends**

- [YouTube Channel Analytics](https://apify.com/tubetext/youtube-channel-analytics) – subscribers, recent video performance, Social Blade grade, ranks and estimated earnings
- [Bilibili Scraper](https://apify.com/tubetext/bilibili-scraper) – Bilibili (B站) keyword search, popular board, top-100 ranking, video stats, danmaku text and creator (UP主) followers – no login
- [China Trending Topics](https://apify.com/tubetext/china-trending-topics) – Douyin, Weibo, Baidu, Toutiao and Bilibili hot-search boards in one run, in English – plus an optional AI briefing on why topics trend
- [WeChat Article Scraper](https://apify.com/tubetext/wechat-articles-scraper) – WeChat 公众号 articles by keyword or link: full text, English titles and optional English summaries
- [Google Play Reviews + AI Insights](https://apify.com/tubetext/google-play-reviews-ai) – Android app reviews by star rating, country and language, plus an AI report of complaints and praise
- [Steam Reviews Scraper + AI Insights](https://apify.com/tubetext/steam-reviews-scraper) – Steam game reviews with hours played and votes, review score and current players, plus an AI report of top complaints, praise and feature requests
- [Social Blade Scraper](https://apify.com/tubetext/socialblade-scraper) – Social Blade stats for YouTube, TikTok, Instagram and Twitch creators – grade, ranks, 2-week growth, daily history, earnings estimates and top-100 lists
- [Spotify Play Count Scraper](https://apify.com/tubetext/spotify-play-count-scraper) – play counts for every track of an album, artist or playlist (incl. Top 50 charts), plus monthly listeners, followers, world rank and top cities

**E-commerce & travel**

- [TikTok Shop Product Scraper](https://apify.com/tubetext/tiktok-shop-product-scraper) – US TikTok Shop prices, items sold, stock per SKU and shop stats
- [AliExpress Search Scraper](https://apify.com/tubetext/aliexpress-search-scraper) – AliExpress search results by keyword: price, items sold, rating, shipping, badges
- [Google Hotels Scraper](https://apify.com/tubetext/google-hotels-scraper) – hotel prices for any destination and dates, per booking site and as a 90-day price calendar
- [Taobao & Tmall Product Scraper](https://apify.com/tubetext/taobao-tmall-scraper) – Taobao/Tmall products by Chinese or English keyword, category or URL: CNY prices, shops and seller scores
- [Alibaba & Yiwu Supplier Finder by Image](https://apify.com/tubetext/alibaba-yiwu-image-search) – product photo in, similar Alibaba.com and Yiwu wholesale listings out: price, MOQ, supplier, country and rating
- [Amazon Product Search Scraper](https://apify.com/tubetext/amazon-product-search-scraper) – Amazon search results, Best Sellers lists and product pages: price, rating, reviews, monthly sales signal, badges and specs
- [Google Flights Scraper](https://apify.com/tubetext/google-flights-scraper) – flight prices for any route or multi-city trip, a cheapest-day calendar, price insights and booking options per site
- [Agoda & Booking.com Hotel Reviews + AI](https://apify.com/tubetext/agoda-reviews-scraper) – Agoda hotel reviews plus verified Booking.com reviews shown on Agoda, hotel scores and sub-scores, and an AI report of complaints, praise and action items
- [Gas Prices Scraper (US & Canada)](https://apify.com/tubetext/gas-prices-scraper) – live gas station prices by ZIP, city or coordinates – regular, premium, diesel, E85 – with an area summary of the cheapest stations
- [Idealo Price Scraper](https://apify.com/tubetext/idealo-price-scraper) – every shop offer for a product on idealo – price, shipping, delivery, shop rating – in Germany, Austria, France, Italy, Spain and the UK, with a summary per market

**Esports & sports data**

- [Esports Match Timeline](https://apify.com/tubetext/esports-match-timeline) *(this tool)* – Valorant and CS2 round-by-round scores, winners and VOD timestamps read from broadcast VODs

**Questions or problems?** [Open an issue](https://apify.com/tubetext/esports-match-timeline/issues) (we read every one). **Need a custom version?** Ask in an issue or [email us](mailto:tubettext@gmail.com) – we build it as a private Actor on Apify.

Found it useful? A short review on this page helps others find it.

Built by **TubeText Labs** · Pay per result. No login. Ready for AI agents.

### FAQ

**Which tournaments work?** Broadcasts with a visible score HUD. We tested VCT (global and EMEA), Game Changers and ESL Pro League; other productions usually work too, and `hudCoverage` tells you how much of the VOD had a readable scoreboard.
**Does it use the game's API or an account?** No. It reads the public broadcast video, the same thing a viewer sees.
**Can I check the results?** Every round has a VOD timestamp, so you can jump to it. For Valorant, add the VLR.gg match link and each map is compared automatically.
**Is it legal?** The Actor reads publicly available broadcast VODs without logging in and outputs match facts (scores and timestamps), not video. You're responsible for using the data in line with the platforms' terms and your local law; for unusual uses, ask a lawyer.
**How long does it take?** About 10 minutes per hour of VOD.

### Support

Found a bug, or need another game or field? [Open an issue](https://apify.com/tubetext/esports-match-timeline/issues) – we read every one. **Need a custom version?** Ask in an issue or [email us](mailto:tubettext@gmail.com) – we build it as a private Actor on Apify.

# Actor input Schema

## `videoUrls` (type: `array`):

YouTube or Twitch VOD links to full Valorant or CS2 match broadcasts. One timeline per video, with every map in it. Twitch: twitch.tv/videos/<id> (public VODs; sub-only VODs are skipped).

## `game` (type: `string`):

auto detects Valorant or CS2 from the broadcast.

## `teams` (type: `array`):

Two team names, e.g. \["MOUZ", "Vitality"]. CS2 broadcasts often show only logos; team names are then taken from here, never guessed from the screen.

## `startSeconds` (type: `integer`):

Skip the pre-show. Only the part between start and end is processed and charged.

## `endSeconds` (type: `integer`):

Stop here (default: end of video).

## `sampleSeconds` (type: `integer`):

One frame is read every N seconds. 5 caught 95%+ of rounds in testing; lower values catch rounds hidden by camera cuts. Twitch: 10 or more uses the light fetch (one frame per 10-second segment, ~24 MB per hour); below 10 whole segments are fetched (~320 MB per hour, slower).

## `validateWith` (type: `string`):

If given, each map is checked against VLR's round history and a validation block is added.

## `includeFrameRows` (type: `boolean`):

Also output one row per frame with the HUD values as read.

## Actor input object example

```json
{
  "videoUrls": [
    "https://www.youtube.com/watch?v=MZjaOtjtRlU"
  ],
  "game": "auto",
  "sampleSeconds": 5,
  "includeFrameRows": false
}
```

# Actor output Schema

## `timeline` (type: `string`):

No description

## `allRows` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "videoUrls": [
        "https://www.youtube.com/watch?v=MZjaOtjtRlU"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("tubetext/esports-match-timeline").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "videoUrls": ["https://www.youtube.com/watch?v=MZjaOtjtRlU"] }

# Run the Actor and wait for it to finish
run = client.actor("tubetext/esports-match-timeline").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "videoUrls": [
    "https://www.youtube.com/watch?v=MZjaOtjtRlU"
  ]
}' |
apify call tubetext/esports-match-timeline --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tubetext/esports-match-timeline"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/q2rlaDfpPEJgCBP4k/builds/oQE2No8fAviSOVbct/openapi.json