Seramate APIseramate.com ↗
Access World of Warcraft PvP leaderboards, character profiles, seasonal stats, cutoffs, gladiator titles, and activity via the Seramate API. 10 endpoints.
What is the Seramate API?
The Seramate API exposes 10 endpoints covering World of Warcraft PvP data including ranked leaderboards, character profiles, seasonal population statistics, R1 title cutoffs, and gladiator tracking. The get_leaderboard endpoint returns paginated ranked entries filterable by region, bracket, spec, race, realm, and faction, while get_character_profile surfaces per-bracket ratings, alt characters, titles, and talent loadouts for any named character.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/f7703f4a-2277-4441-a5d7-66fb8adcb997/get_seasons_list' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace seramate-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.seramate_wow_pvp_api import Seramate, Region, Bracket, Timeframe, TitleType
seramate = Seramate()
# List available PvP seasons
for season in seramate.seasons.list():
print(season.name, season.blizzard_id, season.stats_available)
# Get top 3v3 leaderboard entries for US region
for entry in seramate.leaderboardentries.list(region=Region.US, bracket=Bracket.THREE_V_THREE, limit=5):
print(entry.character.name, entry.standing.rank, entry.standing.rating, entry.season_stats.won)
# Get recent activity in the last 3 hours
for activity in seramate.activityentries.list(region=Region.US, bracket=Bracket.THREE_V_THREE, timeframe=Timeframe.THREE_HOURS, limit=3):
print(activity.character.name, activity.rating_delta.new_rating, activity.played_delta.won)
# Search characters by name
for result in seramate.characters.search(query="Reckful"):
print(result.name, result.realm_name, result.max_rating)
# Get gladiator title holders
for gladiator in seramate.gladiatorentries.list(region=Region.EU, title_type=TitleType.GLADIATOR, limit=3):
print(gladiator.character.name, gladiator.title.completed_at, gladiator.title.rank)
# Get rating history for a specific character
character = seramate.character(id="1f123dd6-5146-69c4-8bc8-1a549dbc1b54")
for point in character.rating_history.list(bracket=Bracket.THREE_V_THREE):
print(point.date, point.rating)
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.
No input parameters required.
{
"type": "object",
"fields": {
"data": "array of season objects with id, name, blizzard_id, season_start, season_end, stats_available, cutoff_available"
},
"sample": {
"data": {
"data": [
{
"id": "1f122bec-9250-6358-ac6a-120e99045b58",
"name": "Midnight Season 1",
"prefix": null,
"season_end": null,
"blizzard_id": 41,
"season_start": "2026-03-17T15:00:00.000000Z",
"stats_available": true,
"cutoff_available": true
}
]
},
"status": "success"
}
}About the Seramate API
Leaderboards and Activity
The get_leaderboard endpoint returns ranked PvP standings for the 2v2, 3v3, rbg, shuffle, and blitz brackets in the us and eu regions. Each entry includes the character's standing (rank and rating) plus season_stats fields for games played, won, and lost. Filter by Blizzard spec IDs via the specs parameter (e.g. [257] for Holy Priest) or pass JSON arrays to races, realms, and factions. The season_id maps to the blizzard_id returned by get_seasons_list — for example, 41 for Midnight Season 1. The get_activity endpoint exposes the same filter surface but returns recent rating_delta, played_delta, and rank_delta values to show who is actively climbing or dropping.
Character Data
get_character_profile accepts a character name, realm slug, and region and returns a nested object with four top-level keys: pvp (per-bracket ratings including personal_best and season_best), summary (race, class, spec, faction, guild, gear, and media), alts (linked alternate characters with their own bracket data), and titles (individual title achievements with type counts). Talent specializations including PvP-specific talents are also returned. Once you have a character UUID — from search_characters, get_leaderboard, or get_character_profile — pass it to get_character_rating_history to retrieve an ISO-timestamped time series of rating changes for any bracket.
Seasonal Statistics and Cutoffs
get_seasonal_stats breaks down bracket population by spec, reporting total_characters, total_active, and total_games_played, plus a time-series average_rating array (date, characters, rating, played, wins, losses per spec). get_cutoffs returns the current R1 cutoff thresholds per bracket and faction — cutoff_3s and cutoff_rbg split by alliance and horde, while shuffle_cutoffs and blitz_cutoffs are arrays of per-spec cutoff ratings. get_gladiators lists players who earned the gladiator, legend, elite, or duelist title in a given season, paginated and sorted by completion time, with a first_time boolean per entry.
Search
search_characters is an autocomplete endpoint that returns UUID, realm, class, faction, and max_rating for matching character names across all regions. advanced_search accepts natural language queries such as "warriors above 2000" or "Night Elf Druids on US realms" and returns a filters array showing how the query was parsed alongside paginated character results.
The Seramate API is a managed, monitored endpoint for seramate.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when seramate.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official seramate.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a PvP leaderboard tracker that monitors rank and rating changes across US and EU brackets each day.
- Display a player's complete PvP resume — per-bracket ratings, personal bests, and earned titles — using get_character_profile.
- Alert users when R1 cutoffs shift by polling get_cutoffs for a given season and region.
- Create a spec tier-list tool using per-spec population and average rating data from get_seasonal_stats.
- Track a gladiator's title completion date and whether it was a first-time achievement via get_gladiators.
- Power a character search feature with autocomplete via search_characters, then chart rating history with get_character_rating_history.
- Filter recent activity by spec and realm to surface which players are currently pushing rating in a given bracket.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.