Authentication

How to authenticate with the SnitchFeed API.

The SnitchFeed API uses Bearer token authentication. Pass your API key in the Authorization header on every request.

curl https://api.snitchfeed.com/v1/listeners \
  -H "Authorization: Bearer sf_live_xxxxxxxxxxxx"

Generating an API key

  1. Go to Settings → API Keys in your workspace.
  2. Click New API Key, give it a name, and select the scopes you need.
  3. Copy the key — it is only shown once.

Key scopes

ScopeDescription
listeners:readRead listener configuration
feed:readRead feed items
analytics:readAccess analytics and trend data
workspace:readRead workspace and member data

Security

  • Store keys in environment variables, never in source code.
  • Rotate keys immediately if compromised from the API Keys settings page.
  • Keys are workspace-scoped — a key from one workspace cannot access another.

On this page