Skip to content
AdlyseDocs
Product guideMCP reference
⌘K
Open Adlyse
⌘K
Overview
QuickstartAuthentication
adlyse-insights
list_ad_accountsget_dashboard_snapshotget_impact_analysisget_competitor_pressurelist_guidelinesget_brand_kitupdate_brand_kitimport_brand_kit_from_websitesave_brand_assetget_guidelinelist_suggestionsget_suggestionget_strategy_sessionlist_strategy_claimslist_strategy_proposalsget_creative_insightslist_watched_competitorslist_competitor_adswatch_competitorunwatch_competitorlist_audit_eventsga4_list_propertiesga4_run_reportlist_organic_propertiesget_organic_overviewget_organic_page_metricsinspect_pageget_organic_performanceget_site_inventorycheck_site_healthget_ai_visibilitylist_ai_visibility_answersget_cited_pageslist_ai_visibility_promptsupsert_ai_visibility_promptsrun_ai_visibility_checksget_growth_evidencelist_site_connection_optionslist_site_key_eventssave_site_sourceremove_site_sourceresync_site_sourceupdate_growth_deliveryget_growth_deliveryget_geo_workspaceupdate_geo_workspacelist_competitorsupdate_competitorscombine_competitor_listsget_search_workspaceupdate_search_monitoringplan_topic_workreview_search_findingget_keyword_researchstart_keyword_researchadd_keyword_research_terms
adlyse-ads
adlyse-workflows
adlyse-admin
adlyse-all
  1. Overview
  2. adlyse-insights

add_keyword_research_terms

Add selected terms from a completed saved search to one topic. Read get_keyword_research for run_id and exact terms, and get_search_workspace section monitoring for revision and topic ids. Give topic_id, or new_topic_name to create a topic. Terms must come from the monitored country and language. When the topic is active and the monitoring section’s tracking_active is true, the terms are tracked at once: each new term costs weekly_term_usd per week, so confirm the added cost with the user first. A draft topic only saves them until it is published; a new topic is active when the website already tracks topics. Deduplicates; 100-term cap. Stale revisions fail; reread before retry. Returns revision, active_revision, topic_status, term_count (tracked searches) and tracking_active (true: these terms are bought from this week).

Parameters#

NameTypeRequiredDefaultDescription
site_source_idstringyes
run_idstringyes
termsarrayyes
revisionintegeryes
topic_idstringno
new_topic_namestringno

Generated by generate_mcp_docs from the server tool. Add to this page below this block; the block is rewritten on every run.

Previousstart_keyword_researchNextadlyse-ads