HLTV Match Results & Live Scores

Scrape Counter-Strike 2 (CS2) match data from HLTV.org - upcoming matches, live scores, and completed results.

Features

• Upcoming Matches - Get scheduled matches with teams and events
• Live Matches - Track ongoing matches with current scores
• Match Results - Historical match data (requires residential proxy)
• Match Details - Optional deep scraping for maps, player stats, streams
• Star Rating Filter - Filter by match importance (0-5 stars)

Use Cases

• Betting Analytics - Real-time match data for prediction models
• Discord Bots - Live score notifications and match alerts
• Fantasy Esports - Track player and team performance
• Content Creation - Match schedules for esports news sites
• Data Analysis - Historical match research

Input Parameters

Parameter	Type	Description
matchType	string	"upcoming", "live", "results", or "all"
matchId	number	Fetch specific match by ID (overrides matchType)
maxMatches	number	Limit results (default: 50)
includeDetails	boolean	Fetch full match details - maps, streams (slower)
minStars	number	Filter by importance (0-5 stars)
nationality	string	Filter by player/coach nationality (ISO country code, e.g., "BR", "DK"). Requires residential proxies.
proxyConfiguration	object	Proxy settings (residential recommended)

Output Example

{
  "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,
      "maps": [],
      "streams": []
    }
  ]
}

Output Fields

Field	Description
id	HLTV match ID
url	Direct link to match page
status	"upcoming", "live", or "completed"
teams.name	Team name (exact casing from HLTV)
teams.id	HLTV team ID
teams.logo	Team logo URL
teams.score	Current map round score (live matches)
teams.mapsWon	Maps won in series (BO3/BO5 matches)
event	Tournament/event name and ID
format	Match format (bo1, bo3, bo5)
stars	Match importance (0-5)
startTime	Scheduled start time (ISO 8601)
maps	Map results (if includeDetails: true)
streams	Stream links (if includeDetails: true)

Examples

Get Upcoming Matches

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

Get Live Matches Only

{
  "matchType": "live"
}

Get High-Profile Matches (4+ Stars)

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

Get Specific Match with Details

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

Proxy Configuration

HLTV uses Cloudflare protection. For best results:

• Use Residential proxies for reliable access
• The /results page has stricter protection than /matches
• Enable Apify Proxy with RESIDENTIAL group

{
  "proxyConfiguration": {
    "useApifyProxy": true,
    "groups": ["RESIDENTIAL"]
  }
}

Rate Limiting

• Actor adds delays between requests automatically
• Avoid running too many concurrent actors
• Results page may trigger Cloudflare challenges more often

Related Actors

Part of the HLTV Actor Suite:

• link - World team rankings
• HLTV Player Statistics (coming soon)

Support

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

Legal

This actor is for educational and personal use. Respect HLTV's terms of service and rate limits. The actor maintainer is not affiliated with HLTV.org.