cs2-api-client 1.0.0__tar.gz

cs2_api_client-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cito API
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cs2_api_client-1.0.0/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: cs2-api-client
+Version: 1.0.0
+Summary: CS2 API client: Counter-Strike 2 live scores, match results, player stats, teams, rankings (world + VRS), events and skin prices. Standard library only.
+Author: Cito API
+License-Expression: MIT
+Project-URL: Homepage, https://cs2-api.org
+Project-URL: Documentation, https://cs2-api.org/endpoints/
+Project-URL: Source, https://github.com/achillesscriptsvip/cs2-api
+Project-URL: Issues, https://github.com/achillesscriptsvip/cs2-api/issues
+Project-URL: Get a free API key, https://citoapi.com/signup?game=cs2&utm_source=pypi&utm_medium=referral&utm_campaign=cs2-api-package
+Keywords: cs2,cs2-api,counter-strike,counter-strike-2,csgo,hltv,hltv-api,esports,skins,skin-prices,api-client
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Games/Entertainment
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# cs2-api: Counter-Strike 2 API client for JavaScript and Python
+
+[![npm](https://img.shields.io/npm/v/cs2-api)](https://www.npmjs.com/package/cs2-api) [![PyPI](https://img.shields.io/pypi/v/cs2-api-client)](https://pypi.org/project/cs2-api-client/) [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+
+This is the official client for the **CS2 API** at [cs2-api.org](https://cs2-api.org). It covers:
+
+- live Counter-Strike 2 match scores and round-level scoreboards
+- match results, schedules and streams
+- player stats (rating, ADR, KAST, K/D) and leaderboards
+- teams, rosters and head-to-head
+- the world ranking and Valve Regional Standings (VRS)
+- events, standings and brackets
+- transfers
+- **CS2 skin prices across 25+ marketplaces**, with price history
+
+It has zero dependencies. The JavaScript client ships TypeScript types and works as ESM or CommonJS; the Python client needs only the standard library.
+
+> **You need a free API key** (500 requests/month, no card): **[Get your key](https://citoapi.com/signup?game=cs2&utm_source=npm-pypi&utm_medium=referral&utm_campaign=cs2-api-package)**
+
+## Install
+
+```bash
+npm install cs2-api
+```
+
+```bash
+pip install cs2-api-client
+```
+
+## JavaScript / TypeScript
+
+```js
+import { CS2Api } from "cs2-api";            // or: const { CS2Api } = require("cs2-api")
+
+const cs2 = new CS2Api();                     // reads process.env.CITO_API_KEY
+
+const live = await cs2.live();                // every match being played right now
+for (const m of live) {
+  console.log(`${m.team1Name} ${m.team1Score}-${m.team2Score} ${m.team2Name} · ${m.currentMap}`);
+}
+
+const ranking = await cs2.worldRanking({ limit: 10 });
+const vitality = await cs2.team("vitality");  // roster + recent results
+const donk = await cs2.player("donk");
+const prices = await cs2.skinPrices("ak-47-redline-field-tested-1ab1a2dc");
+```
+
+## Python
+
+```python
+from cs2_api import CS2Api
+
+cs2 = CS2Api()  # reads CITO_API_KEY
+
+for m in cs2.live():
+    print(f"{m['team1Name']} {m['team1Score']}-{m['team2Score']} {m['team2Name']} · {m['currentMap']}")
+
+ranking = cs2.world_ranking(limit=10)
+vitality = cs2.team("vitality")
+donk = cs2.player("donk")
+prices = cs2.skin_prices("ak-47-redline-field-tested-1ab1a2dc")
+```
+
+## Methods
+
+JavaScript uses camelCase and Python uses snake_case (`worldRanking` / `world_ranking`). Teams, players and events accept an id or a slug (`vitality`, `donk`).
+
+| Area | Methods |
+|---|---|
+| Live | `live()`, `liveScoreboard(matchId)`: sides, round, player K/D/ADR |
+| Matches | `upcoming()`, `results()`, `today()`, `match(id)`, `matchMaps(id)`, `matchPlayerStats(id)`, `matchStreams(id)` |
+| Teams | `team(slug)`, `teamMatches(slug)`, `teamStats(slug)`, `teamMapStats(slug)`, `headToHead(a, b)` |
+| Players | `player(slug)`, `searchPlayers(q)`, `playerStats(slug)`, `playerMatches(slug)` |
+| Events | `events({ status })`, `event(slug)`, `eventMatches(slug)`, `eventStandings(slug)`, `eventBracket(slug)` |
+| Rankings & stats | `worldRanking()`, `vrsRanking()`, `leaderboard(metric)`, `transfers()`, `search(q)` |
+| Skins | `searchSkins(q)`, `skin(slug)`, `skinPrices(slug)`, `skinHistory(slug)`, `trendingSkins()` |
+| Anything else | `get(path, query, { raw })`: any of the 140+ endpoints, with `meta` for pagination when `raw: true` |
+
+Errors throw `CS2ApiError` (JS) or raise `CS2ApiError` (Python), with `status` and the API's message.
+
+## Use cases
+
+- **Discord bots**: [cs2-discord-bot](https://github.com/achillesscriptsvip/cs2-discord-bot)
+- **Stream overlays**: [cs2-obs-overlay](https://github.com/achillesscriptsvip/cs2-obs-overlay)
+- **Skin trading tools**: [cs2-skin-price-api](https://github.com/achillesscriptsvip/cs2-skin-price-api)
+- **Moving off HLTV scrapers**: [hltv-api-alternative](https://github.com/achillesscriptsvip/hltv-api-alternative)
+- Fantasy, analytics dashboards, prediction models and AI agents
+
+## Keep your key safe
+
+Keep it in an environment variable or `.env` (git-ignored). Call the API from your server, never from browser code. If a key leaks, revoke it in your dashboard and create a new one.
+
+## Links
+
+- CS2 API docs and endpoints: https://cs2-api.org/endpoints/
+- Pricing: https://citoapi.com/pricing
+- Issues: https://github.com/achillesscriptsvip/cs2-api/issues
+
+Not affiliated with Valve, HLTV, ESL, BLAST or PGL. MIT licensed.

cs2_api_client-1.0.0/README.md

@@ -0,0 +1,99 @@
+# cs2-api: Counter-Strike 2 API client for JavaScript and Python
+
+[![npm](https://img.shields.io/npm/v/cs2-api)](https://www.npmjs.com/package/cs2-api) [![PyPI](https://img.shields.io/pypi/v/cs2-api-client)](https://pypi.org/project/cs2-api-client/) [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+
+This is the official client for the **CS2 API** at [cs2-api.org](https://cs2-api.org). It covers:
+
+- live Counter-Strike 2 match scores and round-level scoreboards
+- match results, schedules and streams
+- player stats (rating, ADR, KAST, K/D) and leaderboards
+- teams, rosters and head-to-head
+- the world ranking and Valve Regional Standings (VRS)
+- events, standings and brackets
+- transfers
+- **CS2 skin prices across 25+ marketplaces**, with price history
+
+It has zero dependencies. The JavaScript client ships TypeScript types and works as ESM or CommonJS; the Python client needs only the standard library.
+
+> **You need a free API key** (500 requests/month, no card): **[Get your key](https://citoapi.com/signup?game=cs2&utm_source=npm-pypi&utm_medium=referral&utm_campaign=cs2-api-package)**
+
+## Install
+
+```bash
+npm install cs2-api
+```
+
+```bash
+pip install cs2-api-client
+```
+
+## JavaScript / TypeScript
+
+```js
+import { CS2Api } from "cs2-api";            // or: const { CS2Api } = require("cs2-api")
+
+const cs2 = new CS2Api();                     // reads process.env.CITO_API_KEY
+
+const live = await cs2.live();                // every match being played right now
+for (const m of live) {
+  console.log(`${m.team1Name} ${m.team1Score}-${m.team2Score} ${m.team2Name} · ${m.currentMap}`);
+}
+
+const ranking = await cs2.worldRanking({ limit: 10 });
+const vitality = await cs2.team("vitality");  // roster + recent results
+const donk = await cs2.player("donk");
+const prices = await cs2.skinPrices("ak-47-redline-field-tested-1ab1a2dc");
+```
+
+## Python
+
+```python
+from cs2_api import CS2Api
+
+cs2 = CS2Api()  # reads CITO_API_KEY
+
+for m in cs2.live():
+    print(f"{m['team1Name']} {m['team1Score']}-{m['team2Score']} {m['team2Name']} · {m['currentMap']}")
+
+ranking = cs2.world_ranking(limit=10)
+vitality = cs2.team("vitality")
+donk = cs2.player("donk")
+prices = cs2.skin_prices("ak-47-redline-field-tested-1ab1a2dc")
+```
+
+## Methods
+
+JavaScript uses camelCase and Python uses snake_case (`worldRanking` / `world_ranking`). Teams, players and events accept an id or a slug (`vitality`, `donk`).
+
+| Area | Methods |
+|---|---|
+| Live | `live()`, `liveScoreboard(matchId)`: sides, round, player K/D/ADR |
+| Matches | `upcoming()`, `results()`, `today()`, `match(id)`, `matchMaps(id)`, `matchPlayerStats(id)`, `matchStreams(id)` |
+| Teams | `team(slug)`, `teamMatches(slug)`, `teamStats(slug)`, `teamMapStats(slug)`, `headToHead(a, b)` |
+| Players | `player(slug)`, `searchPlayers(q)`, `playerStats(slug)`, `playerMatches(slug)` |
+| Events | `events({ status })`, `event(slug)`, `eventMatches(slug)`, `eventStandings(slug)`, `eventBracket(slug)` |
+| Rankings & stats | `worldRanking()`, `vrsRanking()`, `leaderboard(metric)`, `transfers()`, `search(q)` |
+| Skins | `searchSkins(q)`, `skin(slug)`, `skinPrices(slug)`, `skinHistory(slug)`, `trendingSkins()` |
+| Anything else | `get(path, query, { raw })`: any of the 140+ endpoints, with `meta` for pagination when `raw: true` |
+
+Errors throw `CS2ApiError` (JS) or raise `CS2ApiError` (Python), with `status` and the API's message.
+
+## Use cases
+
+- **Discord bots**: [cs2-discord-bot](https://github.com/achillesscriptsvip/cs2-discord-bot)
+- **Stream overlays**: [cs2-obs-overlay](https://github.com/achillesscriptsvip/cs2-obs-overlay)
+- **Skin trading tools**: [cs2-skin-price-api](https://github.com/achillesscriptsvip/cs2-skin-price-api)
+- **Moving off HLTV scrapers**: [hltv-api-alternative](https://github.com/achillesscriptsvip/hltv-api-alternative)
+- Fantasy, analytics dashboards, prediction models and AI agents
+
+## Keep your key safe
+
+Keep it in an environment variable or `.env` (git-ignored). Call the API from your server, never from browser code. If a key leaks, revoke it in your dashboard and create a new one.
+
+## Links
+
+- CS2 API docs and endpoints: https://cs2-api.org/endpoints/
+- Pricing: https://citoapi.com/pricing
+- Issues: https://github.com/achillesscriptsvip/cs2-api/issues
+
+Not affiliated with Valve, HLTV, ESL, BLAST or PGL. MIT licensed.

cs2_api_client-1.0.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "cs2-api-client"
+version = "1.0.0"
+description = "CS2 API client: Counter-Strike 2 live scores, match results, player stats, teams, rankings (world + VRS), events and skin prices. Standard library only."
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Cito API" }]
+keywords = ["cs2", "cs2-api", "counter-strike", "counter-strike-2", "csgo", "hltv", "hltv-api", "esports", "skins", "skin-prices", "api-client"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Operating System :: OS Independent",
+  "Intended Audience :: Developers",
+  "Topic :: Games/Entertainment",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+  "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://cs2-api.org"
+Documentation = "https://cs2-api.org/endpoints/"
+Source = "https://github.com/achillesscriptsvip/cs2-api"
+Issues = "https://github.com/achillesscriptsvip/cs2-api/issues"
+"Get a free API key" = "https://citoapi.com/signup?game=cs2&utm_source=pypi&utm_medium=referral&utm_campaign=cs2-api-package"
+
+[tool.setuptools.packages.find]
+where = ["src"]

cs2_api_client-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

cs2_api_client-1.0.0/src/cs2_api/__init__.py

@@ -0,0 +1,182 @@
+"""cs2-api: Counter-Strike 2 esports and skin market API client (Python 3.8+, standard library only).
+
+Live scores, match results, schedules, player stats (rating, ADR, KAST), teams and rosters, the
+world ranking and Valve Regional Standings, events and brackets, transfers, and skin prices across
+marketplaces.
+
+Get a free API key (500 requests/month): https://cs2-api.org
+"""
+
+from __future__ import annotations
+
+import json
+import os
+import urllib.error
+import urllib.parse
+import urllib.request
+from typing import Any, Dict, Optional
+
+__version__ = "1.0.0"
+__all__ = ["CS2Api", "CS2ApiError"]
+
+DEFAULT_BASE_URL = "https://api.citoapi.com/api/v1"
+
+
+class CS2ApiError(Exception):
+    def __init__(self, message: str, status: int = 0, body: Any = None):
+        super().__init__(message)
+        self.status = status
+        self.body = body
+        self.code = ((body or {}).get("error") or {}).get("code") if isinstance(body, dict) else None
+
+
+def _q(value: str) -> str:
+    return urllib.parse.quote(str(value), safe="")
+
+
+class CS2Api:
+    def __init__(self, api_key: Optional[str] = None, base_url: str = DEFAULT_BASE_URL, timeout: float = 20):
+        self.api_key = api_key if api_key is not None else os.environ.get("CITO_API_KEY")
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+        if not self.api_key:
+            raise CS2ApiError("Missing API key. Get a free key at https://cs2-api.org and set CITO_API_KEY (or pass api_key=).")
+
+    def get(self, path: str, query: Optional[Dict[str, Any]] = None, raw: bool = False) -> Any:
+        """Any endpoint. Returns `data`, or the whole response (data + meta) with raw=True."""
+        params = {k: v for k, v in (query or {}).items() if v is not None and v != ""}
+        url = self.base_url + ("" if path.startswith("/") else "/") + path
+        if params:
+            url += "?" + urllib.parse.urlencode(params)
+        req = urllib.request.Request(url, headers={"x-api-key": self.api_key, "accept": "application/json", "user-agent": f"cs2-api-python/{__version__}"})
+        try:
+            with urllib.request.urlopen(req, timeout=self.timeout) as res:
+                body = json.loads(res.read().decode("utf-8"))
+        except urllib.error.HTTPError as err:
+            try:
+                body = json.loads(err.read().decode("utf-8"))
+            except Exception:
+                body = None
+            message = ((body or {}).get("error") or {}).get("message") if isinstance(body, dict) else None
+            raise CS2ApiError(message or f"Request failed with status {err.code}", err.code, body) from None
+        if isinstance(body, dict) and body.get("success") is False:
+            raise CS2ApiError(((body.get("error") or {}).get("message")) or "Request failed", 200, body)
+        return body if raw else (body.get("data") if isinstance(body, dict) else body)
+
+    # ---- Live ----
+    def live(self):
+        """Every match being played now, with series score, current map and map score."""
+        return self.get("/cs2/live")
+
+    def live_scoreboard(self, match_id: str):
+        """Round-level scoreboard for one live match: sides, round, player K/D/ADR, money."""
+        return self.get(f"/cs2/live/{_q(match_id)}/scoreboard")
+
+    # ---- Matches ----
+    def upcoming(self, limit: int = 50):
+        return self.get("/cs2/matches/upcoming", {"limit": limit})
+
+    def results(self, limit: int = 50):
+        return self.get("/cs2/matches/results", {"limit": limit})
+
+    def today(self):
+        return self.get("/cs2/matches/today")
+
+    def match(self, match_id: str):
+        return self.get(f"/cs2/matches/{_q(match_id)}")
+
+    def match_maps(self, match_id: str):
+        return self.get(f"/cs2/matches/{_q(match_id)}/maps")
+
+    def match_player_stats(self, match_id: str):
+        return self.get(f"/cs2/matches/{_q(match_id)}/player-stats")
+
+    def match_streams(self, match_id: str):
+        return self.get(f"/cs2/matches/{_q(match_id)}/streams")
+
+    # ---- Teams ----
+    def team(self, team: str):
+        """Team with roster and recent results. Accepts an id or a slug such as "vitality"."""
+        return self.get(f"/cs2/teams/{_q(team)}")
+
+    def team_matches(self, team: str, limit: int = 20):
+        return self.get(f"/cs2/teams/{_q(team)}/matches", {"limit": limit})
+
+    def team_stats(self, team: str):
+        return self.get(f"/cs2/teams/{_q(team)}/stats")
+
+    def team_map_stats(self, team: str):
+        return self.get(f"/cs2/teams/{_q(team)}/map-stats")
+
+    def head_to_head(self, team_a: str, team_b: str):
+        return self.get(f"/cs2/teams/{_q(team_a)}/h2h/{_q(team_b)}")
+
+    # ---- Players ----
+    def player(self, player: str):
+        """Player profile. Accepts an id or a slug such as "donk"."""
+        return self.get(f"/cs2/players/{_q(player)}")
+
+    def search_players(self, query: str, limit: int = 10):
+        return self.get("/cs2/players/search", {"q": query, "limit": limit})
+
+    def player_stats(self, player: str):
+        return self.get(f"/cs2/players/{_q(player)}/stats")
+
+    def player_matches(self, player: str, limit: int = 20):
+        return self.get(f"/cs2/players/{_q(player)}/matches", {"limit": limit})
+
+    # ---- Events ----
+    def events(self, status: str = "upcoming", limit: int = 50):
+        """status: "upcoming", "live" or "recent"."""
+        path = {"live": "/cs2/events/live", "recent": "/cs2/events/recent"}.get(status, "/cs2/events/upcoming")
+        return self.get(path, {"limit": limit})
+
+    def event(self, event: str):
+        return self.get(f"/cs2/events/{_q(event)}")
+
+    def event_matches(self, event: str):
+        return self.get(f"/cs2/events/{_q(event)}/matches")
+
+    def event_standings(self, event: str):
+        return self.get(f"/cs2/events/{_q(event)}/standings")
+
+    def event_bracket(self, event: str):
+        return self.get(f"/cs2/events/{_q(event)}/bracket")
+
+    # ---- Rankings and stats ----
+    def world_ranking(self, limit: int = 30):
+        return self.get("/cs2/rankings/world", {"limit": limit})
+
+    def vrs_ranking(self, limit: int = 30):
+        """Valve Regional Standings."""
+        return self.get("/cs2/rankings/vrs", {"limit": limit})
+
+    def leaderboard(self, metric: str, limit: int = 20):
+        """metric: e.g. "rating", "adr", "kast", "kd", "kills", "opening-kills"."""
+        return self.get(f"/cs2/leaderboards/{_q(metric)}", {"limit": limit})
+
+    def transfers(self, limit: int = 50):
+        return self.get("/cs2/transfers/recent", {"limit": limit})
+
+    def search(self, query: str):
+        """Teams, players, events and matches matching a name."""
+        return self.get("/cs2/search", {"q": query})
+
+    # ---- Skins ----
+    def search_skins(self, query: Optional[str] = None, **filters: Any):
+        """Search one word at a time ("redline"), or pass weapon=..., skin_name=... for an exact skin."""
+        return self.get("/cs2/skins/search", {"q": query, **filters})
+
+    def skin(self, slug: str):
+        return self.get(f"/cs2/skins/{_q(slug)}")
+
+    def skin_prices(self, slug: str):
+        """The skin's price on every marketplace, with listing counts and buy links."""
+        return self.get(f"/cs2/skins/{_q(slug)}/prices")
+
+    def skin_history(self, slug: str, range: Optional[str] = None):
+        return self.get(f"/cs2/skins/{_q(slug)}/history", {"range": range})
+
+    def trending_skins(self, timeframe: str = "7d", limit: int = 20, min_price: Optional[float] = None):
+        """Biggest movers: {"gainers": [...], "losers": [...]}."""
+        return self.get("/cs2/skins/trending", {"timeframe": timeframe, "limit": limit, "minPrice": min_price})

cs2_api_client-1.0.0/src/cs2_api_client.egg-info/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: cs2-api-client
+Version: 1.0.0
+Summary: CS2 API client: Counter-Strike 2 live scores, match results, player stats, teams, rankings (world + VRS), events and skin prices. Standard library only.
+Author: Cito API
+License-Expression: MIT
+Project-URL: Homepage, https://cs2-api.org
+Project-URL: Documentation, https://cs2-api.org/endpoints/
+Project-URL: Source, https://github.com/achillesscriptsvip/cs2-api
+Project-URL: Issues, https://github.com/achillesscriptsvip/cs2-api/issues
+Project-URL: Get a free API key, https://citoapi.com/signup?game=cs2&utm_source=pypi&utm_medium=referral&utm_campaign=cs2-api-package
+Keywords: cs2,cs2-api,counter-strike,counter-strike-2,csgo,hltv,hltv-api,esports,skins,skin-prices,api-client
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Games/Entertainment
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# cs2-api: Counter-Strike 2 API client for JavaScript and Python
+
+[![npm](https://img.shields.io/npm/v/cs2-api)](https://www.npmjs.com/package/cs2-api) [![PyPI](https://img.shields.io/pypi/v/cs2-api-client)](https://pypi.org/project/cs2-api-client/) [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+
+This is the official client for the **CS2 API** at [cs2-api.org](https://cs2-api.org). It covers:
+
+- live Counter-Strike 2 match scores and round-level scoreboards
+- match results, schedules and streams
+- player stats (rating, ADR, KAST, K/D) and leaderboards
+- teams, rosters and head-to-head
+- the world ranking and Valve Regional Standings (VRS)
+- events, standings and brackets
+- transfers
+- **CS2 skin prices across 25+ marketplaces**, with price history
+
+It has zero dependencies. The JavaScript client ships TypeScript types and works as ESM or CommonJS; the Python client needs only the standard library.
+
+> **You need a free API key** (500 requests/month, no card): **[Get your key](https://citoapi.com/signup?game=cs2&utm_source=npm-pypi&utm_medium=referral&utm_campaign=cs2-api-package)**
+
+## Install
+
+```bash
+npm install cs2-api
+```
+
+```bash
+pip install cs2-api-client
+```
+
+## JavaScript / TypeScript
+
+```js
+import { CS2Api } from "cs2-api";            // or: const { CS2Api } = require("cs2-api")
+
+const cs2 = new CS2Api();                     // reads process.env.CITO_API_KEY
+
+const live = await cs2.live();                // every match being played right now
+for (const m of live) {
+  console.log(`${m.team1Name} ${m.team1Score}-${m.team2Score} ${m.team2Name} · ${m.currentMap}`);
+}
+
+const ranking = await cs2.worldRanking({ limit: 10 });
+const vitality = await cs2.team("vitality");  // roster + recent results
+const donk = await cs2.player("donk");
+const prices = await cs2.skinPrices("ak-47-redline-field-tested-1ab1a2dc");
+```
+
+## Python
+
+```python
+from cs2_api import CS2Api
+
+cs2 = CS2Api()  # reads CITO_API_KEY
+
+for m in cs2.live():
+    print(f"{m['team1Name']} {m['team1Score']}-{m['team2Score']} {m['team2Name']} · {m['currentMap']}")
+
+ranking = cs2.world_ranking(limit=10)
+vitality = cs2.team("vitality")
+donk = cs2.player("donk")
+prices = cs2.skin_prices("ak-47-redline-field-tested-1ab1a2dc")
+```
+
+## Methods
+
+JavaScript uses camelCase and Python uses snake_case (`worldRanking` / `world_ranking`). Teams, players and events accept an id or a slug (`vitality`, `donk`).
+
+| Area | Methods |
+|---|---|
+| Live | `live()`, `liveScoreboard(matchId)`: sides, round, player K/D/ADR |
+| Matches | `upcoming()`, `results()`, `today()`, `match(id)`, `matchMaps(id)`, `matchPlayerStats(id)`, `matchStreams(id)` |
+| Teams | `team(slug)`, `teamMatches(slug)`, `teamStats(slug)`, `teamMapStats(slug)`, `headToHead(a, b)` |
+| Players | `player(slug)`, `searchPlayers(q)`, `playerStats(slug)`, `playerMatches(slug)` |
+| Events | `events({ status })`, `event(slug)`, `eventMatches(slug)`, `eventStandings(slug)`, `eventBracket(slug)` |
+| Rankings & stats | `worldRanking()`, `vrsRanking()`, `leaderboard(metric)`, `transfers()`, `search(q)` |
+| Skins | `searchSkins(q)`, `skin(slug)`, `skinPrices(slug)`, `skinHistory(slug)`, `trendingSkins()` |
+| Anything else | `get(path, query, { raw })`: any of the 140+ endpoints, with `meta` for pagination when `raw: true` |
+
+Errors throw `CS2ApiError` (JS) or raise `CS2ApiError` (Python), with `status` and the API's message.
+
+## Use cases
+
+- **Discord bots**: [cs2-discord-bot](https://github.com/achillesscriptsvip/cs2-discord-bot)
+- **Stream overlays**: [cs2-obs-overlay](https://github.com/achillesscriptsvip/cs2-obs-overlay)
+- **Skin trading tools**: [cs2-skin-price-api](https://github.com/achillesscriptsvip/cs2-skin-price-api)
+- **Moving off HLTV scrapers**: [hltv-api-alternative](https://github.com/achillesscriptsvip/hltv-api-alternative)
+- Fantasy, analytics dashboards, prediction models and AI agents
+
+## Keep your key safe
+
+Keep it in an environment variable or `.env` (git-ignored). Call the API from your server, never from browser code. If a key leaks, revoke it in your dashboard and create a new one.
+
+## Links
+
+- CS2 API docs and endpoints: https://cs2-api.org/endpoints/
+- Pricing: https://citoapi.com/pricing
+- Issues: https://github.com/achillesscriptsvip/cs2-api/issues
+
+Not affiliated with Valve, HLTV, ESL, BLAST or PGL. MIT licensed.

cs2_api_client-1.0.0/src/cs2_api_client.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+src/cs2_api/__init__.py
+src/cs2_api/py.typed
+src/cs2_api_client.egg-info/PKG-INFO
+src/cs2_api_client.egg-info/SOURCES.txt
+src/cs2_api_client.egg-info/dependency_links.txt
+src/cs2_api_client.egg-info/top_level.txt
+tests/test_live.py

cs2_api_client-1.0.0/src/cs2_api_client.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cs2_api_client-1.0.0/src/cs2_api_client.egg-info/top_level.txt

@@ -0,0 +1 @@
+cs2_api

cs2_api_client-1.0.0/tests/test_live.py

@@ -0,0 +1,72 @@
+"""Live test of every method: CITO_API_KEY=... python -m unittest discover -s tests -v"""
+
+import os
+import unittest
+
+from cs2_api import CS2Api, CS2ApiError
+
+HAS_KEY = bool(os.environ.get("CITO_API_KEY"))
+
+
+class NoKey(unittest.TestCase):
+    def test_missing_key_points_to_signup(self):
+        with self.assertRaises(CS2ApiError) as ctx:
+            CS2Api(api_key="")
+        self.assertIn("cs2-api.org", str(ctx.exception))
+
+
+@unittest.skipUnless(HAS_KEY, "set CITO_API_KEY to run live tests")
+class Live(unittest.TestCase):
+    def test_bad_key_is_401(self):
+        with self.assertRaises(CS2ApiError) as ctx:
+            CS2Api(api_key="cito_invalid").results(limit=1)
+        self.assertEqual(ctx.exception.status, 401)
+
+    def test_every_method_returns_data(self):
+        api = CS2Api()
+        results = api.results(limit=2)
+        mid = results[0]["id"]
+        ranking = api.world_ranking(limit=2)
+        a, b = (r["team"]["slug"] for r in ranking)
+        player = api.search_players("donk", limit=1)[0]
+        event = api.events(status="recent", limit=1)[0]
+        skin = api.search_skins("redline", limit=1)[0]
+        live = api.live()
+        calls = {
+            "live_scoreboard": api.live_scoreboard(live[0]["matchId"]) if live else "nothing live",
+            "upcoming": api.upcoming(limit=2),
+            "today": api.today(),
+            "match": api.match(mid),
+            "match_maps": api.match_maps(mid),
+            "match_player_stats": api.match_player_stats(mid),
+            "match_streams": api.match_streams(mid),
+            "team": api.team(a),
+            "team_matches": api.team_matches(a, limit=2),
+            "team_stats": api.team_stats(a),
+            "team_map_stats": api.team_map_stats(a),
+            "head_to_head": api.head_to_head(a, b),
+            "player": api.player(player["slug"]),
+            "player_stats": api.player_stats(player["slug"]),
+            "player_matches": api.player_matches(player["slug"], limit=2),
+            "event": api.event(event["slug"]),
+            "event_matches": api.event_matches(event["slug"]),
+            "event_standings": api.event_standings(event["slug"]),
+            "event_bracket": api.event_bracket(event["slug"]),
+            "vrs_ranking": api.vrs_ranking(limit=2),
+            "leaderboard": api.leaderboard("rating", limit=2),
+            "transfers": api.transfers(limit=2),
+            "search": api.search("vitality"),
+            "skin": api.skin(skin["slug"]),
+            "skin_prices": api.skin_prices(skin["slug"]),
+            "skin_history": api.skin_history(skin["slug"], range="30d"),
+            "trending_skins": api.trending_skins(limit=2),
+        }
+        for name, value in calls.items():
+            self.assertIsNotNone(value, name)
+        raw = api.get("/cs2/matches/results", {"limit": 1}, raw=True)
+        self.assertIn("meta", raw)
+        print(f"\n{len(calls) + 6} methods returned data")
+
+
+if __name__ == "__main__":
+    unittest.main()