An unofficial Node.js API for programmatically accessing HLTV's Counter-Strike esports data, including matches, teams, players, and live scores.
HLTV is an unofficial Node.js API wrapper for HLTV.org, the leading website for Counter-Strike esports news and statistics. It allows developers to programmatically access match data, team and player stats, rankings, events, and live scores. The library solves the problem of extracting structured esports data without an official API, enabling automation for analytics, bots, and data-driven applications.
Developers building CS:GO esports applications, such as Discord bots, data analytics dashboards, fantasy league platforms, or match notification services. It's also useful for data analysts and researchers needing programmatic access to historical CS:GO statistics.
Developers choose HLTV because it offers the most comprehensive and well-documented unofficial API for HLTV.org, with TypeScript support, real-time scorebot integration, and extensive filtering options. Its modular design and configurable HTTP layer make it adaptable for various use cases while emphasizing responsible usage to avoid IP bans.
The unofficial HLTV Node.js API
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Fetches match details, team/player stats, rankings, events, and live scores through over 20 endpoints like getMatch and getTeamStats, covering most HLTV.org content.
Provides detailed TypeScript definitions for all API responses, ensuring type safety and clear data structures, as referenced in the schemas linked in the README.
Offers connectToScorebot for WebSocket-based live match data, enabling real-time scoreboard and game log updates for applications like bots or dashboards.
Allows overriding the default HTTP agent and request function, facilitating integration with custom clients like axios or fetch, as shown in the configuration options.
The README explicitly states the library is no longer actively maintained, meaning bugs won't be fixed and it may break with HLTV.org updates.
Relies on web scraping with Cloudflare protections; the README warns that abuse can lead to IP bans, requiring manual rate limiting and cautious usage.
As a scraping tool, any changes to HLTV.org's HTML structure can break parsers without updates, and the unmaintained status leaves users to fix issues themselves.