Check how many times a domain is cited in AI-generated answers on a given AI platform (chat_gpt, google). Use this to answer 'is my brand/domain visible in AI search' or 'does ChatGPT know about us'.

Read-only: no side effects, safe to retry. Costs 10 quota units/call (free tier: 3 checks/month total across all tools).

Returns: {"domain", "platform", "mentions_found" (int - how many times the domain was cited in the provider's tracked answers for this platform), "visible" (bool - true if mentions_found > 0)}.

Use find_citation_leaders instead if you want a ranked list of who's winning for a topic rather than one domain's own count. Use analyze_citation_trend instead if you want to see this count change over time rather than right now.

Args: domain: bare domain to check, e.g. "example.com" (no https://, no www). platform: "chat_gpt" or "google" (Google's AI Overview). Defaults to chat_gpt. Perplexity and Gemini aren't available - the underlying data provider doesn't cover them for this check.

Find which domains dominate AI-answer citations for a topic/keyword, and optionally check whether a specific domain shows up among them. Use this to answer 'who's winning AI search for this topic' or 'is my competitor cited more than me for X'.

Read-only: no side effects, safe to retry. Costs 10 quota units/call (free tier: 3 checks/month total across all tools).

Returns: {"keyword", "platform", "top_domains" (list of {"domain", "mentions"}, most-cited domains for this keyword/platform, order as ranked by the provider), "compare_domain_present" (bool, only present when compare_domain was passed)}.

Use check_ai_visibility instead if you already know which domain you care about and just want its own citation count, not a leaderboard.

Args: keyword: the topic/query to check, e.g. "best project management tool". platform: "chat_gpt" or "google" (Google's AI Overview). Defaults to chat_gpt. Perplexity and Gemini aren't available - the underlying data provider doesn't cover them for this check. compare_domain: optional bare domain to flag if present in the results.

Track how a domain's AI-citation count has moved month over month, so you can see whether visibility is growing or fading instead of only ever checking a single point in time. Use this to answer 'is our AI visibility improving' or 'did that content push actually move the needle'.

Read-only: no side effects, safe to retry. Costs 1 quota unit/call (free tier: 3 checks/month total across all tools).

Returns: {"domain", "platform", "months" (list of {"year", "month", "mentions" (int, 0 for a month with no tracked citations - a real measured zero, not a gap), "ai_search_volume"}, oldest to newest), "trend": {"direction" ("up"/"down"/"flat"/"no_data"), "earliest_mentions", "latest_mentions"}}.

Use check_ai_visibility instead if you only need the current count, not how it's changed over time.

Args: domain: bare domain to check, e.g. "example.com" (no https://, no www). platform: "chat_gpt" or "google" (Google's AI Overview). Defaults to chat_gpt. Perplexity and Gemini aren't available - the underlying data provider doesn't cover them for this check. months: how many recent months of history to return. Defaults to 6, capped at 13 - DataForSEO's historical data only goes back to 2025-08-01.

Analyze the structural shape of the AI-generated answer actually cited for a keyword: does it lead with a list, how long is the opening passage, how many sources does it cite and from which domains. Use this to understand what a winning AI-search answer looks like for a topic, e.g. before writing content meant to get cited.

Read-only: no side effects, safe to retry. Costs 1 quota unit/call (free tier: 3 checks/month total across all tools).

Returns: {"keyword", "leads_with_list" (bool), "opening_word_count" (int), "opening_has_number" (bool), "num_sources_cited" (int), "source_domains" (list of up to 10 domain strings)}.

Use analyze_citation_structure_batch instead if you need this for more than one keyword - one call per topic here adds up fast for a cluster. Use analyze_citation_gap instead if you have your own page for this keyword and want the gap to the winner, not just the winner's shape.

Args: keyword: the topic/query to analyze, e.g. "how to reduce churn".

Analyze the structural shape of the winning AI answer across several related keywords/topics in one call: does each lead with a list, how long is the opening, how many sources it cites. Use this for content planning across a topic cluster, e.g. before writing several related pieces meant to get cited, instead of calling analyze_citation_structure once per topic.

Read-only: no side effects, safe to retry. Costs 1 quota unit per keyword in the batch (free tier: 3 checks/month total across all tools). A per-keyword provider error doesn't fail the whole batch - that keyword's entry just carries an "error" field instead.

Returns: {"results" (list, one {"keyword", ...same shape as analyze_citation_structure, or "error"} per keyword, in the order given), "summary": {"topics_analyzed", "topics_requested", "list_led_count", "avg_sources_cited"}}.

Args: keywords: topics/queries to analyze, e.g. ["how to reduce churn", "churn rate benchmarks", "reduce customer churn saas"]. Max 10.

Compare your own page's structure against the AI-generated answer actually cited for this keyword, and return concrete gaps to close instead of just describing the winner. Use this to answer 'what should I change on this page to get cited' rather than only 'what does a winning answer look like'.

Read-only: no side effects, safe to retry. Costs 1 quota unit/call (free tier: 3 checks/month total across all tools).

Returns: {"keyword", "your_url", "winning" (structure of the AI-cited answer, same shape as analyze_citation_structure), "yours" (same structure computed for your_url, "num_links_out"/ "linked_domains" standing in for source count), "gaps" (list of plain-English differences worth acting on)}, or {"error"} if either side couldn't be fetched/parsed.

Use analyze_citation_structure instead if you just want the winning answer's shape, not a comparison against your own page.

Args: keyword: the topic/query to check, e.g. "best project management tool". your_url: full URL of your own page to compare, e.g. "https://example.com/best-project-management-tools".