mention_add_shopping_query
ChatGPTAdd or reactivate a shopping query for an owned ecommerce brand and start an external shopping search. Requires sufficient Mention credits; an existing matching query is enabled again and its run status is reset.
mention_create_prompts
ChatGPTCreate between one and fifty tracked prompts for a brand owned by the connected Mention account. New prompts are enabled; existing prompts are not changed.
mention_create_url_watch
ChatGPTCreate an active monitor for an external URL under an owned brand. Requires an active Mention subscription and schedules external URL retrievals at the supplied frequency under Mention's credit rules.
mention_get_billing_status
ChatGPTGet the authenticated user's plan, subscription status, and remaining feature credits.
mention_get_brand
ChatGPTGet one brand owned by the authenticated Mention user.
mention_get_citation_report
ChatGPTGet citation share, top citing domains, and top citing pages for a brand.
mention_get_consensus_run
ChatGPTRead one stored consensus run, its responses and citations from the connected account. Use an existing runId; this does not start an analysis or contact AI platforms.
mention_get_keyword_gap
ChatGPTRead the stored keyword-gap snapshot comparing an owned brand with the supplied competitor domain. This queries the connected Mention account's cache without contacting DataForSEO or starting research.
mention_get_platform_matrix
ChatGPTCompare a visibility metric across AI platforms.
mention_get_question_research
ChatGPTRead one stored AnswerThePublic question research result belonging to an owned brand. Requires an existing answerId; no new research is started.
mention_get_sentiment
ChatGPTGet stored sentiment insights for a selected brand.
mention_get_shopping_results
ChatGPTRead stored shopping results for an existing query owned by the connected account. Requires an ecommerce brand and its queryId. Omit runDate for the most recent stored results; no search is started.
mention_get_url_watch
ChatGPTRead the stored settings of one URL watch owned by the connected account. This does not fetch its URL or change monitoring.
mention_get_visibility_snapshot
ChatGPTGet visibility score, share of voice, and average position for a selected brand.
mention_get_visibility_trend
ChatGPTGet the selected brand's visibility trend over time.
mention_list_brands
ChatGPTList the authenticated user's Mention brands. Use this before calling a brand-scoped tool.
mention_list_consensus_runs
ChatGPTList stored consensus runs for a brand owned by the connected account. This only reads Mention data and does not contact AI platforms or start a run.
mention_list_domain_overviews
ChatGPTList stored domain overview analyses for an owned brand. This reads cached Mention data without contacting DataForSEO or starting an analysis.
mention_list_opportunities
ChatGPTList or retrieve GEO opportunities for a selected brand.
mention_list_prompt_executions
ChatGPTList stored AI prompt executions for a selected brand.
mention_list_prompts
ChatGPTList prompts and prompt distribution data for a selected brand.
mention_list_question_research
ChatGPTList stored AnswerThePublic question research for an owned brand. This reads cached Mention data without contacting a research provider or consuming analysis credits.
mention_list_shopping_queries
ChatGPTList stored shopping queries for an ecommerce brand owned by the connected account. This does not run a shopping search.
mention_list_shopping_run_dates
ChatGPTList dates with stored shopping results for an existing query owned by the connected account. Requires an ecommerce brand and its queryId; no search is started.
mention_list_url_watch_changes
ChatGPTList changes previously detected for one URL watch owned by the connected account. This reads stored Mention records without fetching the external URL.
mention_list_url_watch_runs
ChatGPTList stored monitoring runs for one URL watch owned by the connected account. This does not fetch its URL or start a new check.
mention_list_url_watches
ChatGPTList stored URL monitoring watches for a brand owned by the connected account. This reads Mention records without fetching monitored URLs or changing monitoring.
mention_run_domain_overview
ChatGPTRun a credit-consuming DataForSEO domain overview for an owned brand and the supplied domain. Uses the brand's stored country and language, contacts DataForSEO, and replaces the corresponding cached overview in Mention.
mention_run_keyword_gap
ChatGPTRequest a credit-consuming DataForSEO keyword-gap comparison for an owned brand and the supplied competitor domain. A recent snapshot may be reused; otherwise the external provider is queried and the matching cached snapshot is replaced in Mention.
mention_set_prompt_enabled
ChatGPTEnable or disable one tracked prompt owned by the connected account. Disabling stops tracking; the prompt and stored results remain in Mention.
mention_start_consensus
ChatGPTStart a credit-consuming consensus run for a selected brand. Send the supplied prompt to the selected external AI platforms and store the results in Mention.
mention_start_question_research
ChatGPTRequest AnswerThePublic question research for an owned brand using the supplied keyword, language and location. Requires sufficient Mention credits and can queue an external provider request; a recent completed result may be reused.
mention_update_brand
ChatGPTUpdate profile fields of a brand owned by the authenticated user. Supplied fields replace their existing values.
mention_update_opportunity
ChatGPTUpdate the workflow status of a GEO opportunity.
mention_update_prompt
ChatGPTReplace the text, type and intent of one tracked prompt owned by the connected account. Supply all three fields and its existing promptId.
mention_update_url_watch
ChatGPTReplace the frequency or active/paused status of one URL watch owned by the connected account. Provide at least one changed setting. Pausing stops monitoring; active watches retrieve their external URL under Mention's credit rules. The URL itself is not changed.