BalkTalk

For developers

Getting started

Build an app or a game connected to BalkTalk: members sign in with their BalkTalk account, and through the public API you get only what they allow.

What you get

  • Sign in with BalkTalk. A member does not create a new account and never gives you a password. On the consent screen they see exactly what you ask for.
  • A public API at https://www.balktalk.net/api/dev/v1: who is signed in, public profiles, your app leaderboards and the “is playing …” indicator in chats.
  • The app catalog. A public app opens in a frame on BalkTalk, with no second sign-in.

Who can create apps

  • The account is older than 30 days.
  • The e-mail address is confirmed.
  • Two-step sign-in is on (Settings → Security and access).
  • You can have at most 5 apps.

Your first app in five steps

  1. Open the portal and create an app. Choose whether it has its own server. With a server you get a client secret; without one (an app that runs only in the browser or on a phone) you use PKCE.
  2. Enter a redirect address, for example https://your-site.example/callback. While developing, http://localhost:5173/callback works too.
  3. Send the member to the consent screen. How to build the address is on the Sign in with BalkTalk page.
  4. When the member returns to your redirect address, exchange the code for a token.
  5. Call the API:
curl https://www.balktalk.net/api/dev/v1/me \
  -H "Authorization: Bearer YOUR_TOKEN"
{
  "data": {
    "id": 48213,
    "username": "ana",
    "display_name": "Ana",
    "avatar_url": "https://load.balktalk.net/media/…/avatar.webp",
    "verified": true,
    "profile_url": "https://www.balktalk.net/u/ana"
  }
}

App states

State Who can grant access Limit
In development you and up to 25 testers 120 requests per minute
In review same as in development same as in development
Public every member 1.200 requests per minute
Suspended nobody, all tokens stop working –

You send an app for review from the portal. Review needs a short description, a description, an icon, the address of your privacy policy and at least one address that is not a development address. The administrators approve it or return it with a reason.

When a public app asks for new scopes or a different frame address, that change waits for a new review. Until the decision the app keeps working with the old values.

What is not available

The public API never gives private messages, e-mail addresses, location, data from Upoznaj, verification, or anything from moderation and administration. An app cannot post in a member's name. Ducats are not used in third-party apps.

Rules

Read the Developer terms before you publish (the link is in the documentation menu). In short: take only the data you need, do not scrape, delete a member's data when they remove your access, and do not present yourself as BalkTalk.

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