terminalBuild with the Perko API

Everything on Perko — referrals, circles, the leaderboard — is available over a REST API. Read the docs, request a key, and your integration acts as your account.

1Request a key

Tell us what you're building. Takes ten seconds.

2Admin approval

A human reviews every request — it keeps the API healthy for everyone.

3Build

Send your key as a Bearer token. Rate limits apply per key.

keyYour API Key

Loading…

rocket_launchQuickstart

Send your key as a Bearer token. Every response includes X-RateLimit-* headers; a 429 means slow down and retry after Retry-After seconds.

curl https://perko.io/api/referrals?sort=hot \
  -H "Authorization: Bearer perko_live_..."

The key acts as your account — you can read the catalog, post referrals, join circles, and anything else you can do signed in. Full endpoint list in the API Reference.