HomeGetting startedRegistering with an HTTP keyGetting a credential without DiscordServer claim flowReport rules and the block windowVersion check and 426Authentication and server keysThe blocking modelError handlingRate limitsVersions and compatibilityPOST /v1/servers/claimPOST /v1/servers/reportPOST /v1/servers/revokePOST /plugin/v1/claimPOST /plugin/v1/reportGET /plugin/v1/versionGET /maps/{seed}GET /jobs/{seed}GET /seedsGET /stats/overviewGET /stats/protectionAPI changelog
Read API
GET
/api/seeds
The list of known seeds, newest dump first, paged by cursor. Seeds with an open block window are left out.
Path · query
| Field | In | Type | Required | Description |
|---|---|---|---|---|
| cursor | query | integer | optional | nextCursor of the previous page. Omit for the first page. |
| limit | query | integer | optional | 1..500, default 200. |
Responses
| Status | Body | When |
|---|---|---|
| 200 | {"items":[{"seed":1848055747,"roomCount":103,"spawns":218,"markers":0,"dumped":true,"detected":true}],"total":36252,"nextCursor":1848055747} | items are the seeds on this page, total the overall count, nextCursor the cursor for the next page (null on the last page). Blocked seeds are absent and reappear when the window ends. |
| 400 | {"error":"invalid cursor"} | cursor is not a valid seed. |
Response fields
| Field | Type | null | Description |
|---|---|---|---|
| items | array | no | Seeds on this page. Items are {seed, roomCount, spawns, markers, dumped, detected}. |
| items[].seed | integer | no | The seed. |
| items[].roomCount | integer | no | Number of rooms. |
| items[].spawns | integer | no | Number of candidate spawn points. |
| items[].markers | integer | no | Actual placements recorded at dump time. Not included in the public map response. |
| items[].dumped | boolean | no | true when the map has been generated. |
| items[].detected | boolean | no | true when Seed Sniffer has seen it. |
| total | integer | no | Total number of seeds, not counting blocked ones. |
| nextCursor | integer | yes | cursor for the next page. null on the last page. |
Example
curl https://slmaps.com/api/seeds -H "User-Agent: MyServer/1.0"
Response example
{
"items": [
{
"seed": 1848055747,
"roomCount": 103,
"spawns": 218,
"markers": 0,
"dumped": true,
"detected": true
}
],
"total": 36252,
"nextCursor": 1848055747
}What the viewer does
Public stats (seed counts and so on) are unaffected by blocking; only this list omits blocked seeds. New seeds are prepended, so paging never shifts or repeats items.
SLMAPS is the seed-map viewer for SCP: Secret Laboratory. These pages describe the public API of slmaps.com.slmaps.com ·