API Evangelist conversational phrasing for DataForSEO Serp API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for DataForSEO Serp API
  version: 1.0.0
extends: openapi/dataforseo-serp-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: 181
- target: $.paths['/v3/serp/id_list'].post
  update:
    x-apievangelist-phrasing:
      intent: List IDs of SERP tasks created in a period
      effect: read
      questions:
      - Can I get every SERP task ID I created during a given time window, including unfinished ones?
      - Where do I find metadata for all the search result tasks I set over the last few days?
      instructions:
      - text: Pull the list of all my SERP task IDs and their metadata for last week.
      - text: Show every SERP task I created this month, successful or still pending.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/errors'].post
  update:
    x-apievangelist-phrasing:
      intent: List SERP tasks that failed recently
      effect: read
      questions:
      - Which of my SERP API tasks returned an error in the past seven days?
      - Is there a way to see why some search result tasks failed this week?
      instructions:
      - text: List the SERP tasks that errored out over the last 7 days.
      - text: Report my failed search results tasks from this week with their error info.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/screenshot'].post
  update:
    x-apievangelist-phrasing:
      intent: Capture a screenshot of a search results page
      effect: read
      questions:
      - Can I get an image snapshot of what a search results page actually looked like?
      - How would I screenshot a SERP for a client report?
      instructions:
      - text: Take a live screenshot of the results page from my SERP task.
      - text: Capture an image of the search engine results page for my last task.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/ai_summary'].post
  update:
    x-apievangelist-phrasing:
      intent: Summarize a SERP with an AI prompt
      effect: read
      questions:
      - Can an AI write a summary of everything that shows up on a search results page?
      - Is it possible to ask a custom prompt against the content of a SERP I already fetched?
      instructions:
      - text: Generate an AI summary of the results page from my completed SERP task.
      - text: Answer my prompt using the content found on that search results page.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/locations'].get
  update:
    x-apievangelist-phrasing:
      intent: List locations supported for Google SERPs
      effect: read
      questions:
      - Which cities and regions can I target when pulling Google search results?
      - What location codes are valid for Google SERP tasks?
      instructions:
      - text: Fetch the full list of Google SERP locations.
      - text: Give me every location I can geo-target for Google results.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/locations/{country}'].get
  update:
    x-apievangelist-phrasing:
      intent: List Google SERP locations in one country
      effect: read
      questions:
      - Can I narrow the Google SERP location list to a single country?
      - What Google search locations exist inside Germany?
      instructions:
      - text: List the Google SERP locations available in country {country}.
        slots:
          country: path.country
      - text: Show only Google targeting locations for {country}.
        slots:
          country: path.country
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/languages'].get
  update:
    x-apievangelist-phrasing:
      intent: List languages supported for Google SERPs
      effect: read
      questions:
      - What languages can I request Google search results in?
      - Which language codes does the Google SERP endpoint accept?
      instructions:
      - text: Get the list of supported Google SERP languages.
      - text: Show me every language option for Google organic results.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/organic/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Google organic search task
      effect: write
      questions:
      - How do I schedule a Google organic results check for a keyword and collect it later?
      - Can I queue Google ranking lookups in bulk instead of running them live?
      instructions:
      - text: Queue a Google organic SERP task for my keyword in the US.
      - text: Set up a standard-method Google organic search task with a postback URL.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/organic/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List completed Google organic tasks
      effect: read
      questions:
      - Which of my queued Google organic tasks are finished and waiting to be collected?
      - How can I tell when my Google organic ranking tasks are done without a postback?
      instructions:
      - text: Show the Google organic tasks that are ready to collect.
      - text: List finished Google organic search tasks I haven't downloaded yet.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List completed tasks across all search engines
      effect: read
      questions:
      - Is there one place to see completed SERP tasks for every search engine at once?
      - Which tasks across all engines are done but not yet picked up?
      instructions:
      - text: List every ready SERP task across all search engines and types.
      - text: Check which uncollected tasks are complete for any engine.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/organic/tasks_fixed'].get
  update:
    x-apievangelist-phrasing:
      intent: List re-parsed Google organic tasks
      effect: read
      questions:
      - Which Google organic tasks were re-parsed and need to be collected again?
      - Were any of my Google ranking results fixed after a parsing issue?
      instructions:
      - text: List the fixed Google organic tasks waiting to be re-collected.
      - text: Show Google organic results that were re-parsed since my last pull.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/organic/task_get/regular/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get regular Google organic results for a task
      effect: read
      questions:
      - How do I download the plain organic listings from a Google task I queued earlier?
      - Can I get just the basic Google rankings without featured snippets for a finished task?
      instructions:
      - text: Fetch regular Google organic results for task {id}.
        slots:
          id: path.id
      - text: Collect the simple organic ranking list from Google task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/organic/task_get/advanced/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get advanced Google organic results for a task
      effect: read
      questions:
      - How do I collect a queued Google task with featured snippets and every SERP element included?
      - What does the advanced result for a finished Google organic task contain?
      instructions:
      - text: Get the advanced Google organic SERP for task {id}, including all extra elements.
        slots:
          id: path.id
      - text: Download full Google results with snippets and features for task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/organic/task_get/html/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get raw HTML of a Google organic task
      effect: read
      questions:
      - Can I get the raw HTML page Google returned for a task I already queued?
      - Where do I download the source markup of a completed Google organic task?
      instructions:
      - text: Download the raw Google results HTML for task {id}.
        slots:
          id: path.id
      - text: Return the HTML page from Google organic task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/organic/live/regular'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a live Google search for basic rankings
      effect: read
      questions:
      - Can I get Google's organic rankings for a keyword in real time without queuing a task?
      - Is there an instant way to check who ranks on Google for a term, just the basic listings?
      instructions:
      - text: Run a live Google search and give me the regular organic listings for my keyword.
      - text: Check current Google rankings right now for this keyword and location.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/organic/live/advanced'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a live Google search with all SERP features
      effect: read
      questions:
      - Can I see featured snippets, People Also Ask and other Google SERP features live for a keyword?
      - What's the real-time way to get the complete Google results page with every element?
      instructions:
      - text: Run a live advanced Google SERP for my keyword with all extra elements.
      - text: Pull the full Google results page right now, featured snippets included.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/organic/live/html'].post
  update:
    x-apievangelist-phrasing:
      intent: Fetch live raw HTML of a Google results page
      effect: read
      questions:
      - Can I fetch the raw HTML of a Google search page in real time?
      - How do I grab Google's results markup immediately for my own parser?
      instructions:
      - text: Fetch the live Google results HTML for this keyword.
      - text: Return Google's raw SERP page right now for my query and location.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/ai_mode/languages'].get
  update:
    x-apievangelist-phrasing:
      intent: List languages supported by Google AI Mode
      effect: read
      questions:
      - Which languages does the Google AI Mode results endpoint support?
      - What language codes can I use when pulling AI Mode answers?
      instructions:
      - text: List the languages available for Google AI Mode results.
      - text: Get supported AI Mode language codes.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/ai_mode/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Google AI Mode search task
      effect: write
      questions:
      - How can I track what Google's AI Mode answers for my keywords over time?
      - Can I queue AI Mode lookups and collect the answers later?
      instructions:
      - text: Queue a Google AI Mode task for my brand keyword.
      - text: Schedule an AI Mode search for this query and notify my postback URL.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/ai_mode/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List completed Google AI Mode tasks
      effect: read
      questions:
      - Which of my Google AI Mode tasks have finished?
      - Are any queued AI Mode answers ready for pickup?
      instructions:
      - text: Show AI Mode tasks that are complete and uncollected.
      - text: List ready Google AI Mode task IDs.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/ai_mode/tasks_fixed'].get
  update:
    x-apievangelist-phrasing:
      intent: List re-parsed Google AI Mode tasks
      effect: read
      questions:
      - Have any of my AI Mode results been re-parsed and need collecting again?
      - Which Google AI Mode tasks were fixed after the fact?
      instructions:
      - text: List fixed AI Mode tasks to re-collect.
      - text: Show re-parsed Google AI Mode results I haven't pulled.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/ai_mode/task_get/advanced/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get structured AI Mode results for a task
      effect: read
      questions:
      - How do I read the parsed AI Mode answer and cited sources from a task I queued?
      - Can I get structured JSON of Google's AI Mode response for a finished task?
      instructions:
      - text: Get the advanced AI Mode result for task {id}.
        slots:
          id: path.id
      - text: Collect the structured Google AI Mode answer from task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/ai_mode/task_get/html/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get raw HTML of a Google AI Mode task
      effect: read
      questions:
      - Can I download the raw HTML page of an AI Mode answer I already queued?
      - Where's the source markup for a finished Google AI Mode task?
      instructions:
      - text: Download AI Mode HTML for task {id}.
        slots:
          id: path.id
      - text: Return the raw Google AI Mode page from task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/ai_mode/live/advanced'].post
  update:
    x-apievangelist-phrasing:
      intent: Get Google AI Mode results in real time
      effect: read
      questions:
      - What does Google's AI Mode say about my keyword right now?
      - Can I pull an AI Mode answer live instead of waiting on a task?
      instructions:
      - text: Run a live Google AI Mode search for this query.
      - text: Show me the AI Mode response for my keyword immediately, parsed.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/ai_mode/live/html'].post
  update:
    x-apievangelist-phrasing:
      intent: Fetch live raw HTML of a Google AI Mode page
      effect: read
      questions:
      - Can I get the raw HTML of a Google AI Mode answer in real time?
      - Is there a live endpoint that returns AI Mode markup instead of parsed JSON?
      instructions:
      - text: Fetch live AI Mode HTML for my query.
      - text: Grab Google's AI Mode page source right now for this keyword.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/maps/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Google Maps search task
      effect: write
      questions:
      - How do I track which businesses rank on Google Maps for a keyword in a city?
      - Can I queue Google Maps lookups for up to 100 results and collect them later?
      instructions:
      - text: Queue a Google Maps search for plumbers in Chicago.
      - text: Schedule a Maps ranking task for my business keyword.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/maps/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List completed Google Maps tasks
      effect: read
      questions:
      - Which Google Maps tasks have finished processing?
      - Are my queued Maps ranking checks ready to download?
      instructions:
      - text: Show completed Google Maps tasks I haven't collected.
      - text: List ready Maps SERP task IDs.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/maps/tasks_fixed'].get
  update:
    x-apievangelist-phrasing:
      intent: List re-parsed Google Maps tasks
      effect: read
      questions:
      - Did any Google Maps results get re-parsed and need re-collecting?
      - Which Maps tasks were fixed since I last pulled them?
      instructions:
      - text: List fixed Google Maps tasks.
      - text: Show re-parsed Maps results waiting for pickup.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/maps/task_get/advanced/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Google Maps results for a task
      effect: read
      questions:
      - How do I get the business listings from a Google Maps task I queued?
      - Can I download ratings and positions from a finished Maps search task?
      instructions:
      - text: Get the Google Maps results for task {id}.
        slots:
          id: path.id
      - text: Collect Maps listings and rankings from task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/maps/live/advanced'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a live Google Maps search
      effect: read
      questions:
      - Who shows up on Google Maps for a keyword in my area right now?
      - Can I get the top 100 Maps listings for a search in real time?
      instructions:
      - text: Run a live Google Maps search for coffee shops in Austin.
      - text: Check current Maps rankings for my keyword immediately.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/local_finder/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Google Local Finder search task
      effect: write
      questions:
      - Can I queue checks of the Google Local Finder pack for a keyword and location?
      - What's the way to schedule local business rankings from Local Finder for later collection?
      instructions:
      - text: Queue a Local Finder task for dentists near Denver.
      - text: Schedule a Google Local Finder search for my service keyword.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/local_finder/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List completed Google Local Finder tasks
      effect: read
      questions:
      - Which Local Finder tasks are done and waiting to be collected?
      - Are any of my queued Local Finder searches complete?
      instructions:
      - text: List ready Google Local Finder tasks.
      - text: Show finished Local Finder searches I haven't pulled.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/local_finder/tasks_fixed'].get
  update:
    x-apievangelist-phrasing:
      intent: List re-parsed Google Local Finder tasks
      effect: read
      questions:
      - Were any Local Finder results re-parsed and need to be fetched again?
      - Which Google Local Finder tasks got fixed?
      instructions:
      - text: List fixed Local Finder tasks to re-collect.
      - text: Show re-parsed Google Local Finder results.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/local_finder/task_get/advanced/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Google Local Finder results for a task
      effect: read
      questions:
      - How do I read the parsed local business listings from a Local Finder task?
      - Can I get ratings and positions from a finished Local Finder search?
      instructions:
      - text: Get structured Local Finder results for task {id}.
        slots:
          id: path.id
      - text: Collect the local listings from Local Finder task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/local_finder/task_get/html/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get raw HTML of a Google Local Finder task
      effect: read
      questions:
      - Can I download the raw HTML from a Local Finder task I queued?
      - Where's the page source for a completed Local Finder search?
      instructions:
      - text: Download Local Finder HTML for task {id}.
        slots:
          id: path.id
      - text: Return the raw Google Local Finder page from task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/local_finder/live/advanced'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a live Google Local Finder search
      effect: read
      questions:
      - Which local businesses appear in Google Local Finder for my keyword right now?
      - Does the live Local Finder search return 20 results on desktop but only 10 on mobile?
      instructions:
      - text: Run a live Local Finder search for hair salons in Miami.
      - text: Check Local Finder rankings for my business keyword in real time.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/local_finder/live/html'].post
  update:
    x-apievangelist-phrasing:
      intent: Fetch live raw HTML of a Google Local Finder page
      effect: read
      questions:
      - Can I get Local Finder results as raw HTML in real time?
      - Is there a live endpoint for the Local Finder page source?
      instructions:
      - text: Fetch live Local Finder HTML for this keyword and location.
      - text: Grab the Google Local Finder page markup right now.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/news/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Google News search task
      effect: write
      questions:
      - How can I monitor Google News coverage for a keyword on a schedule?
      - Can I queue Google News searches and collect the articles later?
      instructions:
      - text: Queue a Google News task for my company name.
      - text: Schedule a news search for this topic in the UK.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/news/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List completed Google News tasks
      effect: read
      questions:
      - Which Google News tasks are finished?
      - Are my queued news searches ready to collect?
      instructions:
      - text: List ready Google News tasks.
      - text: Show completed news search tasks not yet downloaded.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/news/tasks_fixed'].get
  update:
    x-apievangelist-phrasing:
      intent: List re-parsed Google News tasks
      effect: read
      questions:
      - Did any Google News results get re-parsed?
      - Which news tasks need re-collecting after a fix?
      instructions:
      - text: List fixed Google News tasks.
      - text: Show re-parsed news results to pull again.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/news/task_get/advanced/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Google News results for a task
      effect: read
      questions:
      - How do I read the parsed news articles from a Google News task I queued?
      - Can I get headlines and sources from a finished news search?
      instructions:
      - text: Get Google News results for task {id}.
        slots:
          id: path.id
      - text: Collect the parsed news articles from task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/news/task_get/html/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get raw HTML of a Google News task
      effect: read
      questions:
      - Can I download the raw HTML from a queued Google News search?
      - Where do I get the page source of a finished news task?
      instructions:
      - text: Download Google News HTML for task {id}.
        slots:
          id: path.id
      - text: Return the raw news results page from task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/news/live/advanced'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a live Google News search
      effect: read
      questions:
      - What news stories is Google showing for a keyword right now?
      - Can I pull Google News results instantly without a task queue?
      instructions:
      - text: Run a live Google News search for this keyword.
      - text: Show me current news coverage about my brand in real time.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/news/live/html'].post
  update:
    x-apievangelist-phrasing:
      intent: Fetch live raw HTML of a Google News page
      effect: read
      questions:
      - Can I get a Google News results page as raw HTML in real time?
      - Is there a live news endpoint that returns markup instead of JSON?
      instructions:
      - text: Fetch live Google News HTML for my query.
      - text: Grab the news results page source right now.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/events/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Google Events search task
      effect: write
      questions:
      - How do I collect upcoming events Google lists for a keyword and city?
      - Does the Google Events search work in languages other than English?
      instructions:
      - text: Queue a Google Events task for concerts in Seattle.
      - text: Schedule an events search for tech conferences in London.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/events/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List completed Google Events tasks
      effect: read
      questions:
      - Which Google Events tasks have finished?
      - Are my queued events searches ready?
      instructions:
      - text: List ready Google Events tasks.
      - text: Show completed events searches waiting for pickup.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/events/tasks_fixed'].get
  update:
    x-apievangelist-phrasing:
      intent: List re-parsed Google Events tasks
      effect: read
      questions:
      - Were any Google Events results re-parsed?
      - Which events tasks should I collect again after a fix?
      instructions:
      - text: List fixed Google Events tasks.
      - text: Show re-parsed events results.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/events/task_get/advanced/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Google Events results for a task
      effect: read
      questions:
      - How do I read event names, dates and venues from a queued Google Events task?
      - Can I download the parsed event listings for a finished task?
      instructions:
      - text: Get Google Events results for task {id}.
        slots:
          id: path.id
      - text: Collect the event listings from task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/events/live/advanced'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a live Google Events search
      effect: read
      questions:
      - What events does Google list for a keyword near me right now?
      - Can I search Google Events in real time instead of queuing?
      instructions:
      - text: Run a live Google Events search for food festivals in Chicago.
      - text: Show upcoming events for this keyword immediately.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/images/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Google Images search task
      effect: write
      questions:
      - How can I track which images rank on Google Images for a keyword?
      - Can I queue Google Images searches and collect them later?
      instructions:
      - text: Queue a Google Images task for my product keyword.
      - text: Schedule an image search for this term in France.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/images/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List completed Google Images tasks
      effect: read
      questions:
      - Which Google Images tasks are complete?
      - Are my queued image searches ready to download?
      instructions:
      - text: List ready Google Images tasks.
      - text: Show finished image searches I haven't collected.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/images/tasks_fixed'].get
  update:
    x-apievangelist-phrasing:
      intent: List re-parsed Google Images tasks
      effect: read
      questions:
      - Did any Google Images results get re-parsed?
      - Which image search tasks need re-collecting?
      instructions:
      - text: List fixed Google Images tasks.
      - text: Show re-parsed image search results.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/images/task_get/advanced/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Google Images results for a task
      effect: read
      questions:
      - How do I get the parsed image results from a Google Images task?
      - Can I see image URLs and source pages from a finished image search?
      instructions:
      - text: Get Google Images results for task {id}.
        slots:
          id: path.id
      - text: Collect image listings and source pages from task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/images/task_get/html/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get raw HTML of a Google Images task
      effect: read
      questions:
      - Can I download the raw HTML of a queued Google Images search?
      - Where's the markup for a finished image search task?
      instructions:
      - text: Download Google Images HTML for task {id}.
        slots:
          id: path.id
      - text: Return the raw image results page from task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/images/live/advanced'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a live Google Images search
      effect: read
      questions:
      - What are the top 100 Google Images results for a keyword right now?
      - Can I pull image search rankings in real time?
      instructions:
      - text: Run a live Google Images search for this keyword.
      - text: Show the top image results for my product name immediately.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/images/live/html'].post
  update:
    x-apievangelist-phrasing:
      intent: Fetch live raw HTML of a Google Images page
      effect: read
      questions:
      - Can I fetch a Google Images results page as raw HTML in real time?
      - Is there a live image search endpoint that returns markup?
      instructions:
      - text: Fetch live Google Images HTML for my keyword.
      - text: Grab the image results page source right now.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/serp/google/search_by_image/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Google reverse image search task
      effect: write
      questions:
      - How do I find where an image appears online using Google search by image?
      - Can I run a reverse image lookup and get up to 100 results?
      instructions:
      - text: Queue a search-by-image task for this image URL.
      - text: Schedule a reverse image search on my product photo.
      method: generated
      generated: '2026-10-01'


# --- truncated at 32 KB (97 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/overlays/dataforseo-serp-api-phrasing-overlay.yaml