Find which domains dominate AI-answer citations for a topic/keyword,
and optionally check where one domain, or several competitors at once,
show 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'. Comparing several
domains costs the same single call.
Read-only: no side effects, safe to retry. Costs 10 quota units/call
(free tier is 30 units/month shared across every metered tool, so up to 3
calls to this tool alone if nothing else is used that period).
Returns: {"keyword", "platform", "top_domains" (list of {"domain",
"mentions"}, most-cited domains for this keyword/platform, order as
ranked by the provider), "top_domains_limit" (int, the provider's own
cap on this list - absence from it is NOT evidence a domain has zero
citations, only that it did not rank in the top `top_domains_limit`),
"compare_domain_rank" (int|null, only present when compare_domain was
passed: the domain's 1-based position in top_domains, or null if it
did not rank in the top `top_domains_limit`), "compare_domain_ranks"
(only present when compare_domains was passed: {domain: rank or null},
same rank rule as compare_domain_rank), "country", "language",
"source_mix" ({"community_pct" (share of these mentions that go to
community sites such as Reddit, YouTube, X, Quora), "community_domains",
"other_domains"}: a high community_pct means this topic is won by what
people say about a brand elsewhere, not by any one site's pages)}.
This tool's citation universe is the provider's tracked mention corpus
for the keyword, which is a different measurement from
analyze_citation_structure's single live answer - the two can
legitimately disagree on whether a given domain shows up.
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 look up in the results
(exact match against the registrable domain, e.g. "notion.so"
will not match "mynotion.so.example.com").
country: market to check, e.g. "Italy". Defaults to "United States".
chat_gpt only has data for the United States; use platform
"google" for any other country.
language: language code, e.g. "it". Defaults to "en" (the only
option for chat_gpt).
compare_domains: optional list of up to 10 bare domains to rank side
by side, e.g. ["notion.so", "asana.com", "monday.com"]. Same
exact-match rule as compare_domain.