Authentication

How to authenticate with the SnitchFeed API.

Every request must include your API key in the Authorization header:

Authorization: Bearer <your-api-key>

Keys are issued with the sf_api_ prefix. Requests without a valid Bearer token receive 401 with an error envelope.

Example

curl -sS -X POST "https://api.snitchfeed.com/v1/data/twitter/searchTweets" \
  -H "Authorization: Bearer sf_api_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"query":"example"}'

Creating an API key

Open Integrations → API in your SnitchFeed workspace (app).
Create a key and copy it immediately — the full secret is only shown once.

Access to the HTTP API requires a plan that includes API access. If your organization is not eligible, key creation and requests will be rejected.

Security

Store keys in environment variables or a secrets manager, not in source control.
Rotate keys from the same page if they are exposed or no longer needed.
Keys are scoped to a single workspace, not shared across workspaces.

Introduction

Overview of the SnitchFeed HTTP API.

Rate limits

Request limits for the SnitchFeed HTTP API.

On this page

Example Creating an API key Security