Repository navigation
Heardle
A daily song-guessing game: a short clip plays, and each wrong guess unlocks a little more of it. The leaderboards and the signed audio clip below are the only Heardle endpoints that work without a user token; the puzzle itself (fetching today's round, submitting a guess, skipping, personal stats) needs an authenticated account and isn't covered here.
Mounted at /juicewrld/heardle/leaderboard/ and mirrored under /accounts/heardle/leaderboard/ and /juicewrld/accounts/heardle/leaderboard/.
| Param | Default | Values |
|---|---|---|
board |
streak |
streak, today, versus
|
mode |
daily |
Also personal; ignored for versus
|
day |
today | YYYY-MM-DD |
limit |
50 | Max 100 |
offset |
0 |
{
"board": "streak",
"mode": "daily",
"day": "2026-09-10",
"entries": [ /* row shape depends on board, see below */ ],
"me": null
}me is only populated when an auth token is sent; sending one is optional here.
Row shapes by board:
| Board | Fields |
|---|---|
| streak | rank, user_id, display_name, discord_username, discord_avatar, played, won, win_rate, current_streak, max_streak, distribution |
| today | rank, user_id, display_name, discord_avatar, guesses, won |
| versus | rank, user_id, display_name, discord_avatar, played, won, lost, drawn, win_rate |
Serves the round's audio clip. Auth here is a signed round_token/sig pair (HMAC) handed out when the puzzle round was fetched, not an Authorization header.
| Param | Required | Description |
|---|---|---|
round_token |
Yes | |
sig |
Yes | HMAC signature over the round token |
unlock |
No | Integer, how much of the clip to unlock (default 0) |
403 on a bad signature:
{ "error": "Invalid signature" }Otherwise streams the audio file with Accept-Ranges: bytes.