# Seramate — 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.

> Track World of Warcraft PvP performance with access to leaderboards, character profiles, seasonal statistics, and gladiator rankings across different competitive seasons. Search and monitor player ratings, activity history, and cutoff thresholds to stay updated on the competitive PvP landscape.

**Category:** Sports | **Website:** [seramate.com/](https://seramate.com/) | **Docs:** [parse.bot/marketplace/e0479878-fe81-43d6-a8e7-4f774b13ec6f/seramate-com-api](https://parse.bot/marketplace/e0479878-fe81-43d6-a8e7-4f774b13ec6f/seramate-com-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-seramate-com-api-e0479878/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### advanced_search

Perform advanced natural language search for characters. Accepts queries like 'warriors above 2000' or 'Night Elf Druids on US realms'. Returns paginated character results with profile data. The server parses the query into structured filters (class, rating, region, etc.).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `natural_query` | string | Yes | Natural language search query describing the characters to find. |
| `page` | integer | No | Page number. |
| `per_page` | integer | No | Results per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-seramate-com-api-e0479878/advanced_search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"natural_query":"<string>","page":"<integer>","per_page":"<integer>"}'
```

### get_activity

Fetch recent PvP activity for a region and bracket. Returns paginated list of characters with rating changes and games played within the specified timeframe. Each entry includes full character details, rating_delta, played_delta, rank_delta, and last_seen_at.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bracket` | string | No | PvP bracket. |
| `factions` | string | No | JSON array of faction filters. |
| `page` | integer | No | Page number. |
| `per_page` | string | No | Results per page. |
| `races` | string | No | JSON array of race filters. |
| `realm_categories` | string | No | JSON array of realm category filters. |
| `realms` | string | No | JSON array of realm filters. |
| `region` | string | No | Region code. |
| `specs` | string | No | JSON array of spec filters (blizzard spec IDs). |
| `timeframe` | string | No | Time window for activity. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-seramate-com-api-e0479878/get_activity \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bracket":"<string>","factions":"<string>","page":"<integer>","per_page":"<string>","races":"<string>","realm_categories":"<string>","realms":"<string>","region":"<string>","specs":"<string>","timeframe":"<string>"}'
```

### get_character_profile

Fetch the full profile of a WoW character including summary, PvP stats, alts, titles, and talents. The character is resolved via autocomplete search. Returns composite object with summary (character details, profile, media), pvp (bracket stats), alts, titles, and talents sections.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | Yes | Character name (case-insensitive). |
| `realm` | string | Yes | Realm slug (e.g. 'tichondrius', 'blades-edge', 'azshara'). |
| `region` | string | Yes | Region code. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-seramate-com-api-e0479878/get_character_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"<string>","realm":"<string>","region":"<string>"}'
```

### get_character_rating_history

Fetch historical rating progression for a character in a specific bracket. Returns time-series data of rating changes over the season. The UUID can be obtained from search_characters, get_leaderboard, or get_character_profile results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bracket` | string | No | PvP bracket. |
| `uuid` | string | Yes | Character UUID from search_characters.data[*].id, get_leaderboard.data[*].character.id, or get_character_profile.summary.character.id. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-seramate-com-api-e0479878/get_character_rating_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bracket":"<string>","uuid":"<string>"}'
```

### get_cutoffs

Fetch current R1 title cutoffs for 3v3, RBG, Shuffle, and Blitz per spec for a given season and region. Returns alliance and horde cutoff ratings for 3v3/RBG, plus per-spec cutoffs for shuffle and blitz.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `region` | string | No | Region code. |
| `season_id` | string | No | Season blizzard_id as string. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-seramate-com-api-e0479878/get_cutoffs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"region":"<string>","season_id":"<string>"}'
```

### get_gladiators

Fetch the list of players who earned specific PvP titles for a given season. Returns paginated list sorted by completion time. Each entry includes full character details and title info (type, completed_at, rank, first_time).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number. |
| `per_page` | string | No | Results per page. |
| `region` | string | No | Region code. |
| `season_id` | string | No | Season blizzard_id as string. |
| `title_type` | string | No | Title type. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-seramate-com-api-e0479878/get_gladiators \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","per_page":"<string>","region":"<string>","season_id":"<string>","title_type":"<string>"}'
```

### get_leaderboard

Fetch the current or archived PvP leaderboard for a region and bracket. Returns paginated ranked entries with character info, standing (rank, rating), and season_stats (played, won, lost). Use blizzard_id from get_seasons_list as season_id.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bracket` | string | No | PvP bracket. |
| `factions` | string | No | JSON array of faction filters. |
| `page` | integer | No | Page number. |
| `per_page` | string | No | Results per page. |
| `races` | string | No | JSON array of race filters. |
| `realm_categories` | string | No | JSON array of realm category filters. |
| `realms` | string | No | JSON array of realm filters. |
| `region` | string | No | Region code. |
| `season_id` | string | No | Season blizzard_id as string. Omitting returns current season. |
| `specs` | string | No | JSON array of spec filters (blizzard spec IDs). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-seramate-com-api-e0479878/get_leaderboard \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bracket":"<string>","factions":"<string>","page":"<integer>","per_page":"<string>","races":"<string>","realm_categories":"<string>","realms":"<string>","region":"<string>","season_id":"<string>","specs":"<string>"}'
```

### get_seasonal_stats

Fetch seasonal PvP statistics including population breakdown by spec, total population, and average rating progression over time. Returns three sub-objects: population (per-spec totals), population_total (cross-bracket totals), and average_rating (time-series per spec).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bracket` | string | No | PvP bracket. |
| `region` | string | No | Region code. |
| `season_id` | string | No | Season blizzard_id as string. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-seramate-com-api-e0479878/get_seasonal_stats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bracket":"<string>","region":"<string>","season_id":"<string>"}'
```

### get_seasons_list

Fetch the list of all available WoW PvP seasons. Returns season metadata including blizzard_id (used as season_id in other endpoints), name, start/end dates, and whether stats/cutoffs are available. Seasons are ordered newest first.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-seramate-com-api-e0479878/get_seasons_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_characters

Search for characters by name (autocomplete). Returns matching characters across all regions with basic info including UUID, realm, class, faction, and max rating. Results are ordered by rank weight (highest-achieving characters first).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Character name search query. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-seramate-com-api-e0479878/search_characters \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```