# Liquipedia — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access comprehensive esports data from Liquipedia, the world's leading esports wiki. Retrieve match schedules, team rosters, player profiles, tournament results, and game-specific statistics across top titles including Valorant, Counter-Strike, League of Legends, and Dota 2.

**Category:** Sports | **Website:** [liquipedia.net/](https://liquipedia.net/) | **Docs:** [parse.bot/marketplace/0464450b-c564-4f84-a129-20d58885eab9/liquipedia-net-api](https://parse.bot/marketplace/0464450b-c564-4f84-a129-20d58885eab9/liquipedia-net-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-liquipedia-net-api-0464450b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_cs_esports_data

Retrieve Counter-Strike esports data for a player, team, or tournament from Liquipedia. At least one parameter must be provided. Multiple parameters can be combined in a single call. Returns stale_input if the specified page does not exist on Liquipedia.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `player` | string | No | Player page name on the counterstrike wiki (e.g. s1mple, ZywOo, NiKo) |
| `team` | string | No | Team page name on the counterstrike wiki (e.g. Natus_Vincere, FaZe_Clan) |
| `tournament` | string | No | Tournament page name on the counterstrike wiki (e.g. IEM_Katowice_2022) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-liquipedia-net-api-0464450b/get_cs_esports_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"player":"<string>","team":"<string>","tournament":"<string>"}'
```

### get_dota2_hero

Retrieve Dota 2 hero information from Liquipedia including abilities (with type, description, and stat values), talent tree, and Aghanim's Scepter/Shard upgrades. Returns stale_input if the hero page does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `hero_name` | string | Yes | Hero page name on the Dota 2 wiki (e.g. Anti-Mage, Phantom Assassin, Crystal Maiden). Use hyphens or underscores as they appear in Liquipedia URLs. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-liquipedia-net-api-0464450b/get_dota2_hero \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hero_name":"<string>"}'
```

### get_dota2_item

Retrieve Dota 2 item information from Liquipedia including gold cost, sell value, stat bonuses, active/passive ability details, and component items. Returns stale_input if the item page does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_name` | string | Yes | Item page name on the Dota 2 wiki (e.g. Black King Bar, Blink Dagger, Aghanim's Scepter). Use the display name with spaces as it appears on Liquipedia. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-liquipedia-net-api-0464450b/get_dota2_item \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_name":"<string>"}'
```

### get_lol_match_objectives

Retrieve team-level objective statistics for each game in a League of Legends match on Liquipedia. Returns towers, inhibitors, barons, dragons, heralds, void grubs, total kills, and total gold per team per game. Match IDs are sourced from the get_lol_team_matches endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `match_id` | string | Yes | Liquipedia match identifier (e.g. Match:ID_EWC2026GrC_R01-M002). Obtained from the match_id field of get_lol_team_matches results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-liquipedia-net-api-0464450b/get_lol_match_objectives \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"match_id":"<string>"}'
```

### get_lol_match_player_stats

Retrieve per-game per-player statistics for a League of Legends match on Liquipedia. Returns one entry per game in the series, each containing duration, winner, patch, and a full player stats array (10 players per game). Stats include kills, deaths, assists, CS, gold, and damage. Match IDs are sourced from the get_lol_team_matches endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `match_id` | string | Yes | Liquipedia match identifier (e.g. Match:ID_EWC2026GrC_R01-M002). Obtained from the match_id field of get_lol_team_matches results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-liquipedia-net-api-0464450b/get_lol_match_player_stats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"match_id":"<string>"}'
```

### get_lol_team_matches

Scrape the League of Legends played matches table for a given team from Liquipedia. Returns individual game rows with date, tier, tournament, result, champion picks/bans for both sides, game length, patch version, and a Liquipedia match identifier. Matches are returned in reverse chronological order (most recent first). The page shows approximately one season of match history.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `end_date` | string | No | Filter matches on or before this date. ISO format YYYY-MM-DD. |
| `start_date` | string | No | Filter matches on or after this date. ISO format YYYY-MM-DD. |
| `team` | string | Yes | Liquipedia team page slug (e.g. T1, Cloud9, Fnatic, Gen.G) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-liquipedia-net-api-0464450b/get_lol_team_matches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"end_date":"<string>","start_date":"<string>","team":"<string>"}'
```

### get_lol_teams

Retrieve all League of Legends teams listed on Liquipedia's Portal:Teams page, including active and disbanded teams across all regions. Returns team name, wiki slug, region, and active years (derived from team page creation/disbanding dates). Results can be filtered to teams active within a specified year range. Teams are sourced from Liquipedia's Main Leagues, Secondary Leagues, and Notable Disbanded teams sections.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `end_year` | string | No | Filter to teams active on or before this year (4-digit year, e.g. 2025). Teams created after this year are excluded. |
| `start_year` | string | No | Filter to teams active on or after this year (4-digit year, e.g. 2021). Teams disbanded before this year are excluded. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-liquipedia-net-api-0464450b/get_lol_teams \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"end_year":"<string>","start_year":"<string>"}'
```

### get_team_roster

Get the current active team roster for a specific team on any Liquipedia wiki. Returns player IDs, real names, join dates, and positions (where available). Returns stale_input if the team page does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team` | string | No | Team page name on the specified wiki (e.g. FlyQuest, T1, Cloud9, Sentinels) |
| `wiki` | string | No | Liquipedia wiki name: leagueoflegends, valorant, counterstrike, dota2 |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-liquipedia-net-api-0464450b/get_team_roster \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"team":"<string>","wiki":"<string>"}'
```

### get_upcoming_matches

Get upcoming and recent esports matches across Valorant, Counter-Strike, League of Legends, and Dota 2. Returns matches from the last hour onwards, sorted chronologically. Times are in Philippine Time (UTC+8).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-liquipedia-net-api-0464450b/get_upcoming_matches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_valorant_agent_stats

Extract Valorant agent usage statistics and map play counts from a tournament statistics page on Liquipedia. Returns agent pick rates (when available), individual player stats, and map play counts. The page must use the exact Liquipedia wiki path. Returns stale_input if the tournament page does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `tournament_path` | string | No | Tournament statistics page path on the Valorant wiki (e.g. VCT/2025/Champions/Statistics, VCT/2024/Stage_1/Masters/Statistics). Must match the exact Liquipedia page title. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-liquipedia-net-api-0464450b/get_valorant_agent_stats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tournament_path":"<string>"}'
```