HLTV.org Live and Upcoming Matches

Overview

This Apify actor scrapes Counter-Strike 2 (CS2) match data from HLTV.org. It retrieves upcoming, live, and completed matches, including scores, team info, and event details. It's part of the Integrations, Automation, and Developer Tools categories.

Key Features

• Match Types: Fetch upcoming, live, or completed match results.
• Detailed Data: Optionally scrape deep match details like map scores, player stats, and stream links.
• Filtering: Filter matches by importance using a 0-5 star rating system.
• Specific Lookup: Fetch data for a single match using its HLTV ID.

How to Use

Configure the actor using input parameters. The most basic use is to set the matchType.

Common Input Examples

Get a list of upcoming matches:

{
  "matchType": "upcoming",
  "maxMatches": 20
}

Get only live matches:

{
  "matchType": "live"
}

Get high-profile matches (4 stars or more):

{
  "matchType": "all",
  "minStars": 4,
  "maxMatches": 10
}

Get a specific match with full details:

{
  "matchId": 2388126,
  "includeDetails": true
}

Input Parameters

Output

The actor returns a JSON object containing an array of matches. Each match includes its ID, URL, status, team information (name, ID, logo, score), event details, format, and star rating.

Example Output

{
  "scrapedAt": "2025-12-12T...",
  "matchType": "live",
  "totalMatches": 1,
  "matches": [
    {
      "id": 2388572,
      "url": "https://www.hltv.org/matches/2388572/novaq-vs-allinners-1xbet-frag-season-16",
      "status": "live",
      "teams": {
        "team1": { "name": "NOVAQ", "id": 13178, "logo": "https://...", "score": 12, "mapsWon": 0 },
        "team2": { "name": "ALLINNERS", "id": 12812, "logo": "https://...", "score": 3, "mapsWon": 0 }
      },
      "event": { "name": "1xBet FRAG Season 16", "id": 8878 },
      "format": "bo3",
      "stars": 0,
      "startTime": null
    }
  ]
}

Important Notes

• Proxies Required: HLTV uses Cloudflare protection. Use residential proxies for reliable access, especially for scraping the /results page.
  json { "proxyConfiguration": { "useApifyProxy": true, "groups": ["RESIDENTIAL"] } }
• Rate Limiting: The actor adds delays between requests. Avoid too many concurrent runs, as the results page can trigger Cloudflare challenges.
• Legal: This actor is for educational and personal use. Respect HLTV's terms of service and rate limits.

Related Actors

Part of the HLTV Actor Suite:
* HLTV Team Rankings – Scrapes world team rankings.
* HLTV Player Statistics (coming soon).

Support

Report issues on the actor's GitHub repository. For questions about HLTV data itself, refer to HLTV.org.