LoginSign Up
PlatformMCPAPI
Listeners

List listeners

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.

GET
/listeners

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

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/listeners"
{  "requestId": "string",  "listeners": [    {      "id": "string",      "name": "string",      "status": "active",      "color": "string",      "fitScoreThreshold": 0,      "intent": "string",      "negativeIntent": "string",      "createdAt": "string",      "updatedAt": "string"    }  ]}

Get a mention GET

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

Get a listener GET

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