Pricing

Rating

Developer

Actor stats

Categories

Share

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

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

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.