Changelog
Tracks all significant changes to the Lurkr API. We maintain backward compatibility within each major version, so you can expect no breaking changes in v2.
Get Role Rewards Changes for a Specific Level
Date: 2025-10-13
The global rate limit has been raised from 60 to 1500 requests per minute.
Added a new endpoint to fetch the changes in Role Reward roles for a specific level and user:
Leveling System Settings on Leaderboard endpoint
Date: 2025-07-18
We've added the newly introduced leveling system settings to the
GET /levels/{guildId} endpoint. These settings are:
xpGainInterval- The interval in seconds at which users gain experience.xpPerMessageMax- The maximum experience a user can gain per message.xpPerMessageMin- The minimum experience a user can gain per message.
Public leaderboard endpoint
Date: 2025-05-04
We're making public an endpoint for retrieving the leaderboard of a server. This endpoint is available to all users, and it does not require authentication:
GET /levels/{guildId}?page=1- Get the leaderboard for a server.
Additionally, we've removed the user.locale property from the body of the
POST /levels/{guildId}/users/{userId} endpoint, and strictened the user.avatar
schema, to ensure only a valid Discord avatar hash can be passed.
Initial release
Date: 2025-04-27
Introducing the public Lurkr API. Starting with version 2.
Public endpoints included with this release:
GET /levels/{guildId}/users/{userId}- Get a user's experience on a server.POST /levels/{guildId}/users/{userId}- Create a new leveling entry for a user on a server.PATCH /levels/{guildId}/users/{userId}- Update a user's experience on a server.DELETE /levels/{guildId}/users/{userId}- Delete a user's level entry on a server.