Skip to content

Topics & Search Watches

Inspect a campaign’s topics and the workspace’s active LinkedIn search watches, and create new manual search watches that source leads.

Full name: campaignstack_list_search_topics

campaigns:read Read-only Idempotent

List all active LinkedIn search-watch topics across campaigns in a workspace. Returns each enabled topic search automation with the topic ID and the campaign it belongs to. Call this when the user asks what topics are already being watched workspace-wide, or before creating a new search watch, since only one watch per topic can be active at a time. To get topics assigned to a specific campaign, use campaignstack_get_campaign_topics.

NameTypeRequiredDefaultDescription
workspaceIdstringNoWorkspace ID. REQUIRED for a user key (csu_), which spans every workspace you belong to; omitted for a workspace key (cs_), which is bound to one and ignores this argument. campaignstack_whoami reports which kind of key you are holding and, for a user key, the workspaces it can reach.

Full name: campaignstack_get_campaign_topics

campaigns:read Read-only Idempotent

Get all topics assigned to a campaign along with their weight (0 to 1). Topics with weight > 0.8 have active LinkedIn search watch automations. Returns topic metadata (id, name, displayName, category) and weight for each entry. Call this when the user asks what topics a specific campaign is scored or watched on. If the campaign is not found, use campaignstack_list_campaigns to find valid campaign IDs.

NameTypeRequiredDefaultDescription
campaignIdstringYes(min length: 1)

Full name: campaignstack_create_search_watch

campaigns:write

Set up a LinkedIn search watch that automatically discovers new leads for a campaign. A search watch monitors a topic keyword on LinkedIn content search (past 24h, relevance-sorted) every ~6 hours, reading post authors and feeding them into the campaign as new leads. Call this when the user asks to start monitoring a topic on LinkedIn for a campaign. Only one search watch per topic is active across all campaigns in a workspace at a time. If another campaign already watches this topic, the new watch is created but starts disabled (ownership transfers automatically when the other campaign is archived). Use campaignstack_list_search_topics to see what topics are already watched, and campaignstack_get_campaign_topics to see topics already on the target campaign.

NameTypeRequiredDefaultDescription
campaignIdstringYes(min length: 1)
topicIdstringYesID of the topic to watch. Use campaignstack_get_campaign_topics to see topics already on a campaign, or list taxonomy topics via campaignstack_list_search_topics. (min length: 1)
accountIdsstring[]NoOptional list of LinkedIn account IDs to scope the search watch to. When omitted, the watch runs on any available account.