# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for DataForSEO Business Data API
  version: 1.0.0
extends: openapi/dataforseo-businessdata-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: 55
- target: $.paths['/v3/business_data/id_list'].post
  update:
    x-apievangelist-phrasing:
      intent: List IDs of Business Data tasks in a time period
      effect: read
      questions:
      - Can I get the IDs of every Business Data task I created in a given time window?
      - Which business reviews and listings tasks did I submit last week, including unfinished ones?
      instructions:
      - text: List the IDs and metadata of all Business Data tasks I created this month.
      - text: Pull every Business Data task ID from yesterday, completed or not.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/errors'].post
  update:
    x-apievangelist-phrasing:
      intent: List Business Data tasks that failed recently
      effect: read
      questions:
      - Which of my Business Data tasks returned an error in the past seven days?
      - Why did some of my business reviews requests fail this week?
      instructions:
      - text: Show the Business Data API tasks that errored in the last 7 days.
      - text: Get error details for my failed business data tasks.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/business_listings/locations'].get
  update:
    x-apievangelist-phrasing:
      intent: List locations for the Business Listings search
      effect: read
      questions:
      - Which locations can I search in the Google Maps business listings database?
      - Is there a downloadable list of locations supported by Business Listings?
      instructions:
      - text: List the locations supported by the Business Listings search.
      - text: Get the location codes I can use to search business listings.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/business_listings/categories'].get
  update:
    x-apievangelist-phrasing:
      intent: List top business categories by business count
      effect: read
      questions:
      - What are the most common business categories in the listings database?
      - Which categories have the most businesses listed?
      instructions:
      - text: Get the top business listing categories ranked by business count.
      - text: Show which categories I can use when searching business listings.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/business_listings/available_filters'].get
  update:
    x-apievangelist-phrasing:
      intent: List filters usable in Business Listings search
      effect: read
      questions:
      - What fields can I filter on when searching business listings?
      - Can I filter Google Maps listings by rating or other attributes?
      instructions:
      - text: Get the filters supported by the Business Listings endpoints.
      - text: Show which business listing fields I can use in filter expressions.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/business_listings/search/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Search Google Maps business listings by category
      effect: read
      questions:
      - Which businesses are listed on Google Maps in a given category near a location?
      - Can I get addresses, contacts, ratings and opening hours for all plumbers in a city?
      instructions:
      - text: Search business listings for dentists in Chicago with their ratings and contacts.
      - text: Find Google Maps listed coffee shops in this location with working hours.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/business_listings/categories_aggregation/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Count businesses per group of related categories
      effect: read
      questions:
      - How many businesses fall into each group of related categories in an area?
      - Which related category clusters have the most entities in a location?
      instructions:
      - text: Aggregate business listing counts by related category groups for this city.
      - text: Show grouped category totals of listed businesses in my target area.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/locations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Google locations for business data tasks
      effect: read
      questions:
      - Which Google locations can I target for business profile and review tasks?
      - Where do I find location codes for Google business data?
      instructions:
      - text: List all Google locations supported for business data tasks.
      - text: Get every location code available for Google business tasks.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/locations/{country}'].get
  update:
    x-apievangelist-phrasing:
      intent: List Google business data locations in one country
      effect: read
      questions:
      - Which Google business data locations exist within a single country?
      - Can I narrow Google business location codes to one country?
      instructions:
      - text: List Google business data locations in country {country}.
        slots:
          country: path.country
      - text: Get the Google business location codes for {country}.
        slots:
          country: path.country
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/languages'].get
  update:
    x-apievangelist-phrasing:
      intent: List Google languages for business data tasks
      effect: read
      questions:
      - Which languages can I set when pulling Google business data?
      - What language codes are valid for Google reviews and business profile tasks?
      instructions:
      - text: List the Google languages supported for business data.
      - text: Get language codes for Google business profile tasks.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/my_business_info/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Google business profile lookup
      effect: write
      questions:
      - Can I collect the Google Business Profile details of a specific business in the background?
      - What is the queued way to fetch a company's Google business listing info?
      instructions:
      - text: Queue a task to collect the Google business profile for this business.
      - text: Set a Google My Business info task for my store in English.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/my_business_info/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Google business profile tasks
      effect: read
      questions:
      - Which of my Google business profile info tasks are ready to collect?
      - Have my queued Google My Business info lookups finished?
      instructions:
      - text: List completed Google My Business info tasks I haven't collected.
      - text: Check which Google business profile tasks are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List all finished Business Data tasks
      effect: read
      questions:
      - Which Business Data tasks across every endpoint are finished and uncollected?
      - Is there one place to see all completed review and business tasks I haven't retrieved?
      instructions:
      - text: List every completed Business Data task, across all sources, I haven't collected.
      - text: Show all ready business data tasks regardless of endpoint.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/my_business_info/task_get/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get results of a Google business profile task
      effect: read
      questions:
      - What Google business profile details came back from my queued task?
      - Can I retrieve the business info result for a task I already set?
      instructions:
      - text: Fetch the Google business profile results for task {id}.
        slots:
          id: path.id
      - text: Get the My Business info for completed task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/my_business_info/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Look up a Google business profile instantly
      effect: read
      questions:
      - Can I get a business's Google profile details in real time without queuing a task?
      - What does Google show for a specific business entity right now?
      instructions:
      - text: Look up the Google business profile for this business live.
      - text: Get real-time Google My Business info for my restaurant.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/my_business_updates/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a task for a business's latest Google updates
      effect: write
      questions:
      - What are the latest posts and updates a business published on its Google profile?
      - Can I monitor the Google business updates of a competitor?
      instructions:
      - text: Queue a task to collect the latest Google updates for this business.
      - text: Set a Google My Business updates task for my competitor's listing.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/my_business_updates/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Google business updates tasks
      effect: read
      questions:
      - Which Google business updates tasks are done and waiting?
      - Are my queued business post updates ready to collect?
      instructions:
      - text: List completed Google My Business updates tasks I haven't collected.
      - text: Check which business updates tasks are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/my_business_updates/task_get/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get results of a Google business updates task
      effect: read
      questions:
      - What updates came back from my Google business updates task?
      - Can I retrieve a business's recent Google posts from a task I already set?
      instructions:
      - text: Fetch the Google business updates for task {id}.
        slots:
          id: path.id
      - text: Get the recent business posts from updates task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/hotel_searches/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Google hotel search task
      effect: write
      questions:
      - Which hotels does Google list for a keyword in a destination?
      - Can I collect Google hotel search results for a city in the background?
      instructions:
      - text: Queue a Google hotel search task for hotels in Lisbon.
      - text: Set a hotel searches task for this keyword and location.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/hotel_searches/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Google hotel search tasks
      effect: read
      questions:
      - Which of my Google hotel search tasks are ready?
      - Have my queued hotel searches finished?
      instructions:
      - text: List completed Google hotel search tasks I haven't collected.
      - text: Check which hotel searches tasks are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/hotel_searches/task_get/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get results of a Google hotel search task
      effect: read
      questions:
      - What hotels came back from my queued Google hotel search?
      - Can I retrieve the hotel list for a search task I already set?
      instructions:
      - text: Fetch the hotel search results for task {id}.
        slots:
          id: path.id
      - text: Get the list of hotels from Google hotel searches task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/hotel_searches/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Search Google Hotels in real time
      effect: read
      questions:
      - Can I see which hotels Google Hotels lists for a location right now?
      - Is there a live hotel search that returns results immediately?
      instructions:
      - text: Search Google Hotels live for hotels in Barcelona.
      - text: Run a real-time Google hotel search for this location and language.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/hotel_info/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Google hotel details task
      effect: write
      questions:
      - Can I collect amenities, prices, ratings and reviews for one hotel on Google Hotels?
      - What is the queued way to fetch detailed info about a specific hotel?
      instructions:
      - text: Queue a task to collect Google Hotels details for this hotel.
      - text: Set a hotel info task to get amenities and prices for my property.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/hotel_info/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Google hotel details tasks
      effect: read
      questions:
      - Which of my hotel details tasks are ready to collect?
      - Have my queued Google hotel info tasks finished?
      instructions:
      - text: List completed Google hotel info tasks I haven't collected.
      - text: Check which hotel details tasks are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/hotel_info/task_get/advanced/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get structured hotel details from a task
      effect: read
      questions:
      - What structured amenities, prices and ratings did my hotel info task return?
      - Can I get parsed Google Hotels data for a hotel I queued?
      instructions:
      - text: Fetch the structured hotel details for task {id}.
        slots:
          id: path.id
      - text: Get parsed amenities and prices from hotel info task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/hotel_info/task_get/html/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get raw HTML hotel details from a task
      effect: read
      questions:
      - Can I get the raw HTML of the Google Hotels page from my hotel info task?
      - Is the unparsed hotel details markup available for a queued task?
      instructions:
      - text: Get the raw HTML hotel details for task {id}.
        slots:
          id: path.id
      - text: Download the unparsed Google Hotels page from hotel info task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/hotel_info/live/advanced'].post
  update:
    x-apievangelist-phrasing:
      intent: Get structured hotel details in real time
      effect: read
      questions:
      - Can I get a hotel's amenities, prices and reviews from Google Hotels instantly?
      - Is there a live endpoint for parsed hotel details?
      instructions:
      - text: Get structured Google Hotels details for this hotel live.
      - text: Pull parsed amenities, rating and prices for my hotel in real time.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/hotel_info/live/html'].post
  update:
    x-apievangelist-phrasing:
      intent: Get raw HTML hotel details in real time
      effect: read
      questions:
      - Can I fetch the unparsed HTML of a hotel's Google Hotels page instantly?
      - Is there a live way to get raw hotel page markup?
      instructions:
      - text: Get the raw HTML of this hotel's Google Hotels page live.
      - text: Fetch unparsed hotel details HTML in real time.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/reviews/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Google reviews task for a business
      effect: write
      questions:
      - What are customers saying about a business in its Google reviews?
      - How do I collect Google user reviews for a local business in a specific language?
      instructions:
      - text: Queue a task to collect Google reviews for this local business.
      - text: Set a Google reviews task for my restaurant in English.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/reviews/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Google reviews tasks
      effect: read
      questions:
      - Which Google reviews tasks are ready to collect?
      - Have my queued Google review pulls finished?
      instructions:
      - text: List completed Google reviews tasks I haven't collected.
      - text: Check which Google review tasks are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/reviews/task_get/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Google reviews collected by a task
      effect: read
      questions:
      - What Google reviews came back for the business in my task?
      - Can I retrieve the review results for a Google reviews task I already set?
      instructions:
      - text: Fetch the Google reviews for task {id}.
        slots:
          id: path.id
      - text: Get the business reviews collected by Google reviews task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/extended_reviews/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a multi-source reviews task for a business
      effect: write
      questions:
      - Can I get a business's reviews from other review sites shown in Google, not just Google users?
      - Which task collects reviews aggregated from multiple sources in the Google reviews panel?
      instructions:
      - text: Queue an extended reviews task to collect multi-source reviews for this business.
      - text: Set an extended reviews task covering all review sources for my hotel.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/extended_reviews/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished extended reviews tasks
      effect: read
      questions:
      - Which extended multi-source reviews tasks are ready?
      - Have my queued extended review pulls finished?
      instructions:
      - text: List completed extended reviews tasks I haven't collected.
      - text: Check which multi-source review tasks are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/extended_reviews/task_get/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get multi-source reviews collected by a task
      effect: read
      questions:
      - What reviews from all sources came back in my extended reviews task?
      - Can I retrieve the aggregated multi-source reviews for a business I queued?
      instructions:
      - text: Fetch the extended reviews for task {id}.
        slots:
          id: path.id
      - text: Get the multi-source reviews collected by extended reviews task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/questions_and_answers/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Google Q&A task for a business
      effect: write
      questions:
      - What questions have people asked about a business on its Google profile?
      - Can I collect a business's Google questions and answers in the background?
      - How is a Google Q&A task billed when a business has many questions?
      instructions:
      - text: Queue a task to collect Google questions and answers for this business.
      - text: Set a Q&A task for my clinic's Google listing.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/questions_and_answers/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Google Q&A tasks
      effect: read
      questions:
      - Which Google questions and answers tasks are ready?
      - Have my queued business Q&A pulls finished?
      instructions:
      - text: List completed Google Q&A tasks I haven't collected.
      - text: Check which questions and answers tasks are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/questions_and_answers/task_get/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Google Q&A collected by a task
      effect: read
      questions:
      - What questions and answers came back from my Google Q&A task?
      - Can I retrieve a business's Q&A for a task I already set?
      instructions:
      - text: Fetch the Google questions and answers for task {id}.
        slots:
          id: path.id
      - text: Get the Q&A collected by task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/google/questions_and_answers/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a business's Google Q&A in real time
      effect: read
      questions:
      - Can I see the questions and answers on a business's Google profile right now?
      - Is there a live way to pull Google Q&A without waiting for a task?
      instructions:
      - text: Pull the Google questions and answers for this business live.
      - text: Get real-time Q&A from my store's Google listing.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/trustpilot/search/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Trustpilot business search
      effect: write
      questions:
      - Which Trustpilot business profiles match a keyword?
      - Can I search Trustpilot for companies in my niche?
      instructions:
      - text: Queue a Trustpilot search task for businesses matching 'web hosting'.
      - text: Set a Trustpilot business search for this keyword.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/trustpilot/search/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Trustpilot search tasks
      effect: read
      questions:
      - Which Trustpilot search tasks are ready to collect?
      - Have my queued Trustpilot business searches finished?
      instructions:
      - text: List completed Trustpilot search tasks I haven't collected.
      - text: Check which Trustpilot business search tasks are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/trustpilot/search/task_get/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Trustpilot business search results
      effect: read
      questions:
      - What Trustpilot business profiles came back from my search task?
      - Can I retrieve the companies found by a Trustpilot search I queued?
      instructions:
      - text: Fetch the Trustpilot search results for task {id}.
        slots:
          id: path.id
      - text: Get the business profiles found by Trustpilot search task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/trustpilot/reviews/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Trustpilot reviews task for a domain
      effect: write
      questions:
      - What are customers saying about a company on Trustpilot?
      - Can I collect Trustpilot reviews for a business by its domain?
      instructions:
      - text: Queue a task to collect Trustpilot reviews for example.com.
      - text: Set a Trustpilot reviews task for my company's domain.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/trustpilot/reviews/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Trustpilot reviews tasks
      effect: read
      questions:
      - Which Trustpilot reviews tasks are ready?
      - Have my queued Trustpilot review pulls finished?
      instructions:
      - text: List completed Trustpilot reviews tasks I haven't collected.
      - text: Check which Trustpilot review tasks are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/trustpilot/reviews/task_get/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Trustpilot reviews collected by a task
      effect: read
      questions:
      - What Trustpilot reviews came back for the company in my task?
      - Can I retrieve the Trustpilot review results for a task I already set?
      instructions:
      - text: Fetch the Trustpilot reviews for task {id}.
        slots:
          id: path.id
      - text: Get the reviews collected by Trustpilot reviews task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/tripadvisor/locations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Tripadvisor locations
      effect: read
      questions:
      - Which cities and regions can I target in Tripadvisor tasks?
      - Where do I find location codes for Tripadvisor searches?
      instructions:
      - text: List all locations supported for Tripadvisor tasks.
      - text: Get every Tripadvisor city and region location code.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/tripadvisor/locations/{country}'].get
  update:
    x-apievangelist-phrasing:
      intent: List Tripadvisor locations in one country
      effect: read
      questions:
      - Which Tripadvisor cities and regions are available in a single country?
      - Can I narrow Tripadvisor location codes to one country?
      instructions:
      - text: List Tripadvisor locations in country {country}.
        slots:
          country: path.country
      - text: Get the Tripadvisor city and region codes for {country}.
        slots:
          country: path.country
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/tripadvisor/languages'].get
  update:
    x-apievangelist-phrasing:
      intent: List Tripadvisor languages
      effect: read
      questions:
      - Which languages can I use in Tripadvisor tasks?
      - What language codes are valid for Tripadvisor reviews?
      instructions:
      - text: List the languages supported for Tripadvisor tasks.
      - text: Get the Tripadvisor language codes.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/tripadvisor/search/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Tripadvisor business search
      effect: write
      questions:
      - Which restaurants or attractions does Tripadvisor list for a keyword in a city?
      - Can I search Tripadvisor business profiles by keyword and location?
      instructions:
      - text: Queue a Tripadvisor search task for Italian restaurants in Rome.
      - text: Set a Tripadvisor business search for this keyword and city.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/tripadvisor/search/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Tripadvisor search tasks
      effect: read
      questions:
      - Which Tripadvisor search tasks are ready to collect?
      - Have my queued Tripadvisor business searches finished?
      instructions:
      - text: List completed Tripadvisor search tasks I haven't collected.
      - text: Check which Tripadvisor business search tasks are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/tripadvisor/search/task_get/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Tripadvisor business search results
      effect: read
      questions:
      - What businesses came back from my Tripadvisor search task?
      - Can I retrieve the Tripadvisor listings found by a search I queued?
      instructions:
      - text: Fetch the Tripadvisor search results for task {id}.
        slots:
          id: path.id
      - text: Get the businesses found by Tripadvisor search task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/tripadvisor/reviews/task_post'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue a Tripadvisor reviews task
      effect: write
      questions:
      - What are travelers saying about a hotel or restaurant on Tripadvisor?
      - Can I collect Tripadvisor reviews by URL path or keyword?
      instructions:
      - text: Queue a task to collect Tripadvisor reviews for this hotel's page.
      - text: Set a Tripadvisor reviews task for my restaurant.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/tripadvisor/reviews/tasks_ready'].get
  update:
    x-apievangelist-phrasing:
      intent: List finished Tripadvisor reviews tasks
      effect: read
      questions:
      - Which Tripadvisor reviews tasks are ready?
      - Have my queued Tripadvisor review pulls finished?
      instructions:
      - text: List completed Tripadvisor reviews tasks I haven't collected.
      - text: Check which Tripadvisor review tasks are ready.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/tripadvisor/reviews/task_get/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Tripadvisor reviews collected by a task
      effect: read
      questions:
      - What ratings and review text came back from my Tripadvisor reviews task?
      - Can I retrieve Tripadvisor review results for a task I already set?
      instructions:
      - text: Fetch the Tripadvisor reviews for task {id}.
        slots:
          id: path.id
      - text: Get the ratings and reviews collected by Tripadvisor task {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/social_media/pinterest/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Count Pinterest saves for page URLs
      effect: read
      questions:
      - How many times has my page been saved to Pinterest?
      - Can I check Pinterest pin counts for a list of URLs?
      instructions:
      - text: Get the Pinterest save counts for these page URLs.
      - text: Check how many pins my blog post has on Pinterest.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/business_data/social_media/reddit/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Find Reddit shares of a webpage
      effect: read
      questions:
      - Where has my webpage been shared on Reddit and by whom?
      - Which subreddits posted a link to a URL and how many members do they have?
      instructions:
      - text: Find the Reddit shares of this webpage with subreddit and author.
      - text: List Reddit posts that shared my article URL.
      method: generated
      generated: '2026-10-01'