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

list_competitors

List the organization’s competitors: ONE list that SEO and AI Search both compare, shared by every website (edited in Competitors in SEO or AI Search settings, or with update_competitors).

PENDING FIRST: while pending is set, the websites it names still research and score their own competitor choices, so the list below (and research_usd, researched_sites, researched_in_seo) is NOT what they use yet, and update_competitors is refused. pending says who (sentence, websites) and what combining does (consequence, adds, listed_only, monthly_change_usd); combine with combine_competitor_lists when the user agrees.

Once combined (pending is null), a compared competitor (compared=true) is researched in Google once a month for each website with SEO tracking (research_usd each, researched_sites websites), names the competing page in SEO content gaps, and is scored in the AI answers of websites with AI Search on (ai_checked: whether any website has it on; with none, no AI answer scores it). A listed competitor (compared=false) is kept but not compared. At most limit (10) are compared at once; SEO researches at most that many per website, the oldest compared first.

Returns: competitors [{domain, name, aliases, exclusions, source, watching_ads, compared, researched_in_seo, compare_refused, caption}], compared first; suggestions [{domain, name}] (Brand Profile competitors not on the list); limit; cap_reason (at the cap: a competitor added now is listed, not compared; else null); seo_note (over the cap: why rows with researched_in_seo=false are not researched in SEO; their caption says whether AI Search still scores them; else null); research_usd; researched_sites; ai_checked; description, compare_effect, empty_sentence (the editor’s sentences); pending (see above). watching_ads is Brand Watch (list_watched_competitors), a separate, billed ad-library subscription.

Parameters#

None.

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

Previousupdate_geo_workspaceNextupdate_competitors