seramate.com APIseramate.com ↗
Access World of Warcraft PvP leaderboards, character profiles, seasonal stats, cutoffs, gladiator titles, and activity via the Seramate API. 10 endpoints.
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'
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.
No input parameters required.
{
"type": "object",
"fields": {
"data": "array of season objects with id (UUID), name, blizzard_id (integer), 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.com 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.
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.
- 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 | 250 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.