HLTV Scraper

Extract CS2 esports match results, team rankings, player stats, and event coverage from HLTV. Built on spider-browser .

Get started Docs

target
hltv.org: success rate
99.9%: latency
~4ms

Quick start

Extract data in minutes.

hltv-scraper.ts

import { SpiderBrowser } from "spider-browser";

const spider = new SpiderBrowser({
  apiKey: process.env.SPIDER_API_KEY!,
  stealth: 2,
});

await spider.connect();
const page = spider.page!;
await page.goto("https://www.hltv.org/ranking/teams");
await page.content();

const data = await page.evaluate(`(() => {
  const teams = [];
  document.querySelectorAll(".ranked-team").forEach(el => {
    const rank = el.querySelector(".position")?.textContent?.trim();
    const name = el.querySelector(".name")?.textContent?.trim();
    const points = el.querySelector(".points")?.textContent?.trim();
    const players = [];
    el.querySelectorAll(".lineup .player-holder .text-ellipsis").forEach(p => {
      players.push(p.textContent?.trim());
    });
    if (name) teams.push({ rank, name, points, players });
  });
  return JSON.stringify({ total: teams.length, teams: teams.slice(0, 10) });
})()`);

console.log(JSON.parse(data));
await spider.close();

ready to run · spider-browser · TypeScript

Fetch API

One endpoint for hltv.org.

Structured JSON from hltv.org with a single POST. AI-resolved selectors, cached on the first call.

POST /fetch/hltv.org/

Team nameRankingMatch scorePlayer statsEvent nameMap results

Try it Fetch docs

cURL

curl -X POST https://api.spider.cloud/fetch/hltv.org/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"return_format": "json"}'

Python

import requests

resp = requests.post(
    "https://api.spider.cloud/fetch/hltv.org/",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={"return_format": "json"},
)
print(resp.json())

Node.js

const resp = await fetch("https://api.spider.cloud/fetch/hltv.org/", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ return_format: "json" }),
});
const data = await resp.json();
console.log(data);

Extraction