Read public InnoBee data — challenges, submissions, profiles, and the leaderboard — from your own scripts or services.
Create a key from Account Settings → Login (you'll need to be signed in) — turn on Developer Options there to reveal the API Keys section. Send the key as a bearer token on every request:
Authorization: Bearer ib_live_...
The full key is only ever shown once, right after you create it — store it somewhere safe. You can create up to 10 keys and revoke any of them individually at any time.
Each key is limited to 60 requests per minute. Going over returns a 429 with a RATE_LIMITED error code — back off and retry after a moment.
Every endpoint returns { data, meta? } on success, or { error: { code, message } } on failure — the same envelope used across every InnoBee API route. List endpoints include a meta object with total, page, limit, , and hasMore.
/api/v1/challenges?status=open&category=ai&page=1&limit=20List public challenges — non-draft, non-cancelled, not private or hidden.
curl https://innobee.buzz/api/v1/challenges \ -H "Authorization: Bearer ib_live_..."
/api/v1/challenges/{slug}Get a single public challenge by its slug, including a curated creator profile.
curl https://innobee.buzz/api/v1/challenges/build-a-bot \ -H "Authorization: Bearer ib_live_..."
/api/v1/challenges/{slug}/submissions?page=1&limit=20List a challenge's public submissions (the creator has marked them visible and they aren't hidden or draft).
curl https://innobee.buzz/api/v1/challenges/build-a-bot/submissions \ -H "Authorization: Bearer ib_live_..."
/api/v1/profiles/{username}Get a public profile's curated fields (no email, billing, or account-internal data).
curl https://innobee.buzz/api/v1/profiles/ada \ -H "Authorization: Bearer ib_live_..."
/api/v1/leaderboard?period=allGet the Hive Score leaderboard — all-time, weekly, or learning.
curl "https://innobee.buzz/api/v1/leaderboard?period=weekly" \ -H "Authorization: Bearer ib_live_..."
A machine-readable OpenAPI 3.0 spec covering every endpoint above is available at /openapi/v1.json.