The Bonkverse API
The Bonkverse API lets your site or Discord bot read bonk.io player data that Bonkverse collects from public replays: each player's level, when that level was last seen, and how their level has grown over time.
It's a small, read-only JSON API. Every request needs an API key.
POST
/api/v1/lookup/players/- CometLv 87last seen Nov 8
- pebblelevel hidden by player
- marmotLv 64last seen Nov 7
- TidepoolLv 71last seen Nov 8
- ghostieLv 58last seen Oct 31
https://bonkverse.io/api/v1/
What you can get
| You want | Use |
|---|---|
| One player's current level and when it was seen | GET /players/{username}/ |
| Up to 250 players at once, for a leaderboard | POST /lookup/players/ |
| Every level-up a player has had | GET /players/{username}/level-history/ |
| To check your key works | GET /me/ |
Skins aren't in the API yet. They're next: see the changelog.
Where the data comes from
bonk.io doesn't publish player stats. Bonkverse archives public replays, and each replay records every registered player's level at the end of that round. The API reports what those replays showed, and when. Read data and privacy before you show the numbers to anyone, especially the part about what "last seen" means.
Get started
- Get a key in the developer portal.
- Make your first request.
- If you're building a leaderboard, follow sync a leaderboard.