mode | string or SelectableOption | No | subdomains | How to interpret each target: ‘subdomains’ (domain and all subdomains, default), ‘domain’ (the exact host only), ‘prefix’ (every URL starting with the target), or ‘exact’ (the exact URL only). |
metrics | array of string or SelectableOption | No | - | Metrics to return (url is always included). Available: domain_rating, ahrefs_rank, url_rating, backlinks, backlinks_dofollow, backlinks_nofollow, backlinks_internal, backlinks_redirect, refdomains, refdomains_dofollow, refdomains_nofollow, refips, refips_subnets, linked_domains, linked_domains_dofollow, outgoing_links, outgoing_links_dofollow, org_keywords, org_keywords_1_3, org_keywords_4_10, org_keywords_11_20, org_keywords_21_50, org_keywords_51_plus, org_traffic, org_cost, org_traffic_top_by_country, paid_keywords, paid_traffic, paid_cost, paid_ads, ip. Each selected field adds to the Ahrefs API unit cost per row: org_traffic, org_cost, paid_traffic, paid_cost and org_traffic_top_by_country cost 10 units, refdomains fields cost 5, the rest cost 1. Defaults to domain_rating, ahrefs_rank, backlinks, refdomains, org_keywords, org_traffic, org_cost, paid_keywords, paid_traffic. |
include_ai_citations | boolean | No | False | Also return ai_citations (links to the target in AI answers) and ai_cited_pages (distinct pages cited) across ChatGPT, Google AI Overviews, AI Mode, Gemini, Perplexity, Copilot, Claude and Grok combined. Makes one extra Ahrefs request per target (about 50 API units each). |