API Reference

Public REST API. Base URL: https://dashstats.net

Public & read-only.No authentication required. All responses are JSON. Build whatever you want on top of this — bots, overlays, profile widgets, stat trackers.

Need a ready-made Streamlabs widget? Open the overlay setup page.

GET/api/stats

Platform-wide statistics — total users, completions, XP, and demons.

Example

curl https://dashstats.net/api/stats

Response

{
  "totalUsers": 12847,
  "totalCompletions": 847293,
  "totalXp": 1248390,
  "totalDemons": 42810
}

GET/api/leaderboard

Paginated leaderboard. Supports multiple tabs for different ranking modes.

Query Parameters

`tab`	string	Ranking mode: global \| demons \| levels \| weekly. Default: global
`page`	number	Page number (1-indexed). Default: 1
`limit`	number	Results per page, max 100. Default: 25

Example

curl "https://dashstats.net/api/leaderboard?tab=global&page=1&limit=25"

Response

{
  "entries": [
    {
      "rank": 1,
      "userId": "uuid",
      "gdUsername": "SpaceUK",
      "avatarUrl": "...",
      "totalXp": 24850,
      "totalDemons": 312,
      "totalLevels": 1204,
      "level": 62
    }
  ],
  "total": 12847,
  "page": 1,
  "totalPages": 514
}

GET/api/player/:username

Full profile data for a player by their GD username.

Example

curl https://dashstats.net/api/player/spaceuk

Response

{
  "id": "uuid",
  "gdUsername": "SpaceUK",
  "avatarUrl": "...",
  "createdAt": "2026-01-01T00:00:00.000Z",
  "rank": 1,
  "stats": {
    "totalXp": 24850,
    "level": 62,
    "totalDemons": 312,
    "totalLevels": 1204,
    "easyDemons": 120,
    "mediumDemons": 80,
    "hardDemons": 60,
    "insaneDemons": 32,
    "extremeDemons": 20
  },
  "followerCount": 248,
  "followingCount": 31
}

GET/api/player/:username/now-playing

Live play state for a player. Returns offline, online, or the current level being played with resolved difficulty metadata when available.

Example

curl https://dashstats.net/api/player/spaceuk/now-playing

Response

{
  "userId": "uuid",
  "gdUsername": "SpaceUK",
  "status": "playing",
  "lastHeartbeat": 1773436800000,
  "nowPlaying": {
    "levelId": 61079355,
    "levelName": "Acu",
    "difficulty": "INSANE_DEMON",
    "difficultyLabel": "Insane Demon",
    "stars": 10,
    "isDemon": true
  }
}

GET/api/player/:username/completions

Paginated completion history for a player.

Query Parameters

`page`	number	Page number. Default: 1
`limit`	number	Results per page, max 100. Default: 20

Example

curl "https://dashstats.net/api/player/spaceuk/completions?page=1"

Response

{
  "completions": [
    {
      "id": "uuid",
      "level_id": 12345678,
      "level_name": "Bloodbath",
      "difficulty": "EXTREME_DEMON",
      "xp_earned": 150,
      "coins_collected": 3,
      "coins_total": 3,
      "completed_at": "2026-02-08T10:00:00.000Z"
    }
  ],
  "total": 1204,
  "page": 1,
  "totalPages": 61
}

GET/api/feed

Global activity feed of recent completions. Cursor-paginated.

Query Parameters

`limit`	number	Number of items to return, max 50. Default: 20
`cursor`	string	ISO timestamp — returns items before this time (older)
`after`	string	ISO timestamp — returns items after this time (newer, for polling)

Example

curl "https://dashstats.net/api/feed?limit=20"

Response

{
  "items": [
    {
      "id": "uuid",
      "gdUsername": "SpaceUK",
      "avatarUrl": "...",
      "levelId": 12345678,
      "levelName": "Acu",
      "difficulty": "EXTREME_DEMON",
      "xpEarned": 150,
      "coinsCollected": 3,
      "coinsTotal": 3,
      "thumbnailUrl": "/api/levels/12345678/thumbnail",
      "completedAt": "2026-02-08T10:00:00.000Z"
    }
  ],
  "nextCursor": "2026-02-08T09:00:00.000Z"
}