Entwickler
Du baust einen Discord-Bot, ein Stream-Overlay oder eine Statistikseite? Lies die Seiten nicht per Scraping aus: Die gesammelten Daten, die auf der Website öffentlich sind, gibt es hier auch maschinenlesbar. Keine Anmeldung, kein Schlüssel.
Nur zur Information. Die Daten entsprechen der Anzeige auf der Website und können einige Sekunden nachhinken; sie sind kein offizieller Nachweis.
Regeln
- Ratenlimit: 60 Anfragen pro Minute und Client-Adresse. Darüber hinaus kommt
429; der HeaderRetry-Afternennt die Wartezeit in Sekunden. - Zusätzlich gilt ein Gesamtlimit für die ganze API: 3.000 Anfragen pro Minute; darüber erhältst du ebenfalls
429. - Antworten dürfen 15 Sekunden zwischengespeichert werden (
Cache-Control: public, max-age=15); häufigeres Abfragen bringt nichts. - Jede Antwort hat einen
ETag-Header; sendest du ihn inIf-None-Matchzurück, erhältst du304 Not Modifiedohne Inhalt, wenn sich die Daten nicht geändert haben. - Nur
GET. Antworten sind UTF-8-JSON mit englischen camelCase-Feldnamen; Spielnamen werden nicht übersetzt. Direkt aus dem Browser aufrufbar (Access-Control-Allow-Origin: *); keine Cookies. - Zeiten sind ISO 8601 in Serverzeit mit Zeitzonenversatz; jede Antwort trägt ihren Erstellungszeitpunkt in "updated".
- Es gibt nur Felder, die auf der Website öffentlich sind. Keine Schnittstellen für einzelne Charaktere, Guild oder Mitglieder, kein Archiv und keine Suche.
- Die Version steht im Pfad (
/api/v1): neue Felder sind kompatibel; ein Feld zu entfernen oder seine Bedeutung zu ändern ergibt eine neue Version.
Schnittstellen
Basisadresse https://seasro.com/api/v1
GET /api/v1/serverServer-Status: Auslastung (occupancy, 0–100 in 5er-Schritten; die aktuelle Online-Zahl wird nicht ausgegeben), Karawanen unterwegs; aktive Spieler (active: verschiedene Spieler, die sich in den letzten 24 Stunden eingeloggt haben oder gerade im Spiel sind, dazu stündliche Werte der letzten 7 Tage); heutige Log-Zahlen und der Unique-Jäger der Woche (weeklyHunter).
Beispielantwort
/api/v1/server{ "updated": "2026-11-20T23:53:54.5874127+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}Die Top 100 einer Rangliste: Platz, Name, Wert; bei Charakterranglisten auch Guild und Level.
Typen:
traderhunterthiefuniqueguildseviyeesya-puanialtinhonorunion-esya-puaniBeispielantwort
/api/v1/rankings/trader{ "updated": "2026-11-20T23:53:54.5875017+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-Tafel: Anzahl der Kills je Unique, wer zuletzt und wer am häufigsten gekillt hat; welche gerade leben; letzte Kills mit Schadensübersicht.
Beispielantwort
/api/v1/unique{ "updated": "2026-11-20T23:53:54.5876532+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 der nächsten sieben Tage: Name, Beginn, Ende falls bekannt, ob es gerade läuft.
Beispielantwort
/api/v1/events{ "updated": "2026-11-20T23:53:54.5878594+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-Besitzer: Fortress, besitzende Guild und Steuersatz (0–1).
Beispielantwort
/api/v1/fortresses{ "updated": "2026-11-20T23:53:54.5880957+03:00", "fortresses": [ { "name": "Jangan Fortress", "guild": "demoSevenKin", "taxRate": 0 } ] }GET /api/v1/logbook/latest?type=…[&all=1]Die neuesten 50 Logs des Logbuchs, neueste zuerst; ohne Typ alle Typen. Standardmäßig sind es wie auf der Website die hervorgehobenen Logs; Unique-Spawns und alle übrigen Logs kommen nur mit tumu=1. Jedes Log enthält nur die Felder, die die Website für seinen Typ zeigt. In einer globalen Nachricht verlinkte Items stehen im Array Items (Name, Definitions-ID, Plus, Seltenheit).
Werte für tur:
kervanuniqueartidusenoldurmeglobalBeispielantwort
/api/v1/logbook/latest?type=global{ "updated": "2026-11-20T23:53:54.5881686+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ı" } ] }
Die Beispiele sind echte Antworten von diesem Moment; lange Listen sind zur Lesbarkeit auf die ersten zwei Einträge gekürzt.
