API Docs

Public read-only API. Base URL: https://api.bpsea-db.de

GET/api/stats

Dashboard counters. scannedToday / newToday / updatedToday are counted from 00:00 SEA time (UTC+8).

Example Request

curl https://api.bpsea-db.de/api/stats

Example Response

{
  "playerCount": 1234,
  "scannedToday": 56,
  "newToday": 7,
  "updatedToday": 49
}

GET/api/players?class=&search=&page=&limit=

Paginated player list, ordered by ability score (desc). Search auto-detects: numeric input matches UID exactly, text matches name (case-insensitive).

Parameters

class	Filter by class (e.g. Stormblade, Frost Mage). Optional.
search	Search by name or UID. Optional.
page	Page number, starts at 1. Default: 1.
limit	Results per page, 1-100. Default: 50.

Example Request

curl "https://api.bpsea-db.de/api/players?class=Stormblade&page=1&limit=50"

Example Response

{
  "players": [
    {
      "uid": 1234567,
      "name": "PlayerName",
      "class": "Stormblade",
      "level": 80,
      "abilityScore": 62549,
      "seasonScore": 3585,
      "maxHp": 330916,
      "firstSeenAt": "2026-09-01T00:34:15.213Z",
      "lastSeenAt": "2026-09-09T00:51:59.948Z",
      "lastScannedAt": "2026-09-09T00:51:59.948Z"
    }
  ],
  "total": 1234,
  "page": 1,
  "limit": 50
}

GET/api/players/:uid

Single player detail with the 10 most recent snapshots. Returns 404 { error: 'not found' } for unknown UID.

Parameters

:uid	Player UID (path parameter).

Example Request

curl https://api.bpsea-db.de/api/players/1234567

Example Response

{
  "uid": 1234567,
  "name": "PlayerName",
  "class": "Stormblade",
  "abilityScore": 62549,
  "seasonScore": 3585,
  "maxHp": 330916,
  "snapshots": [
    {
      "id": 16,
      "uid": 1234567,
      "abilityScore": 62549,
      "seasonScore": 3585,
      "maxHp": 330916,
      "createdAt": "2026-09-08T00:34:15.428Z"
    }
  ]
}

← Back to Dashboard