Skip to content
Lurkers
Sign inJoin free

Build on Lurkers

A free, read-only JSON API for community bots, Discord tools, and stream overlays. No key needed. Everything it returns is already public on the site - the same privacy rules apply (creator opt-outs, leaderboard visibility settings).

Endpoints

GET /api/v1/events

Live and standing events currently on the site.

Fields: slug, title, url, watchUrl, status, format, game, community, openCalls, totalPicks, heatScore, nextCloseAt

GET /api/v1/communities

Approved communities.

Fields: name, slug, url, type, game, description

GET /api/v1/leaderboard

The all-time public leaderboard.

Fields: rank, username, url, points, totalPicks, wonPicks, accuracy

curl https://lurkers.gg/api/v1/events
# -> { "data": [ { "slug": "...", "title": "...", "openCalls": 3, ... } ],
#      "meta": { "count": 12, "docs": "https://lurkers.gg/developers" } }

House rules

  • Read-only, GET only. Responses are cached for about a minute - polling faster than that gets you the same data.
  • Credit the source: link to the event or community page you got the data from, or say "powered by Lurkers".
  • Lurkers is free to play. Do not present this data with gambling framing - picks are free points, never money.
  • The v1 shapes may gain fields but existing fields will not change meaning. Breaking changes get a new version path.

Building something? We would love to see it - tell us about it.