Back to Home
KARMANET
Public API

Build on Karmanet

A small, focused public API: see who liked your Discord server and when, so you can reward them — nothing more.

What this API does

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.

Authentication

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

Endpoint

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.

Rate limits

  • 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.

Privacy and scope

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.
Questions? Contact us: [email protected] or DiscordBack to Home