# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Dataforseo Labs API
  version: 1.0.0
extends: openapi/dataforseo-dataforseolabs-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: 47
- target: $.paths['/v3/dataforseo_labs/id_list'].post
  update:
    x-apievangelist-phrasing:
      intent: List Labs task IDs for a time period
      effect: read
      questions:
      - Can I get the IDs of every DataForSEO Labs task I created within a date range?
      - Does the Labs task ID list include tasks that never completed?
      instructions:
      - text: List the IDs and metadata of all my Labs tasks created in the last week.
      - text: Pull the Labs task ID list, including unfinished tasks, for last month.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check when Labs data was last updated
      effect: read
      questions:
      - When was the Labs keyword database last refreshed for Google, Bing and Amazon?
      - How fresh is the Labs ranking data right now?
      instructions:
      - text: Tell me the last update dates of Labs data for Google, Bing and Amazon.
      - text: Check the Labs data freshness status.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/errors'].post
  update:
    x-apievangelist-phrasing:
      intent: List Labs tasks that failed recently
      effect: read
      questions:
      - Which of my Labs API tasks returned errors over the past 7 days?
      - Where can I see why a Labs request failed this week?
      instructions:
      - text: Show me the Labs tasks that errored in the last 7 days.
      - text: List recent Labs API task errors so I can debug them.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/available_filters'].get
  update:
    x-apievangelist-phrasing:
      intent: List filters usable in Labs endpoints
      effect: read
      questions:
      - What filter fields and operators can I use in Labs API requests?
      - Which Labs result fields can I filter on, like search volume or position?
      instructions:
      - text: Show the filters available for Labs API endpoints.
      - text: Get the list of Labs filter fields and their types.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/locations_and_languages'].get
  update:
    x-apievangelist-phrasing:
      intent: List locations and languages supported by Labs
      effect: read
      questions:
      - Which countries and languages does the Labs API support for Google, Bing and Amazon?
      - Are Amazon and Bing data in Labs limited to US English?
      instructions:
      - text: List every location and language supported by the Labs API.
      - text: Get the Labs location and language codes I can target.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/categories'].get
  update:
    x-apievangelist-phrasing:
      intent: List Google product and service categories
      effect: read
      questions:
      - What is the full list of Google product and service categories used in Labs?
      - Where do I find category codes to plug into category-based keyword research?
      instructions:
      - text: Fetch the full Google product and service category list.
      - text: Get all Labs category codes and names.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/available_history'].get
  update:
    x-apievangelist-phrasing:
      intent: List dates available for domain category metrics
      effect: read
      questions:
      - Which dates can I use as first_date and second_date when comparing domain metrics by category?
      - How far back does the historical snapshot list for domain metrics by categories go?
      instructions:
      - text: List the available history dates for the Google domain metrics by categories report.
      - text: Show which snapshot dates I can compare in domain metrics by categories.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/keywords_for_site/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Find keywords relevant to a website
      effect: read
      questions:
      - Can I get a list of keywords relevant to a domain with search volume and CPC?
      - What keywords fit my website's topic, along with 12-month search trends?
      instructions:
      - text: Find Google keywords relevant to my website's domain with volume, CPC and competition.
      - text: Generate keyword ideas based on a target site rather than a seed keyword.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/related_keywords/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get related searches for a keyword
      effect: read
      questions:
      - Which keywords show up in Google's 'searches related to' box for my seed term?
      - How many related keyword ideas can I pull by increasing the search depth?
      instructions:
      - text: Pull the 'searches related to' keywords for my seed keyword with their search volume.
      - text: Expand my seed term into related searches up to the maximum depth.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/keyword_suggestions/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get search queries containing a seed keyword
      effect: read
      questions:
      - What long-tail search queries include my exact seed keyword?
      - Can I list Google searches that contain a given phrase?
      instructions:
      - text: List keyword suggestions that contain my seed keyword.
      - text: Find long-tail queries that include the phrase I give you.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/keyword_ideas/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get keyword ideas from the same categories
      effect: read
      questions:
      - Can I find keywords in the same product categories as my seed keywords, even if they don't contain them?
      - What category-matched keyword ideas exist for a list of seed terms?
      instructions:
      - text: Generate keyword ideas from the product categories of my seed keywords.
      - text: Find category-related search terms for these seed keywords.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/bulk_keyword_difficulty/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Score keyword difficulty in bulk
      effect: read
      questions:
      - How hard is it to rank in Google's top 10 for each keyword on my list?
      - Can I get keyword difficulty scores for up to 1,000 keywords at once?
      instructions:
      - text: Get the keyword difficulty score from 0 to 100 for each keyword in my list.
      - text: Rate the ranking difficulty of these keywords in bulk.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/search_intent/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Classify the search intent of keywords
      effect: read
      questions:
      - Is a keyword informational, navigational, commercial or transactional?
      - Can I see intent probabilities, including secondary intents, for up to 1,000 keywords?
      instructions:
      - text: Classify the search intent of each keyword in my list with its probability.
      - text: Tell me the main and secondary search intents for these keywords.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/categories_for_keywords/languages'].get
  update:
    x-apievangelist-phrasing:
      intent: List languages for categories-for-keywords
      effect: read
      questions:
      - Which languages are supported when mapping keywords to Google categories?
      - Can I categorize keywords that aren't in English?
      instructions:
      - text: List the languages supported by the categories for keywords endpoint.
      - text: Show which languages keyword categorization works in.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/categories_for_domain/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Find the categories a domain ranks in
      effect: read
      questions:
      - Which Google product or service categories does a domain rank for?
      - How much traffic does a site get from each category of keywords?
      instructions:
      - text: Break down my domain's rankings and traffic by Google product category.
      - text: Show the categories a competitor's domain ranks in.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/categories_for_keywords/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Map keywords to Google categories
      effect: read
      questions:
      - Which Google product categories does each of my keywords belong to?
      - Can I categorize up to 1,000 keywords in one request?
      instructions:
      - text: Assign Google product and service categories to each keyword in my list.
      - text: Categorize these keywords by Google category.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/keywords_for_categories/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Find keywords for product categories
      effect: read
      questions:
      - What keywords belong to a given Google product category?
      - Can I get search volume and CPC for keywords in specific categories?
      instructions:
      - text: List keywords for the product categories I specify, with volume and CPC.
      - text: Find keywords people search for within these category codes.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/domain_metrics_by_categories/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Compare domain metrics within categories
      effect: read
      questions:
      - Which domains gained or lost visibility in a product category between two dates?
      - Can I see estimated traffic value and paid traffic cost for domains in my category?
      instructions:
      - text: Show how domain metrics changed in my product categories between two dates.
      - text: Rank domains in these categories by estimated traffic value over time.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/top_searches/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Browse the top searches keyword database
      effect: read
      questions:
      - Can I browse billions of keywords from the keyword database without a seed term?
      - What are the top Google searches with Ads metrics and SERP data?
      instructions:
      - text: Pull top searches from the keyword database for my location and language.
      - text: Browse the top searches list filtered by search volume.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/ranked_keywords/live'].post
  update:
    x-apievangelist-phrasing:
      intent: List keywords a domain or page ranks for
      effect: read
      questions:
      - What keywords does a website or specific page currently rank for on Google?
      - Can I see a competitor's ranking positions along with monthly searches?
      instructions:
      - text: List every Google keyword my domain ranks for with its position.
      - text: Show the ranked keywords for this specific webpage.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/serp_competitors/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Find domains ranking for given keywords
      effect: read
      questions:
      - Which domains rank for the set of keywords I care about?
      - Who has the most visibility and estimated traffic across my keyword list?
      instructions:
      - text: Find the domains that rank for these keywords and their visibility.
      - text: Identify SERP competitors for my keyword list.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/competitors_domain/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Find competitor domains for a domain
      effect: read
      questions:
      - Who are my domain's organic and paid search competitors?
      - Can I see ranking and traffic data for the domains that compete with my site?
      instructions:
      - text: List competitor domains for my site with their ranking and traffic overview.
      - text: Find which domains compete with my domain in the same SERPs.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/domain_intersection/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Find keywords two domains both rank for
      effect: read
      questions:
      - Which keywords do two domains both rank for in the same Google results?
      - Can a keyword overlap check between two sites include featured snippets and local pack?
      instructions:
      - text: Show the keywords where my domain and a competitor domain both rank.
      - text: Compare two domains for intersecting keywords with volume and CPC.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/subdomains/live'].post
  update:
    x-apievangelist-phrasing:
      intent: List a domain's subdomains with rankings
      effect: read
      questions:
      - Which subdomains of a site get the most search traffic?
      - Can I see organic and paid ranking distribution per subdomain?
      instructions:
      - text: List the subdomains of my domain with their ranking distribution.
      - text: Estimate search traffic for each subdomain of a site.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/relevant_pages/live'].post
  update:
    x-apievangelist-phrasing:
      intent: List a domain's pages with ranking data
      effect: read
      questions:
      - Which pages on a domain are the most relevant in Google search?
      - Can I get ranking metrics broken down by page for a site?
      instructions:
      - text: List the relevant pages of my domain with their Google ranking metrics.
      - text: Show which pages on a competitor's site drive their rankings.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/domain_rank_overview/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a domain's current ranking overview
      effect: read
      questions:
      - How much estimated monthly organic and paid traffic does a domain get today?
      - What does a domain's current ranking distribution across SERP positions look like?
      instructions:
      - text: Give me the current organic and paid rank overview for my domain.
      - text: Summarize a domain's position distribution and estimated monthly traffic.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/historical_serps/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get historical Google SERPs for a keyword
      effect: read
      questions:
      - What did the Google results page look like for a keyword in past months?
      - Can I see when featured snippets appeared for a keyword over time?
      instructions:
      - text: Pull historical Google SERPs for my keyword over the last year.
      - text: Show how rankings for a keyword changed across past SERP snapshots.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/historical_rank_overview/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a domain's historical ranking trend
      effect: read
      questions:
      - How has a domain's ranking distribution and traffic changed month by month?
      - Can I chart a site's historical organic versus paid traffic estimates?
      instructions:
      - text: Show the month-by-month historical rank overview for my domain.
      - text: Chart a domain's historical ranking distribution and estimated traffic.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/page_intersection/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Find keywords several pages rank for together
      effect: read
      questions:
      - Which keywords do specific URLs rank for in the same SERP?
      - Can I compare individual pages, not whole domains, for keyword overlap?
      instructions:
      - text: Find the keywords where these specific pages rank together.
      - text: Compare my page and a competitor's page for shared ranking keywords.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/bulk_traffic_estimation/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Estimate current traffic for many domains
      effect: read
      questions:
      - Can I estimate monthly search traffic for up to 1,000 domains, subdomains or pages at once?
      - Does the bulk traffic estimate split out paid, featured snippet and local pack traffic?
      instructions:
      - text: Estimate current monthly search traffic for this list of domains.
      - text: Get bulk traffic estimates for these URLs and subdomains.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/historical_bulk_traffic_estimation/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get historical traffic for many domains
      effect: read
      questions:
      - What were the monthly traffic estimates for a list of domains going back to 2020?
      - If I leave out the date range, how many months of historical traffic do I get?
      instructions:
      - text: Get historical monthly traffic for these domains over the past 12 months.
      - text: Pull month-by-month traffic history for up to 1,000 domains.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/historical_keyword_data/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get historical metrics for keywords
      effect: read
      questions:
      - How has search volume and CPC for my keywords changed since 2021?
      - Can I get month-by-month historical keyword data for a location and language?
      instructions:
      - text: Pull historical search volume and CPC for these keywords.
      - text: Show the historical monthly search trend for my keyword list.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/keyword_overview/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a current overview of keywords
      effect: read
      questions:
      - What are the current search volume, CPC, intent and SERP data for a keyword?
      - Can a keyword overview include clickstream search volume?
      instructions:
      - text: Give me a keyword overview with volume, CPC, intent and backlink info.
      - text: Get the current keyword overview including clickstream data.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/amazon/bulk_search_volume/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get Amazon search volume for keywords
      effect: read
      questions:
      - How many people search Amazon each month for my product keywords?
      - Can I check Amazon search volume for 1,000 keywords in one request?
      instructions:
      - text: Get monthly Amazon search volume for this keyword list.
      - text: Check Amazon search demand for my product terms in bulk.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/amazon/related_keywords/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get Amazon related searches for a keyword
      effect: read
      questions:
      - Which keywords appear in Amazon's 'Related Searches' section for my term?
      - What related product searches do Amazon shoppers see?
      instructions:
      - text: List Amazon related searches for my seed keyword.
      - text: Expand a product keyword using Amazon's related searches.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/amazon/ranked_keywords/live'].post
  update:
    x-apievangelist-phrasing:
      intent: List keywords an Amazon product ranks for
      effect: read
      questions:
      - What keywords does a specific Amazon product (ASIN) rank for?
      - Can I see a listing's ranking keywords on Amazon search?
      instructions:
      - text: List the Amazon keywords my product ASIN ranks for.
      - text: Show ranking keywords for a competitor's Amazon listing.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/amazon/product_rank_overview/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get Amazon ranking overview for products
      effect: read
      questions:
      - How do my ASINs rank across organic and paid Amazon results overall?
      - Can I get a ranking summary for several Amazon products at once?
      instructions:
      - text: Give me the organic and paid Amazon rank overview for these ASINs.
      - text: Summarize Amazon search ranking distribution for my products.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/amazon/product_competitors/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Find competing Amazon products
      effect: read
      questions:
      - Which Amazon products compete with my listing in search results?
      - Who shows up alongside my ASIN for the same Amazon searches?
      instructions:
      - text: Find Amazon product competitors for my ASIN.
      - text: List listings that intersect with this product in Amazon search.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/amazon/product_keyword_intersections/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Find keywords Amazon products share
      effect: read
      questions:
      - Which Amazon search keywords do two or more of my target ASINs both rank for?
      - Can I see keyword overlap between competing Amazon products?
      instructions:
      - text: Show the Amazon keywords these ASINs rank for together.
      - text: Compare two Amazon products for shared ranking keywords.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/bulk_app_metrics/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get ranking metrics for Google Play apps
      effect: read
      questions:
      - Can I get ranking metrics for up to 1,000 Google Play apps in one request?
      - How visible are a batch of Android apps in Google Play search?
      instructions:
      - text: Get bulk ranking metrics for these Google Play app IDs.
      - text: Compare Google Play search metrics for my list of Android apps.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/keywords_for_app/live'].post
  update:
    x-apievangelist-phrasing:
      intent: List keywords a Google Play app ranks for
      effect: read
      questions:
      - What keywords does my Android app rank for in Google Play?
      - Can I see an app's Google Play ranking position for each keyword?
      instructions:
      - text: List the Google Play keywords my app ranks for with positions.
      - text: Show Google Play search keywords for a competitor's Android app.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/app_competitors/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Find competing apps on Google Play
      effect: read
      questions:
      - Which Google Play apps compete with mine for the same keywords?
      - Can I get competitor app IDs with their Google Play ranking data?
      instructions:
      - text: Find Google Play apps that compete with my app for keywords.
      - text: List Android app competitors and their shared ranking keywords.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/google/app_intersection/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Find keywords Google Play apps share
      effect: read
      questions:
      - Which Google Play search keywords do several apps all rank for?
      - Can I compare keyword overlap between specific Android app IDs?
      instructions:
      - text: Show keywords where these Google Play apps rank in the same results.
      - text: Compare my Android app and a rival app for shared Google Play keywords.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/apple/bulk_app_metrics/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get ranking metrics for App Store apps
      effect: read
      questions:
      - Can I get ranking metrics for up to 1,000 App Store apps at once?
      - How visible are a batch of iOS apps in App Store search?
      instructions:
      - text: Get bulk ranking metrics for these App Store app IDs.
      - text: Compare App Store search metrics for my list of iOS apps.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/apple/keywords_for_app/live'].post
  update:
    x-apievangelist-phrasing:
      intent: List keywords an App Store app ranks for
      effect: read
      questions:
      - What keywords does my iOS app rank for in the App Store?
      - Can I see an app's App Store ranking position for each keyword?
      instructions:
      - text: List the App Store keywords my iOS app ranks for with positions.
      - text: Show App Store search keywords for a competitor's iPhone app.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/apple/app_competitors/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Find competing apps on the App Store
      effect: read
      questions:
      - Which App Store apps compete with my iOS app for the same keywords?
      - Can I get competitor App Store app IDs with their ranking data?
      instructions:
      - text: Find App Store apps that compete with my iOS app for keywords.
      - text: List iPhone app competitors and their shared App Store keywords.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/dataforseo_labs/apple/app_intersection/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Find keywords App Store apps share
      effect: read
      questions:
      - Which App Store search keywords do several iOS apps all rank for?
      - Can I compare keyword overlap between specific App Store app IDs?
      instructions:
      - text: Show keywords where these App Store apps rank in the same results.
      - text: Compare my iOS app and a rival app for shared App Store keywords.
      method: generated
      generated: '2026-10-01'