LoginSign Up
PlatformMCPAPI
Mentions

Get a mention

Get a single mention by its public id (men_...).

Read-only — this endpoint does not consume credits.

GET
/mentions/{id}

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

Path Parameters

id*string

Mention id (men_...).

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/mentions/string"
{  "requestId": "string",  "mention": {    "id": "string",    "listenerId": "string",    "platform": "reddit",    "keywords": [      "string"    ],    "status": "ready",    "datePublished": "string",    "dateFound": "string",    "content": {      "url": "string",      "text": "string",      "author": "string",      "authorUrl": "string",      "title": "string",      "subreddit": "string",      "engagement": {        "score": 0,        "comments": 0,        "shares": 0,        "retweets": 0      }    },    "ai": {      "sentiment": "positive",      "fitScore": 0,      "intentTags": [        "string"      ],      "summary": "string",      "language": "string"    },    "snitchfeedUrl": "string"  }}

Count mentions GET

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.

List listeners GET

List listeners (brand/keyword monitors) for this organization. Monitoring queries (keywords, platforms) and tracked authors are not included in this response. **Read-only** — this endpoint does not consume credits.