Mentions

Count mentions

Count mentions matching the given filters, without fetching or paginating them. Accepts the same filters as GET /mentions (excluding cursor, limit, and sort, which only affect pagination order).

Read-only — this endpoint does not consume credits.


GET
/mentions/count

Authorization

bearerAuth
AuthorizationBearer <token>

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

Query Parameters

platform?string

Comma-separated platforms to include: any of reddit, twitter, bluesky, linkedin, hackernews.

sentiment?string

Comma-separated sentiments to include: any of positive, negative, neutral.

status?string

Defaults to ready (unarchived) mentions.

Value in

  • "ready"
  • "archived"
fitScore?string

Comma-separated AI fit score buckets to include: any of high, medium, low. Unset means all buckets (including unscored mentions).

listenerIds?string

Comma-separated listener ids (lis_...) to filter to (a single id works too). Ids from another organization or that don't exist are dropped; if none of the given ids resolve, the result is empty rather than unfiltered.

excludeListenerIds?string

Comma-separated listener ids (lis_...) to exclude. Ids that don't resolve are ignored.

includeIntents?string

Comma-separated AI intent tag slugs — only mentions with at least one of these tags. One or more of buying_intent, recommendation_request, comparison, seeking_alternative, content_opportunity, pain_point, competitor_complaint, competitor_mention, feature_request, praise, hiring, brand_mention, promotional.

excludeIntents?string

Comma-separated AI intent tag slugs — excludes mentions with any of these tags. Same slugs as includeIntents.

includeKeywords?string

Comma-separated keywords — only mentions matched by at least one of these keywords.

excludeKeywords?string

Comma-separated keywords — excludes mentions matched by any of these keywords.

languages?string

Comma-separated ISO 639-1 language codes to include (e.g. en,fr) — matches ai.language on the mention.

dateFrom?string

ISO 8601 instant. Only mentions published at or after this time (filters on datePublished, the same column this endpoint sorts by).

dateTo?string

ISO 8601 instant. Only mentions published at or before this time (filters on datePublished, the same column this endpoint sorts by).

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/mentions/count"
{  "requestId": "string",  "count": 0}

List mentions GET

List mentions (brand mentions your listeners matched), cursor-paginated. `sort` is `newest` (default, by `datePublished` descending) or `fitScore` (by AI fit score descending, unscored mentions last). **Cursor pagination only** — mentions insert continuously, so this endpoint does not support offset/page pagination. Pass `meta.nextCursor` from a response as `cursor` on the next request. When `meta.hasMore` is `false`, there is nothing more to fetch. A cursor is only valid for the `sort` it was minted under; reusing it with a different value returns a validation error. Because `newest` sorts by publish date, a mention backfilled or found via a delayed crawl can carry an older `datePublished` than mentions you've already paginated past, and will not appear in a subsequent page. `sort=fitScore` has a similar but more general risk: AI fit score can be overwritten by reanalysis after insert, so a mention re-scored while you're mid-pagination can occasionally be skipped or duplicated across pages. Prefer `sort=newest` if you need a gap-free stream. `status` defaults to `ready` (unarchived). Note that `status` and AI analysis (`ai.*`, including `fitScore`) are point-in-time, not live: a mention synced before it was archived or re-scored will not reflect the change unless you re-fetch it. `platform`, `sentiment`, `fitScore`, `languages`, `includeIntents`/`excludeIntents`, `listenerIds`/`excludeListenerIds`, and `includeKeywords`/`excludeKeywords` all take comma-separated values. `dateFrom`/`dateTo` filter on `datePublished` (note: independent of `sort`). **Read-only** — this endpoint does not consume credits.

Get a mention GET

Get a single mention by its public id (`men_...`). **Read-only** — this endpoint does not consume credits.