Create a listening search
create_saved_searchWatch for mentions of the brand (or a competitor, or a topic) on X or in the NEWS (press and blogs via Google News; the brand's own website is left out). Reddit is paused while Reddit's API is closed to third-party apps. X is checked every 6 hours and news once a day; neither needs a connected account. On X the query is passed through untouched, so X operators work ("exact phrase", OR, -is:retweet, lang:es) and only posts that contain the words are kept. Instagram, TikTok and YouTube are not watched. With kind "opportunity" (X) it looks for people asking for what the business sells and Sparky drafts a reply for the user to approve; nothing is posted on its own. Inferno plan only.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | "mention" (default): mentions of the brand, a competitor or a topic. "opportunity" (X only): search a TOPIC the way someone looking for help would write it; for each post the AI decides whether the author is asking for something this business offers and, if so, Sparky drafts a helpful public reply that discloses the brand. Nothing is ever posted on its own: the user approves each reply (reply_to_mention with the draft). | |
| name | No | Optional label for the search. | |
| query | Yes | What to watch for. On X, X search operators work ("exact phrase", OR, -is:retweet, lang:es). | |
| platform | Yes | Where to watch: twitter (X) or news. | |
| workspaceId | No | Workspace to work on (an id from list_workspaces). Not needed when this connection is tied to one workspace, or when you pass an account: the account's workspace is used. | |
| idempotencyKey | No | Optional. A unique id for this action (16-128 chars: letters, digits, _ : . -). If you are unsure whether a call went through (timeout, network error), repeat it with the SAME idempotencyKey and the same arguments: you get the original result and nothing is done twice. |