Skip to content
everloot
Get the addon

/corpus/public

The public corpus: every public record players reported, without install ids

GEThttps://everloot.app/api/corpus/public

Anonymous observations as records, so anyone can check the counts behind a published fact. kinds narrows the body to the record kinds a reader needs. Named records appear only with a grant.

Access#

Open to anyone, limited per IP address; a free API key raises the limit. Data: observed in play. Limits and keys are explained on Limits and keys.

Query parameters#

kindsstring
Comma-separated record kinds to include. Unknown kinds are a 400.
offsetinteger
First row to return, 0 or more.
limitinteger
Rows per page. Capped at the caller's page size when the data guard is on.

Responses#

200corpusPublicResponse
The page of records.
400apiError
A parameter is wrong; error says which.
429apiError
Rate limited. Retry-After says when to try again.
503apiError
A dependency is unavailable. The answer is unrecorded, not zero.

Response fields#

The top-level fields of a successful answer. Full shapes are on Schemas and in the OpenAPI document.

okexactly truerequired
No description.
uploadsinteger, 0 to 9007199254740991required
No description.
recordsarray of objectsrequired
Records of the public kinds, each without its installId. Shapes: schema/records/<kind>.json.
dataAsOfstring, or null
When these records were current. Null or absent when unrecorded, never "now".
kindsarray of string
Present when the request asked for some kinds.
legacyRecordsinteger, 0 to 9007199254740991
No description.
attributionobjectrequired
No description.
offsetinteger, 0 to 9007199254740991required
No description.
limitinteger, 0 to 9007199254740991required
No description.
totalinteger, 0 to 9007199254740991required
No description.
nextstring, or nullrequired
No description.
Request
curl "https://everloot.app/api/corpus/public?limit=10"
Response
{
  "ok": true,
  "uploads": 0,
  "records": [
    {
      "key": null
    }
  ],
  "dataAsOf": "2026-11-04T12:00:00.000Z",
  "kinds": [
    "npc_sighting"
  ],
  "legacyRecords": 0,
  "attribution": {
    "licence": "string",
    "licenceUrl": "https://everloot.app",
    "credit": "string",
    "source": "https://everloot.app",
    "terms": "https://everloot.app"
  },
  "offset": 0,
  "limit": 0,
  "total": 0,
  "next": "https://everloot.app"
}

Example values show the shape of an answer, not real data.