# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for DataForSEO App Data API
  version: 1.0.0
extends: openapi/dataforseo-app-data-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: 42
- target: $.paths['/v3/app_data/id_list'].post
  update:
    x-apievangelist-phrasing:
      intent: List IDs of App Data tasks in a time period
      effect: read
      questions:
      - Can I get the IDs of every App Data task I created in a given time window?
      - Which app store tasks did I submit last week, including unfinished ones?
      instructions:
      - text: List the IDs and metadata of all App Data tasks I created this month.
      - text: Pull every App Data task ID from yesterday, completed or not.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/errors'].post
  update:
    x-apievangelist-phrasing:
      intent: List App Data tasks that failed recently
      effect: read
      questions:
      - Which of my App Data tasks returned an error in the past seven days?
      - Why did some of my app store data requests fail this week?
      instructions:
      - text: Show the App Data API tasks that errored in the last 7 days.
      - text: Get error details for my failed app store data tasks.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/google/categories'].get
  update:
    x-apievangelist-phrasing:
      intent: List Google Play app categories
      effect: read
      questions:
      - What app categories exist on Google Play for app data tasks?
      - Which Google Play category names can I use when collecting app data?
      instructions:
      - text: Get the full list of Google Play app categories.
      - text: Show every Google Play category supported for app data.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/google/locations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Google locations supported for app data
      effect: read
      questions:
      - Which Google Play locations can I target for app data tasks?
      - Where can I find location codes for Google Play app research?
      instructions:
      - text: List all Google locations supported in App Data.
      - text: Get every location code I can use for Google Play app tasks.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/google/locations/{country}'].get
  update:
    x-apievangelist-phrasing:
      intent: List Google Play app locations in one country
      effect: read
      questions:
      - Which Google Play app data locations are available within a single country?
      - Can I narrow the supported Google locations for app research to one country?
      instructions:
      - text: List Google app data locations in country {country}.
        slots:
          country: path.country
      - text: Get the Google Play location codes available for {country}.
        slots:
          country: path.country
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/google/languages'].get
  update:
    x-apievangelist-phrasing:
      intent: List Google languages supported for app data
      effect: read
      questions:
      - Which languages can I set when pulling Google Play app data?
      - What language codes are valid for Google Play app tasks?
      instructions:
      - text: List the Google languages supported in App Data.
      - text: Get the language codes I can use for Google Play app tasks.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/google/app_searches/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Google Play app keyword search
      effect: write
      questions:
      - Which apps rank on Google Play for a given keyword?
      - Can I track Google Play keyword rankings for a specific country and language?
      instructions:
      - text: Queue a Google Play search task to see which apps rank for my keyword.
      - text: Set a Google Play app search task for this keyword in the US in English.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/google/app_searches/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Google Play app search tasks
      effect: read
      questions:
      - Which of my Google Play app search tasks are done but not collected yet?
      - Are my Google Play keyword ranking tasks ready to fetch?
      instructions:
      - text: List completed Google Play app search tasks I haven't collected.
      - text: Check which Google Play keyword search tasks are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List all finished App Data tasks
      effect: read
      questions:
      - Which App Data tasks across all app endpoints are finished and waiting to be collected?
      - Is there one place to see every completed app store task I haven't retrieved?
      instructions:
      - text: List every completed App Data task, across Google Play and App Store, I haven't collected.
      - text: Show all ready app store tasks regardless of endpoint.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/google/app_searches/task_get/advanced/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get structured Google Play keyword search results
      effect: read
      questions:
      - What are the ranked apps, ratings and prices from my finished Google Play search task?
      - Can I get parsed Google Play search results with app IDs and review counts?
      instructions:
      - text: Fetch the structured Google Play search results for task {id}.
        slots:
          id: path.id
      - text: Get the ranked apps with ratings and prices from Google Play search task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/google/app_searches/task_get/html/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get raw HTML of a Google Play keyword search
      effect: read
      questions:
      - Can I download the raw HTML page of a Google Play search result I queued?
      - Is the unparsed HTML of a Google Play keyword search available?
      instructions:
      - text: Get the raw HTML for Google Play search task {id}.
        slots:
          id: path.id
      - text: Download the unparsed Google Play search page from task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/google/app_list/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Google Play top charts task
      effect: write
      questions:
      - Which apps are in the Google Play top charts right now?
      - Can I pull a specific Google Play top-chart collection for a given country?
      instructions:
      - text: Queue a task to collect the Google Play top free apps chart.
      - text: Set a Google Play top charts task for this app collection in Germany.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/google/app_list/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Google Play top charts tasks
      effect: read
      questions:
      - Which of my Google Play top chart tasks are ready to collect?
      - Have my Google Play chart collection tasks finished yet?
      instructions:
      - text: List completed Google Play top chart tasks I haven't retrieved.
      - text: Check which Google Play app list tasks are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/google/app_list/task_get/advanced/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get structured Google Play top charts results
      effect: read
      questions:
      - What apps, ratings and prices came back from my Google Play top charts task?
      - Can I get parsed Google Play chart positions with app IDs?
      instructions:
      - text: Fetch the structured Google Play top chart results for task {id}.
        slots:
          id: path.id
      - text: Get the chart-ranked apps from Google Play app list task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/google/app_list/task_get/html/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get raw HTML of a Google Play top chart
      effect: read
      questions:
      - Can I get the raw HTML of a Google Play top chart I collected?
      - Is the unparsed page for a Google Play app collection available?
      instructions:
      - text: Get the raw HTML for Google Play app list task {id}.
        slots:
          id: path.id
      - text: Download the unparsed Google Play chart page from task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/google/app_info/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Google Play app details task
      effect: write
      questions:
      - Can I get the full Google Play listing details for one app by its app ID?
      - How do I pull installs, rating and description for a specific Android app?
      instructions:
      - text: Queue a task to collect Google Play details for this app ID.
      - text: Set a Google Play app info task for the com.example.app package.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/google/app_info/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Google Play app info tasks
      effect: read
      questions:
      - Which Google Play app details tasks are done and waiting?
      - Are my Android app info lookups ready to collect?
      instructions:
      - text: List completed Google Play app info tasks I haven't collected.
      - text: Check which Google Play app detail tasks are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/google/app_info/task_get/advanced/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get structured Google Play app details
      effect: read
      questions:
      - What installs, rating, icon and description did my Google Play app info task return?
      - Can I get the parsed Google Play listing for an app I queued?
      instructions:
      - text: Fetch the structured Google Play app details for task {id}.
        slots:
          id: path.id
      - text: Get installs, rating and images from Google Play app info task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/google/app_info/task_get/html/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get raw HTML of a Google Play app page
      effect: read
      questions:
      - Can I get the raw HTML of a Google Play app listing page I requested?
      - Is the unparsed Google Play app details page available for my task?
      instructions:
      - text: Get the raw HTML of the Google Play app page from task {id}.
        slots:
          id: path.id
      - text: Download the unparsed Google Play app info page for task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/google/app_reviews/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Google Play app reviews task
      effect: write
      questions:
      - What are users saying in Google Play reviews of a particular app?
      - Can I collect Google Play reviews for an app in a specific language and location?
      instructions:
      - text: Queue a task to collect Google Play reviews for this app ID.
      - text: Set a Google Play reviews task for my Android app in English.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/google/app_reviews/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Google Play reviews tasks
      effect: read
      questions:
      - Which Google Play review collection tasks are finished?
      - Are my Android app review pulls ready to download?
      instructions:
      - text: List completed Google Play app review tasks I haven't collected.
      - text: Check which Google Play review tasks are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/google/app_reviews/task_get/advanced/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get structured Google Play app reviews
      effect: read
      questions:
      - What ratings, review text and reviewer details came back for my Google Play reviews task?
      - Can I get parsed Google Play reviews with publication dates?
      instructions:
      - text: Fetch the structured Google Play reviews for task {id}.
        slots:
          id: path.id
      - text: Get review ratings and text from Google Play reviews task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/google/app_reviews/task_get/html/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get raw HTML of Google Play app reviews
      effect: read
      questions:
      - Can I get the raw HTML of the Google Play reviews page I collected?
      - Is the unparsed Google Play reviews markup available for my task?
      instructions:
      - text: Get the raw HTML of Google Play reviews from task {id}.
        slots:
          id: path.id
      - text: Download the unparsed Google Play reviews page for task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/google/app_listings/categories'].get
  update:
    x-apievangelist-phrasing:
      intent: List Google Play categories for app listings search
      effect: read
      questions:
      - Which Google Play categories can I filter on in the app listings search?
      - What category values does the Google Play listings search accept?
      instructions:
      - text: Get the Google Play categories available for the app listings search.
      - text: Show the category filter values for searching Google Play listings.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/google/app_listings/search/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Search Google Play app listings by title or category
      effect: read
      questions:
      - Can I find Google Play apps whose title or description mentions a term?
      - Which Google Play apps are listed in a given category, with ratings and prices?
      instructions:
      - text: Search Google Play listings for apps with 'budget' in the title.
      - text: Find Google Play apps in the finance category with their ratings and review counts.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/apple/categories'].get
  update:
    x-apievangelist-phrasing:
      intent: List App Store app categories
      effect: read
      questions:
      - What app categories exist on the App Store for app data tasks?
      - Which App Store category names can I use when collecting iOS app data?
      instructions:
      - text: Get the full list of App Store app categories.
      - text: Show every App Store category supported for app data.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/apple/locations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Apple locations supported for app data
      effect: read
      questions:
      - Which App Store locations can I target for iOS app research?
      - Where can I find location codes for App Store tasks?
      instructions:
      - text: List all Apple locations supported in App Data.
      - text: Get the location codes I can use for App Store tasks.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/apple/languages'].get
  update:
    x-apievangelist-phrasing:
      intent: List Apple languages supported for app data
      effect: read
      questions:
      - Which languages can I set when pulling App Store data?
      - What language codes are valid for iOS app tasks?
      instructions:
      - text: List the Apple languages supported in App Data.
      - text: Get the language codes I can use for App Store tasks.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/apple/app_searches/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue an App Store app keyword search
      effect: write
      questions:
      - Which iOS apps rank on the App Store for a given keyword?
      - Can I track App Store keyword rankings in a particular country?
      instructions:
      - text: Queue an App Store search task to see which apps rank for my keyword.
      - text: Set an App Store app search task for this keyword in the UK.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/apple/app_searches/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished App Store app search tasks
      effect: read
      questions:
      - Which App Store keyword search tasks are done but not collected?
      - Are my iOS keyword ranking tasks ready to fetch?
      instructions:
      - text: List completed App Store app search tasks I haven't collected.
      - text: Check which App Store keyword search tasks are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/apple/app_searches/task_get/advanced/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get structured App Store keyword search results
      effect: read
      questions:
      - What are the ranked iOS apps, ratings and prices from my App Store search task?
      - Can I get parsed App Store search results with app IDs?
      instructions:
      - text: Fetch the structured App Store search results for task {id}.
        slots:
          id: path.id
      - text: Get the ranked iOS apps from App Store search task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/apple/app_info/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue an App Store app details task
      effect: write
      questions:
      - Can I get the full App Store listing details for one iOS app by its app ID?
      - How do I pull the rating, description and screenshots of an iPhone app?
      instructions:
      - text: Queue a task to collect App Store details for this app ID.
      - text: Set an App Store app info task for my iOS app.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/apple/app_info/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished App Store app info tasks
      effect: read
      questions:
      - Which App Store app details tasks are done and waiting?
      - Are my iOS app info lookups ready to collect?
      instructions:
      - text: List completed App Store app info tasks I haven't collected.
      - text: Check which App Store app detail tasks are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/apple/app_info/task_get/advanced/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get structured App Store app details
      effect: read
      questions:
      - What rating, icon, description and images did my App Store app info task return?
      - Can I get the parsed App Store listing for an iOS app I queued?
      instructions:
      - text: Fetch the structured App Store app details for task {id}.
        slots:
          id: path.id
      - text: Get the rating and description from App Store app info task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/apple/app_list/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue an App Store top charts task
      effect: write
      questions:
      - Which apps are in the App Store top charts right now?
      - Can I pull a specific App Store top-chart collection for a given country?
      instructions:
      - text: Queue a task to collect the App Store top paid apps chart.
      - text: Set an App Store top charts task for this collection in Japan.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/apple/app_list/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished App Store top charts tasks
      effect: read
      questions:
      - Which App Store top chart tasks are ready to collect?
      - Have my iOS chart collection tasks finished yet?
      instructions:
      - text: List completed App Store top chart tasks I haven't retrieved.
      - text: Check which App Store app list tasks are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/apple/app_list/task_get/advanced/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get structured App Store top charts results
      effect: read
      questions:
      - What apps, ratings and prices came back from my App Store top charts task?
      - Can I get parsed App Store chart positions with app IDs?
      instructions:
      - text: Fetch the structured App Store top chart results for task {id}.
        slots:
          id: path.id
      - text: Get the chart-ranked iOS apps from App Store app list task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/apple/app_reviews/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue an App Store app reviews task
      effect: write
      questions:
      - What are users saying in App Store reviews of a particular iOS app?
      - Can I collect App Store reviews for an app in a specific country and language?
      instructions:
      - text: Queue a task to collect App Store reviews for this app ID.
      - text: Set an App Store reviews task for my iPhone app in the US.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/apple/app_reviews/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished App Store reviews tasks
      effect: read
      questions:
      - Which App Store review collection tasks are finished?
      - Are my iOS app review pulls ready to download?
      instructions:
      - text: List completed App Store review tasks I haven't collected.
      - text: Check which App Store app review tasks are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/apple/app_reviews/task_get/advanced/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get structured App Store app reviews
      effect: read
      questions:
      - What ratings, review text and reviewer info came back for my App Store reviews task?
      - Can I get parsed iOS app reviews with publication dates?
      instructions:
      - text: Fetch the structured App Store reviews for task {id}.
        slots:
          id: path.id
      - text: Get review ratings and text from App Store reviews task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/apple/app_listings/categories'].get
  update:
    x-apievangelist-phrasing:
      intent: List App Store categories for app listings search
      effect: read
      questions:
      - Which App Store categories can I filter on in the app listings search?
      - What category values does the App Store listings search accept?
      instructions:
      - text: Get the App Store categories available for the app listings search.
      - text: Show the category filter values for searching App Store listings.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/app_data/apple/app_listings/search/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Search App Store app listings by title or category
      effect: read
      questions:
      - Can I find App Store apps whose title or description mentions a term?
      - Which iOS apps are listed in a given App Store category, with ratings and prices?
      instructions:
      - text: Search App Store listings for apps with 'meditation' in the description.
      - text: Find App Store apps in the health category with their ratings and review counts.
      method: generated
      generated: '2026-10-01'