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

start_keyword_research

Request keyword suggestions for an explicitly reviewed seed and market, or (mode=“gap”) the keywords a competitor ranks for that this website does not. Read get_keyword_research first for supported country/language pairs and the competitors list. seed (keywords mode) is at most 80 characters; competitor (gap mode) is a domain such as rival.com, not this website. country and language are two-letter codes. gap_scope defaults to non_brand (excludes the competitor name); comparisons selects branded comparison/alternative wording, and brand selects other branded searches. Categories use name/word matching, not intent analysis; comparison wording is currently English-only. Each scope is a separate cached paid lookup. A new request records a $0.05 pending cost estimate, then settles the actual provider cost. Research has no monthly spending cap by default. The same mode and normalized seed or competitor, site, market and language is cached for the calendar month, including failed attempts; never replay an attempted paid request. Returns run metadata; poll get_keyword_research with its id as run_id for queued/running results (up to 100 suggestions plus seed, or up to 100 gap keywords with the competitor’s position). This does not activate monitoring or publish content.

Parameters#

NameTypeRequiredDefaultDescription
site_source_idstringyes
countrystringyes
languagestringyes
seedstringno""
modestringno"keywords"
competitorstringno""
gap_scopestringno"non_brand"

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

Previousget_keyword_researchNextadd_keyword_research_terms