LoginSign Up
PlatformMCPAPI
Listeners

Get a listener

Get a single listener by its id (lis_...).

Read-only — this endpoint does not consume credits.

GET
/listeners/{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

Listener id (lis_...).

Response Body

application/json

application/json

application/json

application/json

application/json

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

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.

List feeds GET

List saved feeds (filtered views) for this organization. Listener scope (`includeListeners`/`excludeListeners`) is not yet included in this response — tracked as a follow-up now that listeners have a public id. **Read-only** — this endpoint does not consume credits.