SendItInstall

Summary

Retrieve a list of social media mentions filtered by optional criteria such as sentiment, platform, keyword ID, read/archived status, time range, and pagination parameters.

Inputs

• Team ID — Optional team scope; sent as X-Team-ID header when provided to scope the request.
• Idempotency Key — Optional idempotency key; sent as Idempotency-Key header for idempotent requests.
• Sentiment Filter — Filter mentions by sentiment: any, negative, neutral, or positive.
• Listening Limit — Maximum number of mentions to return (default is 50).
• Listening Offset — Result offset for pagination (default is 0).
• Mention Platform — Filter mentions by specific platform (e.g., X/Twitter, LinkedIn, Facebook, etc.).
• Mention Keyword ID — Filter mentions by the associated keyword ID.
• Mentions Is Read — Filter mentions by read state: any, read, or unread.
• Mentions Is Archived — Filter mentions by archived state: active, archived, or any.
• Mentions Since — Only include mentions since this timestamp.

Output shape

a list of mention records matching the applied filters

Supports pagination via limit and offset parameters; returns mentions scoped to optional team ID; filters applied via query parameters and headers; no mention of error envelope format provided.

Examples

Example 1: Retrieve the latest 50 positive mentions on Twitter relevant to a specific keyword ID, excluding archived and only unread mentions.

Set 'Listening Limit' to 50; 'Sentiment Filter' to 'Positive'; 'Mention Platform' to 'X (Twitter)'; specify 'Mention Keyword ID'; set 'Mentions Is Archived' to 'Active'; set 'Mentions Is Read' to 'Unread'.

Links

• n8n community nodes installation guide