BalkTalk

For developers

Limits and errors

How many calls you may make, what you get when you go over a limit, and the shape errors arrive in.

Limits

The numbers below are the ones in force on this site right now.

What is counted Limit
All calls of an app in development or in review 120 per minute
All calls of a public app 1.200 per minute
Calls on behalf of one member 60 per minute
Writes on behalf of one member (scores, activity) 10 per minute
Token requests (code, refresh) 30 per minute

Also: at most 5 apps per developer, 25 testers and 5 leaderboards per app.

Headers

Every response carries X-RateLimit-Limit and X-RateLimit-Remaining. When you go over a limit you get 429 and a Retry-After header with the number of seconds:

{
  "error": "rate_limited",
  "message": "Too many requests. Try again in 21 s.",
  "retry_after": 21
}

Wait retry_after seconds before the next call. Do not retry at once.

Automatic suspension

An app that keeps going over its limit is suspended automatically and you get a notification with the reason. No token works for a suspended app. When you have fixed the cause, contact the administrators to lift the suspension.

Error shape

All errors of the public API have the same shape:

{ "error": "error_code", "message": "Text for the developer" }

In code, compare the error field. The text in message may change.

HTTP error Meaning
401 invalid_token the token is missing, expired, or access was removed
403 insufficient_scope the token lacks the scope for this call (the name is in the scope field)
403 forbidden the action is not allowed
404 not_found it does not exist, or the signed-in member may not see it
422 validation_failed invalid data, per-field errors are in errors
429 rate_limited too many requests, see retry_after
500 server_error an error on our side, try later

A validation error example:

{
  "error": "validation_failed",
  "message": "The score field must be an integer.",
  "errors": { "score": ["The score field must be an integer."] }
}

Response shape

  • A successful response carries its data in the data field.
  • Dates are ISO 8601 with a time zone, for example 2026-11-15T19:42:07+00:00.
  • A field the member does not show on their profile is null.
  • New fields may be added without notice. We do not change or remove existing fields without a new API version.

Strictly necessary cookies keep the site running. With your consent we also use optional ones (e.g. analytics) - you can change your choice at any time. Cookie Policy

Strictly necessary cookies keep the site running. With your consent we also use optional ones (e.g. analytics) - you can change your choice at any time. Cookie Policy

Strictly necessary

Always active

The site cannot work without them: sign-in, security, language and your choices. No consent needed and never used for tracking.

  • bt_session cookie · 30 days

    Session: keeps you signed in while you use the site.

    BalkTalk

  • XSRF-TOKEN cookie · 30 days

    Protects forms against forged requests (CSRF).

    BalkTalk

  • remember_web_* cookie · 13 months

    "Remember me": keeps you signed in after closing the browser.

    BalkTalk

  • bt_locale cookie · 12 months

    The language you chose.

    BalkTalk

  • bt_2fa_device cookie · 30 days

    Two-step sign-in: this device does not ask for a code for 30 days (when you choose "Remember this device").

    BalkTalk

  • bt_consent cookie · 12 months

    Your cookie choice (so we do not ask again).

    BalkTalk

  • bt-*, bt:* localStorage · until you clear it

    Browser local storage: theme, language, radio station, recent emoji, chat layout, hidden hints.

    BalkTalk

  • bt_invite cookie · 30 days

    Who invited you to BalkTalk (invite link) – so you both get a reward once you become an active member.

    BalkTalk

  • Cloudflare Turnstile service

    Human check on sign-up (challenges.cloudflare.com) - protects the site from fake accounts.

    Cloudflare, Inc. · Privacy policy

Third-party content

When you open it

Videos, music, GIFs, radio and the map come from other companies' servers. When you open them, those servers see your IP address and may set their own cookies.

  • Google Identity Services service

    One-click sign-in with the Google account you use in the browser ("Continue as …", accounts.google.com). Google sees that you visited the site; we get your name and email only when you click "Continue". Google may set the g_state cookie to remember that you closed the prompt.

    Google Ireland Ltd. · Privacy policy

  • YouTube service

    Videos in the blog and chat (youtube-nocookie.com).

    Google Ireland Ltd. · Privacy policy

  • Deezer service

    Song previews and covers on profiles, the Network and in chat.

    Deezer S.A. · Privacy policy

  • KLIPY service

    GIFs in chat and comments.

    KLIPY Inc. · Privacy policy

  • Radio stations service

    Live stream when you start the radio.

    The selected station's server

  • OpenStreetMap service

    Map in the Nearby module (only with separate map consent).

    OpenStreetMap Foundation · Privacy policy

  • OneSignal service

    Push notifications on this device – loaded only after you turn them on in Settings.

    OneSignal, Inc. · Privacy policy

Analytics

Anonymous visit statistics that help us improve the site. Only with your consent.

  • Google Analytics service

    Visit statistics (which pages are opened, where visitors come from, device) - no ads. Loaded only with your consent.

    Google Ireland Ltd. · Privacy policy

  • _ga cookie · 24 months

    Google Analytics: tells visitors apart (random number, no name or email).

    Google Ireland Ltd. · Privacy policy

  • _ga_0QPMP1EXWV cookie · 24 months

    Google Analytics: remembers the current visit.

    Google Ireland Ltd. · Privacy policy