Get billing usage
Returns credits consumed in the current billing period, the total credit limit, and when the period resets.
Read-only — this endpoint does not consume credits.
See metered prices for current per-search rates.
Authorization
bearerAuth Organization API key (sf_api_… from Integrations → API keys) or a partner OAuth 2.1 access token issued by SnitchFeed (authorization_code + refresh). OAuth tokens must be audience-bound to this API (resource = {apiOrigin}/v1) and carry the route scopes listed per operation.
In: header
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/organization/usage"{ "requestId": "string", "creditsUsedThisPeriod": 0, "creditsLimit": 0, "billingPeriodEndsAt": "string"}Get organization context GET
Brand/business context for the organization this API key belongs to — the same information shown on the dashboard's Brand Context page (product summary, positioning, ideal customer profiles, target audiences, use cases, case studies). There is no organization id in this or any v1 response — the organization is already implicit in the API key. **Read-only** — this endpoint does not consume credits.
New mention Webhook
SnitchFeed POSTs this payload to your HTTPS endpoint when a mention is delivered via webhook. Configure your endpoint URL in the platform under **Integrations → Webhooks**. - `event.type` is `mention.created` for automatic feed routing, or `mention.resent` for on-demand sends from the app. (Renamed from `match.created`/`match.resent`.) - Return any `2xx` status to acknowledge delivery. The response body is ignored. - Failed deliveries are retried with exponential backoff.