# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for DataForSEO AI Optimization API
  version: 1.0.0
extends: openapi/dataforseo-aioptimization-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 44
- target: $.paths['/v3/ai_optimization/chat_gpt/llm_scraper/locations'].get
  update:
    x-apievangelist-phrasing:
      intent: List locations for the ChatGPT scraper
      effect: read
      questions:
      - Which locations can I target when scraping ChatGPT search results?
      - Where do I find location codes for ChatGPT scraper tasks?
      instructions:
      - text: List all locations supported by the ChatGPT LLM scraper.
      - text: Get every ChatGPT scraper location code across all countries.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/chat_gpt/llm_scraper/locations/{country}'].get
  update:
    x-apievangelist-phrasing:
      intent: List ChatGPT scraper locations in a country
      effect: read
      questions:
      - Which ChatGPT scraper locations exist within one specific country?
      - Can I filter the ChatGPT scraper location list by country code?
      instructions:
      - text: List ChatGPT scraper locations in country {country}.
        slots:
          country: path.country
      - text: Show the ChatGPT scraper location codes for {country} only.
        slots:
          country: path.country
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/chat_gpt/llm_scraper/languages'].get
  update:
    x-apievangelist-phrasing:
      intent: List languages for the ChatGPT scraper
      effect: read
      questions:
      - What languages does the ChatGPT LLM scraper support?
      - Can I scrape ChatGPT search answers in languages other than English?
      instructions:
      - text: List the languages supported by the ChatGPT LLM scraper.
      - text: Get the ChatGPT scraper language codes.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/chat_gpt/llm_scraper/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a ChatGPT search scraping task
      effect: write
      questions:
      - How do I queue a ChatGPT search scrape to collect later instead of waiting live?
      - Can I set a postback URL to be notified when a ChatGPT scrape finishes?
      instructions:
      - text: Queue a ChatGPT scraper task for my keyword in the US and English.
      - text: Submit an asynchronous ChatGPT search scrape with a postback URL.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/chat_gpt/llm_scraper/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List completed ChatGPT scraper tasks
      effect: read
      questions:
      - Which of my queued ChatGPT scraper tasks are finished but not yet collected?
      - How can I find ChatGPT scrape results that are ready without a postback URL?
      instructions:
      - text: List my completed ChatGPT scraper tasks that haven't been collected.
      - text: Check which ChatGPT scrape tasks are ready to download.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/chat_gpt/llm_scraper/task_get/advanced/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get structured results of a ChatGPT scrape
      effect: read
      questions:
      - How do I fetch the parsed, structured output of a ChatGPT scraper task I queued?
      - Can I get ChatGPT search results as structured data rather than HTML?
      instructions:
      - text: Get the advanced structured results of ChatGPT scraper task {id}.
        slots:
          id: path.id
      - text: Fetch parsed ChatGPT answer data for task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/chat_gpt/llm_scraper/task_get/html/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get raw HTML of a queued ChatGPT scrape
      effect: read
      questions:
      - Can I download the raw HTML page of a ChatGPT scraper task I already queued?
      - Where do I get the HTML version of a completed ChatGPT scrape?
      instructions:
      - text: Download the raw HTML for ChatGPT scraper task {id}.
        slots:
          id: path.id
      - text: Get the HTML results page of queued ChatGPT task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/chat_gpt/llm_scraper/live/advanced'].post
  update:
    x-apievangelist-phrasing:
      intent: Scrape ChatGPT search results live
      effect: read
      questions:
      - Can I get structured ChatGPT search results immediately in one call?
      - What does ChatGPT show for my keyword in a given location right now?
      instructions:
      - text: Scrape ChatGPT search results live for my keyword and return structured data.
      - text: Run a real-time ChatGPT search for this query in the UK.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/chat_gpt/llm_scraper/live/html'].post
  update:
    x-apievangelist-phrasing:
      intent: Get live raw HTML of ChatGPT results
      effect: read
      questions:
      - Can I get the raw HTML of ChatGPT results for a keyword in real time?
      - Is there a live call that returns ChatGPT's results page as HTML?
      instructions:
      - text: Fetch the live raw HTML of ChatGPT results for my keyword.
      - text: Get ChatGPT's results page HTML right now for this query and location.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/llm_mentions/locations_and_languages'].get
  update:
    x-apievangelist-phrasing:
      intent: List locations and languages for LLM Mentions
      effect: read
      questions:
      - Which locations and languages are supported for tracking brand mentions in AI answers?
      - Where do I get location codes for LLM Mentions requests?
      instructions:
      - text: List the locations and languages supported by LLM Mentions.
      - text: Get LLM Mentions location and language codes.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/llm_mentions/available_filters'].get
  update:
    x-apievangelist-phrasing:
      intent: List filters for LLM Mentions
      effect: read
      questions:
      - What filters can I apply to LLM Mentions queries?
      - Which fields can I filter on when analyzing AI search mentions?
      instructions:
      - text: Show the filters available for LLM Mentions endpoints.
      - text: Get the LLM Mentions filter fields and operators.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/llm_mentions/search/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Search mentions in AI search answers
      effect: read
      questions:
      - Where is my brand or domain mentioned in Google AI Overviews or ChatGPT answers?
      - Can I search individual LLM mentions with their metrics for a location and language?
      instructions:
      - text: Search ChatGPT answers for mentions of my brand.
      - text: Find individual Google AI Overview mentions of my domain.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/llm_mentions/top_pages/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Rank pages most mentioned in AI answers
      effect: read
      questions:
      - Which pages are cited most often in AI answers about my target keyword?
      - Can I see LLM mention metrics grouped by page?
      instructions:
      - text: List the most-mentioned pages in AI answers for my target.
      - text: Rank pages by LLM mentions on ChatGPT for this keyword.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/llm_mentions/top_domains/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Rank domains most mentioned in AI answers
      effect: read
      questions:
      - Which domains get mentioned most in AI Overviews for my topic?
      - Can I see LLM mention metrics grouped by domain?
      instructions:
      - text: List the most-mentioned domains in AI answers for my target.
      - text: Rank domains by Google AI Overview mentions for this keyword.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/llm_mentions/aggregated_metrics/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get aggregated AI mention metrics
      effect: read
      questions:
      - What are the total mention metrics for my keywords or domains in AI search?
      - Can I get one rolled-up summary of LLM mentions for a target list?
      instructions:
      - text: Get aggregated LLM mention metrics for my domain.
      - text: Summarize total AI search mentions for these keywords.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/llm_mentions/cross_aggregated_metrics/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Compare AI mention metrics across targets
      effect: read
      questions:
      - Can I compare LLM mention metrics side by side for several targets with custom grouping keys?
      - How do my domain's AI mentions stack up against other targets, one result per target?
      instructions:
      - text: Compare cross-aggregated LLM mention metrics for my domain and two others.
      - text: Group AI mention metrics by custom keys for each target in my list.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/chat_gpt/llm_responses/models'].get
  update:
    x-apievangelist-phrasing:
      intent: List available ChatGPT models
      effect: read
      questions:
      - Which ChatGPT models can I request responses from?
      - What GPT model names are valid for LLM Responses?
      instructions:
      - text: List the ChatGPT models available for LLM Responses.
      - text: Get the valid GPT model names.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/chat_gpt/llm_responses/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a live ChatGPT model response
      effect: read
      questions:
      - Can I send a prompt to a specific ChatGPT model and get a structured answer immediately?
      - How do I see what a GPT model answers to my prompt in real time?
      instructions:
      - text: Ask a ChatGPT model my prompt live and return the structured response.
      - text: Get a real-time GPT response to this question.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/chat_gpt/llm_responses/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a ChatGPT response task
      effect: write
      questions:
      - Can I queue prompts to a ChatGPT model and collect the responses later?
      - Is there an asynchronous way to get ChatGPT answers for many prompts?
      instructions:
      - text: Queue a ChatGPT LLM response task for my prompt.
      - text: Submit these prompts to a GPT model as background tasks.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/chat_gpt/llm_responses/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List completed ChatGPT response tasks
      effect: read
      questions:
      - Which of my queued ChatGPT response tasks are done but not collected?
      - How do I find ready ChatGPT answers when I didn't set a postback URL?
      instructions:
      - text: List my completed ChatGPT response tasks waiting to be collected.
      - text: Check which GPT response tasks are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/chat_gpt/llm_responses/task_get/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the result of a ChatGPT response task
      effect: read
      questions:
      - How do I retrieve the ChatGPT answer for a response task I queued earlier?
      - Can I fetch a queued GPT response by its task ID?
      instructions:
      - text: Get the ChatGPT response for task {id}.
        slots:
          id: path.id
      - text: Fetch the GPT model answer from queued task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/claude/llm_responses/models'].get
  update:
    x-apievangelist-phrasing:
      intent: List available Claude models
      effect: read
      questions:
      - Which Claude models can I request responses from?
      - What Claude model names are valid for LLM Responses?
      instructions:
      - text: List the Claude models available for LLM Responses.
      - text: Get the valid Claude model names.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/claude/llm_responses/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a live Claude model response
      effect: read
      questions:
      - What would Claude reply if I gave it this exact prompt, returned on the spot?
      - Which Claude model version answers my brand question, and what does it say live?
      instructions:
      - text: Ask a Claude model my prompt live and return the structured response.
      - text: Get a real-time Claude response to this question.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/claude/llm_responses/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Claude response task
      effect: write
      questions:
      - Is there a batch mode for sending many prompts to Claude without waiting on each one?
      - Can Claude prompt tasks be submitted now and picked up when they complete?
      instructions:
      - text: Queue a Claude LLM response task for my prompt.
      - text: Submit these prompts to a Claude model as background tasks.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/claude/llm_responses/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List completed Claude response tasks
      effect: read
      questions:
      - Which of my submitted Claude prompts have finished processing but not been picked up?
      - Without a postback, where do I see which Claude response jobs are complete?
      instructions:
      - text: List my completed Claude response tasks waiting to be collected.
      - text: Check which Claude response tasks are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/claude/llm_responses/task_get/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the result of a Claude response task
      effect: read
      questions:
      - Where do I pick up the finished Claude reply for a job I submitted?
      - Can I read the Claude output of an earlier background task using its ID?
      instructions:
      - text: Get the Claude response for task {id}.
        slots:
          id: path.id
      - text: Fetch the Claude model answer from queued task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/gemini/llm_responses/models'].get
  update:
    x-apievangelist-phrasing:
      intent: List available Gemini models
      effect: read
      questions:
      - Which Gemini models can I request responses from?
      - What Gemini model names are valid for LLM Responses?
      instructions:
      - text: List the Gemini models available for LLM Responses.
      - text: Get the valid Gemini model names.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/gemini/llm_responses/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Gemini response task
      effect: write
      questions:
      - Is there a deferred mode for running a batch of prompts through Gemini?
      - Can I submit Gemini prompt jobs now and pick up the replies once they're done?
      instructions:
      - text: Queue a Gemini LLM response task for my prompt.
      - text: Submit these prompts to a Gemini model as background tasks.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/gemini/llm_responses/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List completed Gemini response tasks
      effect: read
      questions:
      - Which of my queued Gemini response tasks are done but not collected?
      - How do I find ready Gemini model answers when I didn't set a postback URL?
      instructions:
      - text: List my completed Gemini response tasks waiting to be collected.
      - text: Check which Gemini model response tasks are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/gemini/llm_responses/task_get/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the result of a Gemini response task
      effect: read
      questions:
      - Where do I pick up the finished Gemini model reply for a job ID?
      - Can I read the output of an earlier Gemini background prompt job?
      instructions:
      - text: Get the Gemini model response for task {id}.
        slots:
          id: path.id
      - text: Fetch the Gemini answer from queued response task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/gemini/llm_responses/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a live Gemini model response
      effect: read
      questions:
      - What would Gemini reply to this exact prompt if I asked it synchronously?
      - Which Gemini model should I name to get an instant structured reply to my question?
      instructions:
      - text: Ask a Gemini model my prompt live and return the structured response.
      - text: Get a real-time Gemini model response to this question.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/gemini/llm_scraper/locations'].get
  update:
    x-apievangelist-phrasing:
      intent: List locations for the Gemini scraper
      effect: read
      questions:
      - Which locations can I target when scraping Gemini results?
      - Where do I find location codes for Gemini scraper tasks?
      instructions:
      - text: List all locations supported by the Gemini LLM scraper.
      - text: Get the Gemini scraper location codes.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/gemini/llm_scraper/languages'].get
  update:
    x-apievangelist-phrasing:
      intent: List languages for the Gemini scraper
      effect: read
      questions:
      - What languages does the Gemini LLM scraper support?
      - Can I scrape Gemini results in languages other than English?
      instructions:
      - text: List the languages supported by the Gemini LLM scraper.
      - text: Get the Gemini scraper language codes.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/gemini/llm_scraper/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Gemini scraping task
      effect: write
      questions:
      - What's the asynchronous way to capture what Gemini shows for a keyword?
      - Can I schedule a Gemini results capture and get pinged at a callback URL when done?
      instructions:
      - text: Set up a background Gemini scrape for this keyword, location and language.
      - text: Create a Gemini scraping job that notifies my callback URL when finished.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/gemini/llm_scraper/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List completed Gemini scraper tasks
      effect: read
      questions:
      - Are any of my Gemini scraping jobs complete and waiting to be picked up?
      - Without a callback URL, where do I see which Gemini scrapes are done?
      instructions:
      - text: Show Gemini scraping jobs that are complete but still uncollected.
      - text: Check for finished Gemini scrape jobs I haven't downloaded.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/gemini/llm_scraper/task_get/advanced/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get structured results of a Gemini scrape
      effect: read
      questions:
      - Where do I read the parsed Gemini answer from a scraping job I submitted?
      - Can a finished Gemini scrape job be returned as structured fields instead of a page?
      instructions:
      - text: Get the advanced structured results of Gemini scraper task {id}.
        slots:
          id: path.id
      - text: Fetch parsed Gemini answer data for scrape task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/gemini/llm_scraper/task_get/html/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get raw HTML of a queued Gemini scrape
      effect: read
      questions:
      - Is the unparsed Gemini page markup available for a scraping job I submitted earlier?
      - Where do I get the HTML version of a completed Gemini scrape?
      instructions:
      - text: Download the raw HTML for Gemini scraper task {id}.
        slots:
          id: path.id
      - text: Get the HTML results page of queued Gemini task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/gemini/llm_scraper/live/advanced'].post
  update:
    x-apievangelist-phrasing:
      intent: Scrape Gemini results live
      effect: read
      questions:
      - Can I get structured Gemini results for a keyword immediately in one call?
      - Which sources and text does Gemini return for my query in a chosen market at this moment?
      instructions:
      - text: Scrape Gemini results live for my keyword and return structured data.
      - text: Run a real-time Gemini scrape for this query in Germany.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/gemini/llm_scraper/live/html'].post
  update:
    x-apievangelist-phrasing:
      intent: Get live raw HTML of Gemini results
      effect: read
      questions:
      - Can I capture Gemini's unparsed page markup for a query synchronously?
      - Which call hands back Gemini's answer page source without queuing a job?
      instructions:
      - text: Fetch the live raw HTML of Gemini results for my keyword.
      - text: Grab Gemini's answer page source immediately for this query and market.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/perplexity/llm_responses/models'].get
  update:
    x-apievangelist-phrasing:
      intent: List available Perplexity models
      effect: read
      questions:
      - Which Perplexity models can I request responses from?
      - What Perplexity model names are valid for LLM Responses?
      instructions:
      - text: List the Perplexity models available for LLM Responses.
      - text: Get the valid Perplexity model names.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/perplexity/llm_responses/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a live Perplexity model response
      effect: read
      questions:
      - Can I send a prompt to a Perplexity model and get a structured answer immediately?
      - What does Perplexity answer to my prompt in real time?
      instructions:
      - text: Ask a Perplexity model my prompt live and return the structured response.
      - text: Get a real-time Perplexity response to this question.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/ai_keyword_data/available_filters'].get
  update:
    x-apievangelist-phrasing:
      intent: List filters for AI Keyword Data
      effect: read
      questions:
      - What filters can I use with AI Keyword Data requests?
      - Which fields are filterable when querying AI search volume?
      instructions:
      - text: Show the filters available for AI Keyword Data endpoints.
      - text: Get the AI Keyword Data filter fields.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/ai_keyword_data/locations_and_languages'].get
  update:
    x-apievangelist-phrasing:
      intent: List locations and languages for AI Keyword Data
      effect: read
      questions:
      - Which locations and languages does AI Keyword Data support?
      - Where do I get location codes for AI search volume lookups?
      instructions:
      - text: List the locations and languages supported by AI Keyword Data.
      - text: Get AI Keyword Data location and language codes.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/ai_optimization/ai_keyword_data/keywords_search_volume/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get AI search volume for keywords
      effect: read
      questions:
      - How often are my keywords used in AI tools?
      - Can DataForSEO estimate AI search volume for a list of target keywords?
      instructions:
      - text: Get the estimated AI tool search volume for these keywords.
      - text: Check how much my target keywords are used in AI tools.
      method: generated
      generated: '2026-10-01'