Developers
Building a Discord bot, a stream overlay or a stats site? Don't scrape the pages: the aggregate data that is public on the site is also open here in a machine-readable form. No sign-up or key needed.
For information only. The data matches what the site shows and may lag by a few seconds; it is not an official record.
Rules
- Rate limit: 60 requests per minute per client address. Beyond that you get
429; theRetry-Afterheader tells you how many seconds to wait. - There is also an overall limit for the whole API: 3.000 requests per minute; beyond that you also get
429. - Responses may be cached for 15 seconds (
Cache-Control: public, max-age=15); polling faster gains nothing. - Every response carries an
ETagheader; send it back inIf-None-Matchand you get a body-less304 Not Modifiedwhen the data has not changed. GETonly. Responses are UTF-8 JSON with English camelCase field names; in-game names are not translated. Callable straight from a browser (Access-Control-Allow-Origin: *); no cookies.- Times are ISO 8601 in server time with the time-zone offset; every response carries the moment it was built in "updated".
- Only fields that are public on the site are included. There are no single-character, Guild or member endpoints, and no archive or search.
- The version is in the path (
/api/v1): adding fields is backward compatible; removing a field or changing its meaning means a new version.
Endpoints
Base address https://seasro.com/api/v1
GET /api/v1/serverServer status: population (occupancy, 0–100 in steps of 5; the live online count is not given), caravans on the road; active players (active: distinct players who logged in during the last 24 hours or are in the game now, plus hourly values for the last 7 days); today's log counts and the unique hunter of the week (weeklyHunter: last week's winner and this week's leader).
Sample response
/api/v1/server{ "updated": "2026-11-20T23:53:54.4797057+03:00", "server": { "sampledAt": "2026-11-20T23:50:00+03:00", "occupancy": 0, "caravansOnRoad": 0 }, "active": { "players": 310, "calculated": "2026-11-20T23:53:30.9563422+03:00", "hourlyLast7Days": [ { "hour": "2026-11-14T00:00:00+03:00", "players": 495 }, { "hour": "2026-11-14T01:00:00+03:00", "players": 505 } ] }, "today": { "events": 1704, "eventsByType": { "kervan": 0, "unique": 118, "arti": 0, "dusen": 2, "oldurme": 1082, "global": 502 } }, "weeklyHunter": { "lastWeek": { "name": "demoSunFox", "kills": 10, "weekStart": "2026-11-09", "lastUnique": "Cerberus (Int)", "lastKill": "2026-11-13T02:10:13.407+03:00" }, "thisWeek": { "name": "Ozi_Siker", "guild": "ASGARD", "kills": 6, "weekStart": "2026-11-16", "lastUnique": "Uruchi", "lastKill": "2026-11-20T22:32:41.94+03:00" } } }GET /api/v1/rankings/{type}The top 100 of a ranking: rank, name, score; Guild and Level on character rankings.
Types:
traderhunterthiefuniqueguildseviyeesya-puanialtinhonorunion-esya-puaniSample response
/api/v1/rankings/trader{ "updated": "2026-11-20T23:53:54.4798867+03:00", "type": "trader", "rows": [ { "rank": 1, "name": "demoDoO", "score": 2245282, "level": 4 }, { "rank": 2, "name": "demoExternal", "score": 6074036, "level": 4 } ] }GET /api/v1/uniqueUnique board: kill count, last killer and top killers for each unique; which are alive right now; recent kills with the damage breakdown.
Sample response
/api/v1/unique{ "updated": "2026-11-20T23:53:54.4800649+03:00", "uniques": [ { "mobRefId": 48972, "name": "Khulood", "kills": 4, "lastKilled": "2026-11-20T23:37:57.743+03:00", "lastKiller": "SuS_V_IzLe", "topKillers": [ { "rank": 1, "name": "Kehlani", "kills": 3 }, { "rank": 2, "name": "SuS_V_IzLe", "kills": 1 } ] }, { "mobRefId": 48969, "name": "Karkadann", "kills": 4, "lastKilled": "2026-11-20T23:34:31.43+03:00", "lastKiller": "Kehlani", "topKillers": [ { "rank": 1, "name": "Kehlani", "kills": 1 }, { "rank": 1, "name": "Leria", "kills": 1 } ] } ], "status": [ { "mobRefId": 49444, "name": "Tiger Girl (Int)", "alive": true, "spawned": "2026-11-20T23:53:47.77+03:00" }, { "mobRefId": 38195, "name": "Apis", "alive": true, "spawned": "2026-11-20T23:27:05.537+03:00" } ], "recentKills": [ { "mobRefId": 49460, "name": "Khulood (Int)", "time": "2026-11-20T23:37:57.743+03:00", "killer": "SuS_V_IzLe", "totalDamage": 14600138, "attackers": 4, "topDamage": [ { "rank": 1, "name": "SuS_V_IzLe", "damage": 4584281 }, { "rank": 2, "name": "SenseLivy", "damage": 4162198 } ] }, { "mobRefId": 49458, "name": "Karkadann (Int)", "time": "2026-11-20T23:34:31.43+03:00", "killer": "Kehlani", "totalDamage": 20355979, "attackers": 5, "topDamage": [ { "rank": 1, "name": "Kehlani", "damage": 5740186 }, { "rank": 2, "name": "SaykoN", "damage": 5498865 } ] } ] }GET /api/v1/eventsEvents for the next seven days: name, start, end when known, whether it's running now.
Sample response
/api/v1/events{ "updated": "2026-11-20T23:53:54.4802698+03:00", "events": [ { "name": "Battle Arena (Party)", "start": "2026-11-20T23:45:00+03:00", "end": "2026-11-21T00:05:00+03:00", "running": true }, { "name": "Medusa", "start": "2026-11-21T00:00:00+03:00", "running": false } ] }GET /api/v1/fortressesFortress owners: Fortress, owning Guild and tax rate (0–1).
Sample response
/api/v1/fortresses{ "updated": "2026-11-20T23:53:54.4804101+03:00", "fortresses": [ { "name": "Jangan Fortress", "guild": "demoSevenKin", "taxRate": 0 } ] }GET /api/v1/logbook/latest?type=…[&all=1]The Logbook's latest 50 logs, newest first; all types if none is given. By default these are the highlighted logs, as on the site; unique spawns and all other logs come only with tumu=1. Each log carries only the fields the site shows for its type. Items linked in a global message are in the Items array (name, definition ID, plus, rarity).
tur values:
kervanuniqueartidusenoldurmeglobalSample response
/api/v1/logbook/latest?type=global{ "updated": "2026-11-20T23:53:54.48045+03:00", "type": "global", "events": [ { "kind": "global", "type": "global", "time": "2026-11-20T23:53:51.967+03:00", "character": "Aiz_CriminaL", "text": "BU NASI BİR DMG DÜZENİ AMK SPEAR ÇAR SWORD ÇARA METEORS 8K ATIYOR SWORD ÇAR YATIRLA 10K ATIYOR :D" }, { "kind": "global", "type": "global", "time": "2026-11-20T23:50:43.25+03:00", "character": "000", "text": "stat sıfırlama varmıydı" } ] }
The samples are real responses from this moment; long lists are cut to their first two Items to keep them readable.
