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. Use this to see which topics are already being monitored before creating a new search watch. To get topics assigned to a specific campaign, use campaignstack_get_campaign_topics.

NameTypeRequiredDefaultDescription
workspaceIdstringNoDefaults to the API key’s workspace

Full name: campaignstack_get_campaign_topics

campaigns:read Read-only Idempotent

Get all topics assigned to a campaign along with their weight (0–1). Topics with weight > 0.8 have active LinkedIn search watch automations. Returns topic metadata (id, name, displayName, category) and weight for each entry. 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, extracting post authors and feeding them into the campaign as new leads. 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.