What AI engines answer for a prompt, with the brands they mention and the sources they cite. Slow: returns a task_id, then read the result with get_task.
Use when: "does ChatGPT recommend us for X", "who do AI engines cite for X", an AI visibility baseline for a brand across engines.
Not for: which prompts people ask, use aeo_search_prompts. Google's ten blue links, use seo_get_serp (ai_overview: true adds the overview to it at 1 credit). Whether a site is ready for AI crawlers, use aeo_get_site_readiness.
Returns: Task. task_id now; get_task returns rows[] per prompt and engine (answer, mentions[] (brand, mentioned, position, cited), citations[] (position, url, domain, title), search_results[] (pages retrieved, cited or not), search_queries[] (the web searches the engine ran), named_brands[] (brands ChatGPT tagged in the answer, not only yours)) and errors[] for cells that failed. answer null = the engine showed no AI answer. search_results[] and named_brands[] are filled for chatgpt only, search_queries[] for chatgpt and claude. named_brands[] drops a tag ChatGPT gives as a description instead of the brand, so it can miss brands; read the answer for a full list. chatgpt and gemini are what their apps show a person, model chosen by the app; claude and perplexity come from their model APIs. Answers are live and non-deterministic; results are kept 30 days and never cached.
Cost: per prompt, 15 credits for claude, 6 for perplexity, 2 each for chatgpt, gemini, ai_overview and ai_mode. Default 1 prompt on the five default engines = 27 credits. A cell that fails is not charged.
Example: {"prompts": ["best crm for startups"], "brands": ["HubSpot", "pipedrive.com"]}