HLTV.org Team Ranking avatar
HLTV.org Team Ranking

Pricing

from $3.00 / 1,000 results

Go to Apify Store
HLTV.org Team Ranking

HLTV.org Team Ranking

Scrape CS2 team rankings from HLTV.org. Get current or historical HLTV and Valve rankings with team names, points, position changes, player rosters, and logos. Filter by country or date.

Pricing

from $3.00 / 1,000 results

Rating

0.0

(0)

Developer

Paco Nassa

Paco Nassa

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

4 days ago

Last modified

Share

HLTV Team Ranking Scraper

Scrape official Counter-Strike 2 (CS2) team rankings from HLTV.org - the world's leading CS2 esports platform.

Features

  • Current Rankings - Get the latest official team rankings
  • Historical Rankings - Access rankings from any date since 2015
  • Country Filter - Filter rankings by country (e.g., Brazilian teams only)
  • Rate Limiting - Built-in request delays to respect HLTV's servers

Use Cases

  • Betting Analytics - Track team rankings for prediction models
  • Fantasy Esports - Build fantasy league apps with real ranking data
  • Content Creation - Power esports news sites and Discord bots
  • Data Analysis - Research team performance trends over time
  • Scouting Tools - Monitor rising teams and roster changes

Input Parameters

ParameterTypeDescription
yearnumberYear for historical rankings (2015-2030)
monthstringMonth name (e.g., "january", "december")
daynumberDay of month (1-31)
countrystringFilter by country (e.g., "Brazil", "Denmark")
maxTeamsnumberLimit results (default: 30)
requestDelaynumberDelay in ms between requests (default: 1000)

Output Example

{
"place": 1,
"team": {
"name": "Team Vitality",
"id": 9565
},
"points": 1000,
"change": 0,
"isNew": false
}

Output Fields

FieldDescription
placeCurrent ranking position
team.nameTeam name
team.idHLTV team ID (for linking to profiles)
pointsRanking points
changePosition change from previous week (+/-)
isNewWhether team is new to the ranking

Examples

Get Current Top 10

{
"maxTeams": 10
}

Get Brazilian Teams Only

{
"country": "Brazil",
"maxTeams": 20
}

Get Historical Ranking (January 2024)

{
"year": 2024,
"month": "january",
"day": 15,
"maxTeams": 30
}

Rate Limiting

HLTV has Cloudflare protection. To avoid being blocked:

  • Use the default requestDelay of 1000ms
  • Don't run too many concurrent actors
  • For bulk historical data, run actors sequentially with delays

Integrations

Export data directly to:

  • Google Sheets
  • Webhooks
  • JSON/CSV/Excel files
  • Connect via API to your apps

Part of the HLTV Actor Suite:

  • HLTV Match Results & Live Scores (coming soon)
  • HLTV Player Statistics (coming soon)
  • HLTV Tournament Data (coming soon)

Support

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

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.