Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aydenjahola/tracker-gg-api
This API allows you to fetch statistics for Valorant, CS2 and TFT players, including current and all-time statistics. The API is built using FastAPI and utilizes web scraping to gather player data from Tracker.gg
https://github.com/aydenjahola/tracker-gg-api
api counter-strike counter-strike-2 cs cs2 scrape scraper tft tracker tracker-gg valorant
Last synced: about 2 months ago
JSON representation
This API allows you to fetch statistics for Valorant, CS2 and TFT players, including current and all-time statistics. The API is built using FastAPI and utilizes web scraping to gather player data from Tracker.gg
- Host: GitHub
- URL: https://github.com/aydenjahola/tracker-gg-api
- Owner: aydenjahola
- License: gpl-3.0
- Created: 2024-10-01T14:32:12.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-11-19T21:21:05.000Z (2 months ago)
- Last Synced: 2024-11-19T21:32:33.772Z (2 months ago)
- Topics: api, counter-strike, counter-strike-2, cs, cs2, scrape, scraper, tft, tracker, tracker-gg, valorant
- Language: Python
- Homepage: https://tracker-api.aydenjahola.com
- Size: 113 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Tracker.gg Stats API
This API allows you to fetch statistics for Valorant, CS2 and TFT players, including current and all-time statistics. The API is built using FastAPI and utilizes web scraping to gather player data from [Tracker.gg](https://tracker.gg/).
## Table of Contents
- [Features](#features)
- [Getting Started](#getting-started)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Environment Variables](#environment-variables)
- [API Endpoints](#api-endpoints)
- [Valorant](#Valorant)
- [Get Current Act Stats](#get-current-act-stats)
- [Get All Seasons Stats](#get-all-seasons-stats)
- [CS2](#cs2)
- [Gel All Time Player's Stats](#get-all-time-player-stats)
- [Response Model](#response-model)
- [Error Handling](#error-handling)
- [License](#license)
## Features
- Fetch current act statistics for a given Valorant player.
- Fetch all-time statistics across seasons for a given Valorant player.
- Fetch all player's statistics for CS2
- API key authentication for secure access.
## Getting Started
### Prerequisites
- Python 3.7 or higher
### Installation
1. Clone the repository:
```bash
[email protected]:aydenjahola/tracker-gg-api.git
cd tracker-gg-api.git
```
2. Create virtual environment
```bash
python3 -m venv vevn
```
3. Actiave the virtual environemnt
```bash
source venv/bin/activate # For Linux
source venv/Scripts/Actiave # For Windows
```
4. Install the required packages:
```bash
pip install -r requirements.txt
```
### Environment Variables
Create a `.env` file in the root of the project directory and add your API keys:
```env
API_KEYS=your_api_key,your_api_key2 # Create a new key using the openssl command
STEAM_API_KEY=your_steam_api_key
FLARESOLVERR_URL=your_flare_solver_url
```
Make sure to replace `your_api_key1,your_api_key2` with your actual API keys.
## API Endpoints
### Valorant
#### Get Current Act Stats
**Endpoint:** `GET /valorant/player/{username}/current`
**Description:** Fetch the current act statistics for a given Valorant player.
**Parameters:**
- `username`: The Riot username of the player (eg. Shitter#1234).
- `X-API-Key`: Your API key (header).
#### Get All Seasons Stats
**Endpoint:** `GET /valorant/player/{username}/all`
**Description:** Fetch all seasons' statistics for a given Valorant player.
**Parameters:**
- `username`: The Riot username of the player (eg. Shitter#1234).
- `X-API-Key`: Your API key (header).
### CS2
#### Get All Time Player Stats
**Endpoint:** `GET /cs2/player/{steam_id}`
**Description:** Fetch all player's stats for CS2.
**Parameters:**
- `steamid`: The steam id of the player.
- `X-API-Key`: Your API key (header).
## Error Handling
- **403 Forbidden:** If the API key is invalid.
- **404 Not Found:** If the player's stats cannot be found.
## License
This project is licensed under the [GPL-3.0 license ](./LICENSE). See the LICENSE file for details.
---
Feel free to reach out for any questions or contributions to the project!