API

SnitchFeed public HTTP API (v1)—production base URL, API keys, interactive docs, and rate limits.

The SnitchFeed public API is available at https://api.snitchfeed.com/v1. Use it to search public posts on X (Twitter) and LinkedIn from your own services or scripts.

Send your organization API key on every request:

Authorization: Bearer sf_api_<your_secret>

Create and revoke keys in the app under Integrations → API keys (your plan must include API access).

Documentation

  • Interactive reference (paths, schemas, descriptions): API in this docs site, starting with Introduction and Authentication.
  • OpenAPI 3.1 spec (for codegen, Postman, or CI): GET https://api.snitchfeed.com/v1/openapi.json

Rate limits

Search endpoints allow 20 requests per minute per organization per platform (Twitter and LinkedIn are counted separately). When you exceed the limit, the API returns 429 with a Retry-After header (and rate-limit metadata in X-RateLimit-* headers).

For new matches only (no on-demand search), Webhooks with match.created are usually simpler.

On this page