HLTV.org Team Ranking
by paco_nassa
Automatically scrape current and historical CS2 team rankings from HLTV.org. Get team points, rosters, logos, and filter by country or date for your projects.
Opens on Apify.com
About HLTV.org Team Ranking
Need to pull CS2 team rankings from HLTV.org for a project? I've been there. Manually checking that site for the latest standings or trying to track a team's historical performance is a chore. This actor solves that by automating the whole process. You can fetch the current HLTV and Valve world rankings, or go back in time to see where teams stood on a specific date. Every scrape gives you the essentials: team name, ranking points, position change (like if a team moved up or down), the active player roster, and the team's logo. I often use the filter by country feature to focus on regional scenes, which is super handy for more targeted analysis. Whether you're building a fan site, doing data analysis for esports research, or just want to keep a personal database updated, this tool pulls clean, structured data so you can skip the copy-pasting and get straight to using the info. It's basically a direct pipeline from HLTV's rankings into your application or spreadsheet.
What does this actor do?
HLTV.org Team Ranking is a web scraping and automation tool available on the Apify platform. It's designed to help you extract data and automate tasks efficiently in the cloud.
Key Features
- Cloud-based execution - no local setup required
- Scalable infrastructure for large-scale operations
- API access for integration with your applications
- Built-in proxy rotation and anti-blocking measures
- Scheduled runs and webhooks for automation
How to Use
- Click "Try This Actor" to open it on Apify
- Create a free Apify account if you don't have one
- Configure the input parameters as needed
- Run the actor and download your results
Documentation
HLTV.org Team Ranking Scraper
Scrapes official Counter-Strike 2 (CS2) team rankings from HLTV.org.
Overview
This Apify actor retrieves CS2 team rankings from HLTV.org. It can fetch the current top 30 teams or historical rankings dating back to 2015. Results can be filtered by country and are returned in a structured JSON format suitable for applications and analysis.
Key Features
- Current & Historical Data: Get the latest rankings or access rankings from any specific date since 2015.
- Country Filter: Isolate rankings for teams from a specific country (e.g.,
"Brazil"). - Built-in Rate Limiting: Configurable delays between requests to respect HLTV's servers and avoid blocks.
- Structured Output: Returns clean JSON with team names, HLTV IDs, ranking points, and weekly position changes.
How to Use
Configure the actor using input parameters. Run it with an empty input to get the latest top 30 rankings.
Common Input Configurations
Get Current Top 10:
{ "maxTeams": 10 }
Get Brazilian Teams Only:
{ "country": "Brazil", "maxTeams": 20 }
Get Historical Ranking (Jan 15, 2024):
{
"year": 2024,
"month": "january",
"day": 15,
"maxTeams": 30
}
Input Parameters
| Parameter | Type | Description |
|---|---|---|
year |
number | Year for historical rankings (2015-2030). |
month |
string | Month name (e.g., "january"). |
day |
number | Day of month (1-31). |
country |
string | Filter results by country name. |
maxTeams |
number | Limit the number of teams returned (default: 30). |
requestDelay |
number | Delay in milliseconds between requests (default: 1000). |
Output
The actor outputs an array of ranking objects. Each object contains the following fields:
| Field | Description |
|---|---|
place |
The team's current ranking position. |
team.name |
The name of the team. |
team.id |
The HLTV team ID, useful for linking to team profiles. |
points |
The team's ranking points. |
change |
Position change from the previous week (positive or negative integer). |
isNew |
Boolean indicating if the team is new to the ranking. |
Example Output Item:
{
"place": 1,
"team": { "name": "Team Vitality", "id": 9565 },
"points": 1000,
"change": 0,
"isNew": false
}
Important Notes
- Rate Limiting: HLTV employs Cloudflare protection. Use the default
requestDelayand avoid running too many concurrent actors. For large historical scrapes, run actors sequentially with delays. - Integrations: You can push the dataset to Google Sheets, webhooks, or export as JSON/CSV/Excel. Connect to it via API from your applications.
- Legal: This actor is for educational and personal use. Respect HLTV's terms of service. The maintainer is not affiliated with HLTV.org.
- Support: Report issues on the actor's GitHub repository. For questions about HLTV data itself, refer to HLTV.org.
Categories
Common Use Cases
Market Research
Gather competitive intelligence and market data
Lead Generation
Extract contact information for sales outreach
Price Monitoring
Track competitor pricing and product changes
Content Aggregation
Collect and organize content from multiple sources
Ready to Get Started?
Try HLTV.org Team Ranking now on Apify. Free tier available with no credit card required.
Start Free TrialActor Information
- Developer
- paco_nassa
- Pricing
- Paid
- Total Runs
- 7
- Active Users
- 2
Related Actors
Video Transcript Scraper: Youtube, X, Facebook, Tiktok, etc.
by invideoiq
Linkedin Profile Details Scraper + EMAIL (No Cookies Required)
by apimaestro
Twitter (X.com) Scraper Unlimited: No Limits
by apidojo
Content Checker
by jakubbalada
Apify provides a cloud platform for web scraping, data extraction, and automation. Build and run web scrapers in the cloud.
Learn more about ApifyNeed Professional Help?
Couldn't solve your problem? Hire a verified specialist on Fiverr to get it done quickly and professionally.
Trusted by millions | Money-back guarantee | 24/7 Support