Players

Search players

Autocomplete usernames as someone types.

GET/v1/players/search

Finds players whose username starts with q. An exact match always comes first, then the richest players, then the most recently seen. It is built for search boxes: fast, small and cached.

Authentication

API key with the read scope

Cached for

30 s

Data updates

Live.

curl "https://api.donutstats.io/v1/players/search?q=Abu&limit=3" \
  -H "x-api-key: $DONUTSTATS_API_KEY"

Response200OK

{
  "players": [
    {
      "username": "Abuodee",
      "money": 4800000000000,
      "lastSeenAt": 1792723646257
    },
    {
      "username": "Abudoee",
      "money": 32700000000,
      "lastSeenAt": 1792723228858
    }
  ]
}

Try itCounts towards your plan

Query parameters

qstringrequired
Start of a username. Letters, digits and underscores, with an optional leading dot.
1 to 16 characters
limitintegeroptionaldefault 10
Players to return.
1 to 25

Response

Matching players, best match first.

playersobject[]
Up to limit players.
ShowHide3 child fields
- usernamestring
  Username with its current capitalization.
- moneynumber | null
  Balance in DonutSMP dollars, when known.
- lastSeenAttimestamp
  When the player last showed up anywhere.