# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for DataForSEO Keywords Data API
  version: 1.0.0
extends: openapi/dataforseo-keywordsdata-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: 70
- target: $.paths['/v3/keywords_data/id_list'].post
  update:
    x-apievangelist-phrasing:
      intent: List my Keywords Data task IDs for a period
      effect: read
      questions:
      - Can I see the IDs of every Keywords Data task I created in a given time window?
      - Which keyword research tasks did I submit last week, including the ones still unfinished?
      instructions:
      - text: List the IDs and metadata of all my Keywords Data tasks from a chosen date range.
      - text: Show every Keywords Data task I created this month, successful or not.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/errors'].post
  update:
    x-apievangelist-phrasing:
      intent: List Keywords Data tasks that failed
      effect: read
      questions:
      - Which of my Keywords Data tasks returned an error in the past 7 days?
      - Where can I see why my keyword volume or trends tasks failed recently?
      instructions:
      - text: Show the Keywords Data tasks that errored during the last week.
      - text: Pull the error details for my failed keyword research tasks.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_ads/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check if Google updated last month's keyword data
      effect: read
      questions:
      - Has Google released last month's keyword search volume data yet?
      - Is the Google Ads keyword data for the previous month available now, or am I still seeing older figures?
      instructions:
      - text: Check whether Google Ads keyword metrics have been updated for the previous month.
      - text: Tell me which month the latest Google Ads search volume data covers.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_ads/locations'].get
  update:
    x-apievangelist-phrasing:
      intent: List locations for Google Ads keyword data
      effect: read
      questions:
      - Which countries, regions and cities can I target when pulling Google Ads keyword data?
      - What location codes does the Google Ads keyword endpoint accept?
      instructions:
      - text: List every location supported for Google Ads keyword data.
      - text: Get the full Google Ads geo-targeting location list for keyword research.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_ads/locations/{country}'].get
  update:
    x-apievangelist-phrasing:
      intent: List Google Ads keyword locations in one country
      effect: read
      questions:
      - Which cities and regions inside a single country are available for Google Ads keyword data?
      - Can I narrow the Google Ads keyword location list to just one country?
      instructions:
      - text: List the Google Ads keyword data locations within country {country}.
        slots:
          country: path.country
      - text: Show Google Ads targetable regions and cities for {country}.
        slots:
          country: path.country
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_ads/languages'].get
  update:
    x-apievangelist-phrasing:
      intent: List languages for Google Ads keyword data
      effect: read
      questions:
      - What languages can I request Google Ads keyword volume in?
      - Which language codes are valid for Google Ads keyword research?
      instructions:
      - text: List the languages supported for Google Ads keyword data.
      - text: Get the Google Ads keyword language codes and names.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_ads/search_volume/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Google Ads search volume task
      effect: write
      questions:
      - Can I submit a batch of keywords for Google Ads search volume and collect the results later?
      - How do I set up a background job that fetches Google Ads search volume, CPC and competition?
      instructions:
      - text: Queue a Google Ads search volume task for my keyword list and notify me when it's done.
      - text: Post a standard (non-live) Google Ads search volume job for these keywords.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_ads/search_volume/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Google Ads search volume tasks
      effect: read
      questions:
      - Which of my queued Google Ads search volume tasks have finished but haven't been collected?
      - Are any Google Ads search volume jobs ready for me to download?
      instructions:
      - text: List completed, uncollected Google Ads search volume tasks.
      - text: Check which Google Ads search volume jobs are ready to fetch.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_ads/search_volume/task_get/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get results of a Google Ads search volume task
      effect: read
      questions:
      - Where do I pick up the search volume results of a Google Ads task I queued earlier?
      - Can I re-download a finished Google Ads search volume task by its ID?
      instructions:
      - text: Fetch the Google Ads search volume results for task {id}.
        slots:
          id: path.id
      - text: Download the keyword volume, CPC and competition from queued task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_ads/search_volume/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get Google Ads search volume instantly
      effect: read
      questions:
      - What's the monthly Google search volume and CPC for my keywords right now, without waiting on a task?
      - Can I get Google Ads search volume in a single live request?
      instructions:
      - text: Get live Google Ads search volume, CPC and competition for these keywords.
      - text: Look up Google Ads monthly searches for my keyword list in real time.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_ads/keywords_for_site/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Google Ads keywords-for-site task
      effect: write
      questions:
      - Can I queue a job that finds the keywords Google Ads suggests for a competitor's website?
      - Is there a delayed, cheaper way to get Google Ads keyword ideas for a domain?
      instructions:
      - text: Queue a Google Ads keywords-for-site task for a target domain.
      - text: Post a background job to pull Google Ads keyword suggestions for a website.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_ads/keywords_for_site/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Google Ads keywords-for-site tasks
      effect: read
      questions:
      - Which Google Ads keywords-for-site jobs have completed and are waiting to be collected?
      - Are my website keyword idea tasks from Google Ads ready yet?
      instructions:
      - text: List the completed, uncollected Google Ads keywords-for-site tasks.
      - text: Show which site keyword idea jobs from Google Ads are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_ads/keywords_for_site/task_get/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get results of a Google Ads keywords-for-site task
      effect: read
      questions:
      - Where can I retrieve the website keyword ideas from a Google Ads task I already queued?
      - Can I fetch Google Ads site keyword suggestions by task ID?
      instructions:
      - text: Fetch the Google Ads keywords-for-site results for task {id}.
        slots:
          id: path.id
      - text: Download the keyword ideas generated for a website in task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_ads/keywords_for_site/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get Google Ads keyword ideas for a website live
      effect: read
      questions:
      - What keywords does Google Ads associate with a given website, returned immediately?
      - Can I get keyword ideas for a competitor's domain in one live call?
      instructions:
      - text: Get live Google Ads keyword suggestions for a website.
      - text: Pull Google Ads keywords relevant to a domain right now, with their volume.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_ads/keywords_for_keywords/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Google Ads keyword ideas task
      effect: write
      questions:
      - Can I queue a Google Ads job that expands seed keywords into related keyword ideas?
      - How do I submit seed terms for Google Ads keyword suggestions to process in the background?
      instructions:
      - text: Queue a Google Ads keywords-for-keywords task for my seed terms.
      - text: Post a background job to expand these seed keywords with Google Ads suggestions.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_ads/keywords_for_keywords/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Google Ads keyword ideas tasks
      effect: read
      questions:
      - Which Google Ads seed-keyword expansion tasks have finished and not been collected?
      - Are my keywords-for-keywords jobs from Google Ads ready?
      instructions:
      - text: List completed, uncollected Google Ads keywords-for-keywords tasks.
      - text: Check which seed keyword expansion jobs from Google Ads are ready to fetch.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_ads/keywords_for_keywords/task_get/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get results of a Google Ads keyword ideas task
      effect: read
      questions:
      - Where do I collect the related keyword ideas from a Google Ads seed-keyword task?
      - Can I fetch Google Ads keywords-for-keywords output using its task ID?
      instructions:
      - text: Fetch the Google Ads keyword ideas for seed-keyword task {id}.
        slots:
          id: path.id
      - text: Download the related keywords Google Ads suggested in task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_ads/keywords_for_keywords/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get Google Ads keyword ideas for seed terms live
      effect: read
      questions:
      - What related keywords does Google Ads suggest for my seed terms, returned instantly?
      - Can I expand a seed keyword list with Google Ads ideas in one live request?
      instructions:
      - text: Get live Google Ads keyword suggestions for these seed keywords.
      - text: Expand my seed terms into related Google Ads keywords right now.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_ads/ad_traffic_by_keywords/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Google Ads ad traffic forecast task
      effect: write
      questions:
      - Can I queue a forecast of impressions, clicks and cost for keywords at a given bid?
      - Is there a background job for estimating Google Ads traffic for a keyword list?
      instructions:
      - text: Queue a Google Ads ad traffic forecast task for my keywords and bid.
      - text: Post a background job estimating ad clicks and spend for these keywords.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_ads/ad_traffic_by_keywords/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Google Ads ad traffic tasks
      effect: read
      questions:
      - Which Google Ads ad traffic forecast tasks are done and still uncollected?
      - Are my ad traffic by keywords jobs ready to download?
      instructions:
      - text: List completed, uncollected Google Ads ad traffic by keywords tasks.
      - text: Show which ad traffic forecast jobs are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_ads/ad_traffic_by_keywords/task_get/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get results of a Google Ads ad traffic task
      effect: read
      questions:
      - Where can I retrieve the impression and click forecast from an ad traffic task I queued?
      - Can I fetch a Google Ads traffic forecast by its task ID?
      instructions:
      - text: Fetch the Google Ads ad traffic forecast for task {id}.
        slots:
          id: path.id
      - text: Download estimated clicks, impressions and cost from task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_ads/ad_traffic_by_keywords/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Forecast Google Ads traffic for keywords live
      effect: read
      questions:
      - How many clicks and impressions could my keywords get on Google Ads, and what would they cost?
      - Can I estimate ad traffic for a keyword list at a set bid in real time?
      instructions:
      - text: Forecast Google Ads impressions, clicks and cost for these keywords now.
      - text: Get a live ad traffic estimate for my keywords at my max CPC bid.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_trends/locations'].get
  update:
    x-apievangelist-phrasing:
      intent: List locations for Google Trends data
      effect: read
      questions:
      - Which locations can I use when requesting Google Trends data?
      - What geographic options are supported for Google Trends keyword popularity?
      instructions:
      - text: List all locations supported for Google Trends.
      - text: Get the Google Trends location codes.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_trends/locations/{country}'].get
  update:
    x-apievangelist-phrasing:
      intent: List Google Trends locations in one country
      effect: read
      questions:
      - Which Google Trends regions exist inside one specific country?
      - Can I filter Google Trends locations by country?
      instructions:
      - text: List Google Trends locations within country {country}.
        slots:
          country: path.country
      - text: Show the Google Trends regions available for {country}.
        slots:
          country: path.country
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_trends/languages'].get
  update:
    x-apievangelist-phrasing:
      intent: List languages for Google Trends data
      effect: read
      questions:
      - What languages does the Google Trends endpoint support?
      - Which language codes can I pass for Google Trends queries?
      instructions:
      - text: List the languages supported for Google Trends.
      - text: Get the Google Trends language codes.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_trends/categories'].get
  update:
    x-apievangelist-phrasing:
      intent: List Google Trends categories
      effect: read
      questions:
      - What topic categories can I filter Google Trends results by?
      - Is there a list of Google Trends category codes?
      instructions:
      - text: List all Google Trends categories.
      - text: Get the category IDs I can use to narrow Google Trends queries.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_trends/explore/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Google Trends Explore task
      effect: write
      questions:
      - Can I queue a Google Trends Explore job for my keywords and collect it later?
      - Is there a background way to pull Google Trends popularity for YouTube or Google Shopping?
      instructions:
      - text: Queue a Google Trends Explore task for these keywords.
      - text: Post a background Google Trends job comparing keyword popularity on YouTube.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_trends/explore/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Google Trends Explore tasks
      effect: read
      questions:
      - Which Google Trends Explore tasks have completed and not been picked up?
      - Are my queued Google Trends jobs ready?
      instructions:
      - text: List completed, uncollected Google Trends Explore tasks.
      - text: Check which Google Trends jobs are ready to fetch.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_trends/explore/task_get/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get results of a Google Trends Explore task
      effect: read
      questions:
      - Where do I collect the trend graph data from a Google Trends task I queued?
      - Can I fetch Google Trends Explore output by task ID?
      instructions:
      - text: Fetch the Google Trends Explore results for task {id}.
        slots:
          id: path.id
      - text: Download keyword popularity over time from Google Trends task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/google_trends/explore/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get Google Trends keyword popularity live
      effect: read
      questions:
      - How popular is a keyword on Google Trends over time, returned immediately?
      - Can I compare keyword interest on Google News, Images or YouTube in a live call?
      instructions:
      - text: Get live Google Trends Explore data for these keywords.
      - text: Compare Google Trends popularity of two terms on YouTube right now.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/dataforseo_trends/locations'].get
  update:
    x-apievangelist-phrasing:
      intent: List locations for DataForSEO Trends
      effect: read
      questions:
      - Which locations does DataForSEO Trends support?
      - What location codes can I use for the in-house trends keyword popularity data?
      instructions:
      - text: List all locations supported by DataForSEO Trends.
      - text: Get the location list for the DataForSEO Trends endpoints.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/dataforseo_trends/locations/{country}'].get
  update:
    x-apievangelist-phrasing:
      intent: List DataForSEO Trends locations in a country
      effect: read
      questions:
      - Which DataForSEO Trends regions are available inside one country?
      - Can I limit the in-house trends location list to a single country?
      instructions:
      - text: List DataForSEO Trends locations within country {country}.
        slots:
          country: path.country
      - text: Show the DataForSEO Trends regions for {country}.
        slots:
          country: path.country
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/dataforseo_trends/explore/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get DataForSEO Trends keyword popularity over time
      effect: read
      questions:
      - Can I get keyword popularity over a time range from DataForSEO's own trends data?
      - What's the search interest trend line for a term on Google News or Shopping from the in-house trends source?
      instructions:
      - text: Get DataForSEO Trends popularity over time for these keywords.
      - text: Chart the in-house trends interest for a keyword across the last year.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/dataforseo_trends/subregion_interests/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get keyword popularity by subregion
      effect: read
      questions:
      - Which regions or states show the most interest in a keyword?
      - Can I break down trends keyword popularity by location inside a country?
      instructions:
      - text: Get keyword popularity by subregion from DataForSEO Trends.
      - text: Show which states search most for these terms.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/dataforseo_trends/demography/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get keyword popularity by age and gender
      effect: read
      questions:
      - What age groups and genders search most for a keyword?
      - Can I see the demographic breakdown of interest in a search term?
      instructions:
      - text: Get the age and gender breakdown of popularity for these keywords.
      - text: Show the demographic split of search interest for a term.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/dataforseo_trends/merged_data/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get combined trends, regional and demographic data
      effect: read
      questions:
      - Can I get keyword trend over time, regional interest and demographics in one call?
      - Is there a single request that merges all the trends views for my terms with comparative values?
      instructions:
      - text: Get merged trends data covering time, subregions and demographics for these keywords.
      - text: Pull the combined DataForSEO Trends report for two competing terms.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/locations'].get
  update:
    x-apievangelist-phrasing:
      intent: List locations for Bing keyword data
      effect: read
      questions:
      - Which locations are supported for Bing Ads keyword data?
      - What location codes can I use for Bing keyword research?
      instructions:
      - text: List all locations supported for Bing Ads keyword data.
      - text: Get Bing keyword data location codes.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/languages'].get
  update:
    x-apievangelist-phrasing:
      intent: List languages for Bing keyword data
      effect: read
      questions:
      - Which languages does Bing Ads keyword data support?
      - What language codes are valid for Bing keyword requests?
      instructions:
      - text: List the languages supported for Bing Ads keyword data.
      - text: Get Bing keyword data language codes.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/search_volume/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Bing search volume task
      effect: write
      questions:
      - Can I queue Bing search volume for my keywords and collect it later?
      - Is there a background job for Bing monthly search volume and 24-month trend?
      instructions:
      - text: Queue a Bing search volume task for these keywords.
      - text: Post a background job pulling Bing Ads search volume and CPC.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/search_volume/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Bing search volume tasks
      effect: read
      questions:
      - Which Bing search volume tasks are completed and still uncollected?
      - Are my queued Bing volume jobs ready?
      instructions:
      - text: List completed, uncollected Bing search volume tasks.
      - text: Check which Bing search volume jobs are ready to fetch.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/search_volume/task_get/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get results of a Bing search volume task
      effect: read
      questions:
      - Where do I collect Bing search volume results from a task I queued?
      - Can I fetch a Bing search volume task's output by its ID?
      instructions:
      - text: Fetch the Bing search volume results for task {id}.
        slots:
          id: path.id
      - text: Download Bing monthly searches and CPC from task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/search_volume/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get Bing search volume instantly
      effect: read
      questions:
      - What's the Bing search volume for my keywords right now?
      - Can I get Bing monthly volume plus up to 24 months of trend in one live request?
      instructions:
      - text: Get live Bing search volume for these keywords.
      - text: Look up Bing Ads monthly searches and CPC for my keywords now.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/audience_estimation/job_functions'].get
  update:
    x-apievangelist-phrasing:
      intent: List job functions for Bing audience estimates
      effect: read
      questions:
      - Which job functions can I target when estimating a Bing ad audience?
      - What job_function_id values does Bing audience estimation accept?
      instructions:
      - text: List the job functions available for Bing audience estimation.
      - text: Get job function IDs for Bing ad audience targeting.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/audience_estimation/industries'].get
  update:
    x-apievangelist-phrasing:
      intent: List industries for Bing audience estimates
      effect: read
      questions:
      - Which industries can I target in a Bing ad audience estimate?
      - What industry_id values are valid for Bing audience estimation?
      instructions:
      - text: List the industries available for Bing audience estimation.
      - text: Get industry IDs for Bing ad audience targeting.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/audience_estimation/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Bing audience size estimate
      effect: write
      questions:
      - Can I queue an estimate of how big my Bing ad campaign audience would be?
      - Is there a background job for Bing suggested bid and budget by targeting?
      instructions:
      - text: Queue a Bing audience estimation task for my targeting criteria.
      - text: Post a background job estimating Bing ad audience size for IT decision makers.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/audience_estimation/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Bing audience estimation tasks
      effect: read
      questions:
      - Which Bing audience estimation tasks are done and not yet collected?
      - Are my Bing audience size jobs ready?
      instructions:
      - text: List completed, uncollected Bing audience estimation tasks.
      - text: Check which Bing audience estimate jobs are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/audience_estimation/task_get/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get results of a Bing audience estimation task
      effect: read
      questions:
      - Where can I retrieve the audience size estimate from a Bing task I queued?
      - Can I fetch Bing audience estimation output by task ID?
      instructions:
      - text: Fetch the Bing audience estimate for task {id}.
        slots:
          id: path.id
      - text: Download estimated audience, bid and budget from task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/audience_estimation/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Estimate a Bing ad audience instantly
      effect: read
      questions:
      - How large would my Bing ad audience be for a given targeting, right now?
      - Can I get Bing's suggested bid, budget and engagement estimates in a live call?
      instructions:
      - text: Estimate the Bing ad audience size for my targeting now.
      - text: Get a live Bing suggested bid and budget for this campaign targeting.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/keywords_for_site/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Bing keywords-for-site task
      effect: write
      questions:
      - Can I queue a job to find Bing keyword ideas relevant to a website?
      - Is there a background way to get Bing site keywords with volume?
      instructions:
      - text: Queue a Bing keywords-for-site task for a target domain.
      - text: Post a background job pulling Bing keyword suggestions for a website.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/keywords_for_site/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Bing keywords-for-site tasks
      effect: read
      questions:
      - Which Bing keywords-for-site tasks are complete and uncollected?
      - Are my Bing website keyword jobs ready?
      instructions:
      - text: List completed, uncollected Bing keywords-for-site tasks.
      - text: Check which Bing site keyword jobs are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/keywords_for_site/task_get/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get results of a Bing keywords-for-site task
      effect: read
      questions:
      - Where do I collect Bing keyword ideas for a website from a queued task?
      - Can I fetch Bing site keyword results by task ID?
      instructions:
      - text: Fetch Bing keywords-for-site results for task {id}.
        slots:
          id: path.id
      - text: Download the Bing website keyword ideas from task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/keywords_for_site/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get Bing keyword ideas for a URL live
      effect: read
      questions:
      - What keywords does Bing Ads associate with a given URL, returned immediately?
      - Can I get Bing keyword suggestions for a page in one live call?
      instructions:
      - text: Get live Bing keyword suggestions for this URL.
      - text: Pull Bing keywords relevant to a website right now, with volume.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/keywords_for_keywords/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Bing keyword ideas task
      effect: write
      questions:
      - Can I queue up to 200 seed keywords for Bing keyword suggestions?
      - Is there a background job for expanding seed terms with Bing Ads ideas?
      instructions:
      - text: Queue a Bing keywords-for-keywords task for my seed terms.
      - text: Post a background job expanding seed keywords with Bing suggestions.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/keywords_for_keywords/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Bing keyword ideas tasks
      effect: read
      questions:
      - Which Bing seed-keyword expansion tasks are done but uncollected?
      - Are my Bing keywords-for-keywords jobs ready?
      instructions:
      - text: Show seed-term expansion jobs on Bing that finished but I have not downloaded.
      - text: Check which Bing seed keyword jobs are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/keywords_for_keywords/task_get/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get results of a Bing keyword ideas task
      effect: read
      questions:
      - Where do I pick up Bing related keyword ideas from a seed-keyword task?
      - Can I fetch Bing keywords-for-keywords output by task ID?
      instructions:
      - text: Fetch the Bing keyword ideas for seed-keyword task {id}.
        slots:
          id: path.id
      - text: Download related keywords Bing suggested in task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/keywords_for_keywords/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get Bing keyword ideas for seed terms live
      effect: read
      questions:
      - What related keywords does Bing Ads suggest for my seed terms right now?
      - Can I expand up to 200 seed keywords with Bing ideas in one live request?
      instructions:
      - text: Get live Bing keyword suggestions for these seed terms.
      - text: Expand my seed keywords into related Bing keywords now.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/keyword_performance/locations_and_languages'].get
  update:
    x-apievangelist-phrasing:
      intent: List locations and languages for Bing keyword performance
      effect: read
      questions:
      - Which locations and languages are supported for Bing keyword performance stats?
      - What location-language pairs work with the Bing keyword performance endpoints?
      instructions:
      - text: List locations and languages for Bing keyword performance.
      - text: Get the supported geo and language options for Bing keyword performance stats.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/keyword_performance/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Bing keyword performance task
      effect: write
      questions:
      - Can I queue a job for Bing ad position, clicks and impressions by match type?
      - Is there a background way to get last month's Bing keyword performance per device?
      instructions:
      - text: Queue a Bing keyword performance task for these keywords.
      - text: Post a background job for Bing keyword performance on mobile, exact match.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/keyword_performance/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Bing keyword performance tasks
      effect: read
      questions:
      - Which Bing keyword performance tasks are finished and uncollected?
      - Are my Bing keyword performance jobs ready?
      instructions:
      - text: List completed, uncollected Bing keyword performance tasks.
      - text: Check which Bing keyword performance jobs are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/keyword_performance/task_get/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get results of a Bing keyword performance task
      effect: read
      questions:
      - Where do I collect Bing keyword performance stats from a task I queued?
      - Can I fetch Bing ad position and click stats by task ID?
      instructions:
      - text: Fetch Bing keyword performance results for task {id}.
        slots:
          id: path.id
      - text: Download clicks, impressions and ad position from task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/keyword_performance/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get Bing keyword performance stats live
      effect: read
      questions:
      - What ad position, clicks and impressions did my keywords get on Bing last month?
      - Can I get Bing keyword performance by match type and device in real time?
      instructions:
      - text: Get live Bing keyword performance stats for these keywords.
      - text: Show last month's Bing clicks and impressions for my keywords on desktop.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/search_volume_history/locations_and_languages'].get
  update:
    x-apievangelist-phrasing:
      intent: List locations and languages for Bing volume history
      effect: read
      questions:
      - Which locations and languages work with Bing search volume history?
      - What geo-language combinations are supported for historical Bing volume?
      instructions:
      - text: List locations and languages for Bing search volume history.
      - text: Get supported options for the Bing historical volume endpoint.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/search_volume_history/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Bing search volume history task
      effect: write
      questions:
      - Can I queue historical Bing search volume for up to 1000 keywords?
      - Is there a background job for daily, weekly or monthly Bing volume history?
      instructions:
      - text: Queue a Bing search volume history task for my keywords.
      - text: Post a background job for weekly Bing volume history on mobile.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/search_volume_history/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Bing volume history tasks
      effect: read
      questions:
      - Which Bing search volume history tasks are done and uncollected?
      - Are my Bing historical volume jobs ready?
      instructions:
      - text: Show historical Bing volume jobs that finished but are still waiting for pickup.
      - text: Check which Bing volume history jobs are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/search_volume_history/task_get/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get results of a Bing volume history task
      effect: read
      questions:
      - Where can I retrieve historical Bing volume from a task I queued?
      - Can I fetch a Bing search volume history task by ID?
      instructions:
      - text: Fetch Bing search volume history for task {id}.
        slots:
          id: path.id
      - text: Download the historical Bing volume series from task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/bing/search_volume_history/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get Bing search volume history live
      effect: read
      questions:
      - How has Bing search volume for my keywords changed over time, day by day or week by week?
      - Can I get historical Bing volume for up to 1000 keywords in one live request?
      instructions:
      - text: Get a daily Bing volume time series for these keywords.
      - text: Show monthly Bing volume history for my keywords on desktop now.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/clickstream_data/locations_and_languages'].get
  update:
    x-apievangelist-phrasing:
      intent: List locations and languages for clickstream data
      effect: read
      questions:
      - Which locations and languages are supported for clickstream search volume?
      - What geo options exist for the clickstream keyword data?
      instructions:
      - text: List locations and languages for clickstream data.
      - text: Get the supported options for clickstream search volume.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/clickstream_data/dataforseo_search_volume/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get clickstream-adjusted search volume
      effect: read
      questions:
      - Can I get search volume for my keywords adjusted with clickstream data in one location?
      - What's DataForSEO's own clickstream-based search volume estimate for a keyword?
      instructions:
      - text: Get clickstream-adjusted search volume for these keywords.
      - text: Look up the in-house clickstream search volume for my keyword list in one market.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/clickstream_data/global_search_volume/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get global clickstream search volume by country
      effect: read
      questions:
      - Which countries contribute the most clickstream search volume for a keyword?
      - Can I see worldwide clickstream volume split by location for up to 1000 keywords?
      instructions:
      - text: Get global clickstream search volume with country distribution for these keywords.
      - text: Show where in the world my keywords get searched, using clickstream data.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/keywords_data/clickstream_data/bulk_search_volume/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get bulk clickstream volume with 12-month history
      effect: read
      questions:
      - Can I get clickstream search volume and up to 12 months of history for 1000 keywords at once?
      - What's the monthly clickstream volume trend for a large keyword list?
      instructions:
      - text: Get bulk clickstream search volume with monthly history for my keywords.
      - text: Pull 12 months of clickstream volume for this keyword list.
      method: generated
      generated: '2026-10-01'