Build on Karmanet
A small, focused public API: see who liked your Discord server and when, so you can reward them — nothing more.
One endpoint: the like events on a single Discord server, for the server's own owner. There is no way to list dislikes, no way to list votes on a user, and no way to see likes on a server you do not own — the key itself is scoped to exactly one server.
Generate a key from your server's own page on Karmanet (visible only to the server owner, next to the reviews). Send it as a bearer token on every request. Keys are shown once, at creation or rotation — store it somewhere safe. Rotating replaces the key immediately; the old one stops working.
Authorization: Bearer kn_srv_xxxxxxxxxxxxxxxxxxxxxxxx
Returns like events for the server your key belongs to, newest first.
GET https://karmanet.app/api/public/v1/likes?limit=50&cursor=<opaque>
Query parameters:
- limit — page size, 1 to 100, defaults to 50.
- cursor — opaque pagination token from a previous response's nextCursor.
Response:
{
"items": [
{
"userId": "123456789012345678",
"username": "alice",
"avatarUrl": "https://cdn.discordapp.com/avatars/123.../abc.png",
"likedAt": "2026-09-14T12:34:56.000Z"
}
],
"nextCursor": "eyJhbGciOiJub25lIn0"
}
When nextCursor is not null, pass it back as the cursor query parameter to fetch the next page. A giveaway tool can also just poll with no cursor periodically and stop once it reaches likes it has already seen.
- Each key may make up to 120 requests per minute — plenty for polling every few seconds.
- Each caller IP is limited to 60 requests per minute, key valid or not.
- A rate-limited request answers 429 with a Retry-After header, in seconds.
This API deliberately shows less than what you can already see as a Discord server owner — every member is already visible to you in Discord itself.
- Only likes on the server the key belongs to — never dislikes, and never votes on users.
- Only the Discord user ID, current display name and avatar, and when the like happened.
- No IP addresses, no email addresses, and nothing about likes rolled back by anti-raid protection.
- Revoke the key at any time from your server's page; it stops working immediately.