Getting started

In a few minutes you’ll fetch your first debates. All you need is an API key.

# 1 — does my key work?
curl https://api.debaty.com/v1/me \
  -H "Authorization: Bearer dbty_live_sk_JOUW_SLEUTEL"

# 2 — read the public timeline (scope: posts:read)
curl "https://api.debaty.com/v1/timelines/public?limit=20" \
  -H "Authorization: Bearer dbty_live_sk_JOUW_SLEUTEL"

# → { "items": [ … ], "nextCursor": "…" }
#   Volgende pagina: geef nextCursor terug als ?cursor=…
#   nextCursor: null betekent: dit was de laatste pagina.

1. 1

   Create an app

   Go to My apps and create a test app. You get a key right away.

2. 2

   Store your key

   Put the key in an environment variable, never in your source code.

3. 3

   Make your first request

   Send the request above. The first call confirms your key works, the second returns the public timeline. Every endpoint lists its own scope in the reference — ask for something outside your scopes and you get a 403.

4. 4

   Go further

   Browse the reference for every endpoint, or set up webhooks for updates.