DataForSEO BusinessData API

The BusinessData API from DataForSEO — 55 operation(s) for businessdata.

Operations 55

POST /v3/business_data/id_list #
POST /v3/business_data/errors #
GET /v3/business_data/business_listings/locations #
GET /v3/business_data/business_listings/categories #
GET /v3/business_data/business_listings/available_filters #
POST /v3/business_data/business_listings/search/live #
POST /v3/business_data/business_listings/categories_aggregation/live #
GET /v3/business_data/google/locations #
GET /v3/business_data/google/locations/{country} #
GET /v3/business_data/google/languages #
POST /v3/business_data/google/my_business_info/task_post #
GET /v3/business_data/google/my_business_info/tasks_ready #
GET /v3/business_data/tasks_ready #
GET /v3/business_data/google/my_business_info/task_get/{id} #
POST /v3/business_data/google/my_business_info/live #
POST /v3/business_data/google/my_business_updates/task_post #
GET /v3/business_data/google/my_business_updates/tasks_ready #
GET /v3/business_data/google/my_business_updates/task_get/{id} #
POST /v3/business_data/google/hotel_searches/task_post #
GET /v3/business_data/google/hotel_searches/tasks_ready #
GET /v3/business_data/google/hotel_searches/task_get/{id} #
POST /v3/business_data/google/hotel_searches/live #
POST /v3/business_data/google/hotel_info/task_post #
GET /v3/business_data/google/hotel_info/tasks_ready #
GET /v3/business_data/google/hotel_info/task_get/advanced/{id} #
GET /v3/business_data/google/hotel_info/task_get/html/{id} #
POST /v3/business_data/google/hotel_info/live/advanced #
POST /v3/business_data/google/hotel_info/live/html #
POST /v3/business_data/google/reviews/task_post #
GET /v3/business_data/google/reviews/tasks_ready #
GET /v3/business_data/google/reviews/task_get/{id} #
POST /v3/business_data/google/extended_reviews/task_post #
GET /v3/business_data/google/extended_reviews/tasks_ready #
GET /v3/business_data/google/extended_reviews/task_get/{id} #
POST /v3/business_data/google/questions_and_answers/task_post #
GET /v3/business_data/google/questions_and_answers/tasks_ready #
GET /v3/business_data/google/questions_and_answers/task_get/{id} #
POST /v3/business_data/google/questions_and_answers/live #
POST /v3/business_data/trustpilot/search/task_post #
GET /v3/business_data/trustpilot/search/tasks_ready #
GET /v3/business_data/trustpilot/search/task_get/{id} #
POST /v3/business_data/trustpilot/reviews/task_post #
GET /v3/business_data/trustpilot/reviews/tasks_ready #
GET /v3/business_data/trustpilot/reviews/task_get/{id} #
GET /v3/business_data/tripadvisor/locations #
GET /v3/business_data/tripadvisor/locations/{country} #
GET /v3/business_data/tripadvisor/languages #
POST /v3/business_data/tripadvisor/search/task_post #
GET /v3/business_data/tripadvisor/search/tasks_ready #
GET /v3/business_data/tripadvisor/search/task_get/{id} #
POST /v3/business_data/tripadvisor/reviews/task_post #
GET /v3/business_data/tripadvisor/reviews/tasks_ready #
GET /v3/business_data/tripadvisor/reviews/task_get/{id} #
POST /v3/business_data/social_media/pinterest/live #
POST /v3/business_data/social_media/reddit/live #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/dataforseo-businessdata-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

dataforseo-businessdata-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: DataForSEO AiOptimization Business Data API
  description: DataForSEO API is the starting point on your journey towards building powerful SEO software. With DataForSEO you can get all the data you need to build an efficient application while also saving your time and budget. DataForSEO API is using the REST technology for interchanging data between your application and our service. The data exchange is made through the widely used HTTP protocol, which allows applying our API to almost all programming languages.
  version: 1.0.0
servers:
- url: https://api.dataforseo.com
- url: https://sandbox.dataforseo.com
tags:
- name: BusinessData
paths:
  /v3/business_data/id_list:
    post:
      tags:
      - BusinessData
      description: 'This endpoint is designed to provide you with a list of IDs and metadata for all Business Data tasks created within the specified time period, including both successful and uncompleted tasks.

        for more info please visit ''https://docs.dataforseo.com/v3/business_data/id_list/?bash'''
      operationId: BusinessDataIdList
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataIdListRequestInfo'
              example:
              - datetime_from: '2026-04-12 04:39:39 +00:00'
                datetime_to: '2026-04-14 04:39:39 +00:00'
                limit: 100
                offset: 0
                sort: desc
                include_metadata: true
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataIdListResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/errors:
    post:
      tags:
      - BusinessData
      description: 'By calling this endpoint you will receive information about the Business Data API tasks that returned an error within the past 7 days.

        for more info please visit ''https://docs.dataforseo.com/v3/business_data/errors/?bash'''
      operationId: BusinessDataErrors
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataErrorsRequestInfo'
              example:
              - limit: 10
                offset: 0
                filtered_function: pingback_url
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataErrorsResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/business_listings/locations:
    get:
      tags:
      - BusinessData
      description: 'You will receive the list of locations by this API call. You can also download the full list of supported locations in the CSV format (last updated 2026-04-06).

        for more info please visit ''https://docs.dataforseo.com/v3/business_data/business_listings/locations/?bash'''
      operationId: BusinessListingsLocations
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataBusinessListingsLocationsResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/business_listings/categories:
    get:
      tags:
      - BusinessData
      description: 'This endpoint will provide you with the list of top categories by business count.

        for more info please visit ''https://docs.dataforseo.com/v3/business_data/business_listings/categories/?bash'''
      operationId: BusinessListingsCategories
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataBusinessListingsCategoriesResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/business_listings/available_filters:
    get:
      tags:
      - BusinessData
      description: 'Here you will find all the necessary information about filters that can be used with Business Listings API.

        for more info please visit ''https://docs.dataforseo.com/v3/business_data/business_listings/filters/?bash'''
      operationId: BusinessListingsAvailableFilters
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataBusinessListingsAvailableFiltersResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/business_listings/search/live:
    post:
      tags:
      - BusinessData
      description: 'Business Listings Search API provides results containing information about business entities listed on Google Maps in the specified categories. You will receive the address, contacts, rating, working hours, and other relevant data. The provided results are specific to the selected location (see the List of Locations) settings.

        for more info please visit ''https://docs.dataforseo.com/v3/business_data/business_listings/search/live/?bash'''
      operationId: BusinessListingsSearchLive
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataBusinessListingsSearchLiveRequestInfo'
              example:
              - categories:
                - pizza_restaurant
                description: pizza
                title: pizza
                is_claimed: true
                location_coordinate: 53.476225,-2.243572,10
                order_by:
                - rating.value,desc
                filters:
                - - rating.value
                  - '>'
                  - 3
                limit: 3
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataBusinessListingsSearchLiveResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/business_listings/categories_aggregation/live:
    post:
      tags:
      - BusinessData
      description: 'Business Listings Categories Aggregation endpoint provides results containing information about groups of related categories along with the number of entities in each category. The provided results are specific to the specified parameters.

        for more info please visit ''https://docs.dataforseo.com/v3/business_data/business_listings/categories_aggregation/live/?bash'''
      operationId: BusinessListingsCategoriesAggregationLive
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataBusinessListingsCategoriesAggregationLiveRequestInfo'
              example:
              - categories:
                - pizza_restaurant
                description: pizza
                title: pizza
                is_claimed: true
                location_coordinate: 53.476225,-2.243572,10
                initial_dataset_filters:
                - - rating.value
                  - '>'
                  - 3
                limit: 3
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataBusinessListingsCategoriesAggregationLiveResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/google/locations:
    get:
      tags:
      - BusinessData
      description: 'You will receive the list of locations by this API call. You can filter the list of locations by country when setting a task.

        for more info please visit ''https://docs.dataforseo.com/v3/business_data/google/locations/?bash'''
      operationId: BusinessDataGoogleLocations
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleLocationsResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/google/locations/{country}:
    get:
      tags:
      - BusinessData
      description: 'You will receive the list of locations by this API call. You can filter the list of locations by country when setting a task.

        for more info please visit ''https://docs.dataforseo.com/v3/business_data/google/locations/?bash'''
      operationId: BusinessDataGoogleLocationsCountry
      parameters:
      - name: country
        in: path
        description: 'country ISO code

          optional field

          specify the ISO code if you want to filter the list of locations by country

          example:

          us'
        required: true
        schema:
          type: string
        example: us
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleLocationsCountryResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/google/languages:
    get:
      tags:
      - BusinessData
      description: 'You will receive the list of languages by calling this API.

        for more info please visit ''https://docs.dataforseo.com/v3/business_data/google/languages/?bash'''
      operationId: BusinessDataGoogleLanguages
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleLanguagesResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/google/my_business_info/task_post:
    post:
      tags:
      - BusinessData
      description: 'Business Data API provides results containing information about specific business entity from Google. The provided results are specific to the selected location (see the List of Locations) and language (see the List of Languages) settings.

        for more info please visit ''https://docs.dataforseo.com/v3/business_data/google/my_business_info/task_post/?bash'''
      operationId: GoogleMyBusinessInfoTaskPost
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleMyBusinessInfoTaskPostRequestInfo'
              example:
              - language_code: en
                location_name: New York,New York,United States
                keyword: RustyBrick, Inc.
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleMyBusinessInfoTaskPostResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/google/my_business_info/tasks_ready:
    get:
      tags:
      - BusinessData
      description: 'The ‘Tasks Ready’ endpoint is designed to provide you with the list of completed tasks, which haven’t been collected yet. If you don’t use the postback_url, you can receive the list of id for all completed tasks using this endpoint. Then, you can collect the results using the ‘Task GET’ endpoint.

        for more info please visit ''https://docs.dataforseo.com/v3/business_data/google/my_business_info/tasks_ready/?bash'''
      operationId: GoogleMyBusinessInfoTasksReady
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleMyBusinessInfoTasksReadyResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/tasks_ready:
    get:
      tags:
      - BusinessData
      description: 'The ‘Tasks Ready’ endpoint is designed to provide you with the list of completed tasks, which haven’t been collected yet. If you don’t use the postback_url, you can receive the list of id for all completed tasks using this endpoint. Then, you can collect the results using the ‘Task GET’ endpoint.

        for more info please visit ''https://docs.dataforseo.com/v3/business_data/google/my_business_info/tasks_ready/?bash'''
      operationId: BusinessDataTasksReady
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataTasksReadyResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/google/my_business_info/task_get/{id}:
    get:
      tags:
      - BusinessData
      description: for more info please visit 'https://docs.dataforseo.com/v3/business_data/google/my_business_info/task_get/?bash'
      operationId: GoogleMyBusinessInfoTaskGet
      parameters:
      - name: id
        in: path
        description: 'task identifier

          unique task identifier in our system in the UUID format

          you will be able to use it within 30 days to request the results of the task at any time'
        required: true
        schema:
          type: string
        example: 00000000-0000-0000-0000-000000000000
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleMyBusinessInfoTaskGetResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/google/my_business_info/live:
    post:
      tags:
      - BusinessData
      description: 'Business Data API provides results containing information about specific business entity from Google. The provided results are specific to the selected location (see the List of Locations) and language (see the List of Languages) settings.

        for more info please visit ''https://docs.dataforseo.com/v3/business_data/google/my_business_info/live/?bash'''
      operationId: GoogleMyBusinessInfoLive
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleMyBusinessInfoLiveRequestInfo'
              example:
              - language_code: en
                location_name: New York,New York,United States
                keyword: RustyBrick, Inc.
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleMyBusinessInfoLiveResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/google/my_business_updates/task_post:
    post:
      tags:
      - BusinessData
      description: 'This endpoints provides the latest updates of a specific business entity from Google SERP. The provided results are specific to the selected location (see the List of Locations) and language (see the List of Languages) settings.

        for more info please visit ''https://docs.dataforseo.com/v3/business_data/google/my_business_updates/task_post/?bash'''
      operationId: GoogleMyBusinessUpdatesTaskPost
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleMyBusinessUpdatesTaskPostRequestInfo'
              example:
              - language_code: en
                location_name: New York,New York,United States
                keyword: RustyBrick, Inc.
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleMyBusinessUpdatesTaskPostResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/google/my_business_updates/tasks_ready:
    get:
      tags:
      - BusinessData
      description: 'The ‘Tasks Ready’ endpoint is designed to provide you with the list of completed tasks, which haven’t been collected yet. If you don’t use the postback_url, you can receive the list of id for all completed tasks using this endpoint. Then, you can collect the results using the ‘Task GET’ endpoint.

        for more info please visit ''https://docs.dataforseo.com/v3/business_data/google/my_business_updates/tasks_ready/?bash'''
      operationId: GoogleMyBusinessUpdatesTasksReady
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleMyBusinessUpdatesTasksReadyResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/google/my_business_updates/task_get/{id}:
    get:
      tags:
      - BusinessData
      description: for more info please visit 'https://docs.dataforseo.com/v3/business_data/google/my_business_updates/task_get/?bash'
      operationId: GoogleMyBusinessUpdatesTaskGet
      parameters:
      - name: id
        in: path
        description: 'task identifier

          unique task identifier in our system in the UUID format

          you will be able to use it within 30 days to request the results of the task at any time'
        required: true
        schema:
          type: string
        example: 00000000-0000-0000-0000-000000000000
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleMyBusinessUpdatesTaskGetResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/google/hotel_searches/task_post:
    post:
      tags:
      - BusinessData
      description: 'Hotel Searches API provides results containing information about different hotels listed on Google. The provided results are specific to the keyword, selected location (see the List of Locations) and language (see the List of Languages) settings.

        for more info please visit ''https://docs.dataforseo.com/v3/business_data/google/hotel_searches/task_post/?bash'''
      operationId: GoogleHotelSearchesTaskPost
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleHotelSearchesTaskPostRequestInfo'
              example:
              - language_code: en
                location_name: New York,New York,United States
                keyword: cheap hotel
                check_in: '2026-05-15'
                check_out: '2026-05-16'
                currency: USD
                adults: 2
                children:
                - 14
                sort_by: highest_rating
                priority: 2
                tag: example
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleHotelSearchesTaskPostResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/google/hotel_searches/tasks_ready:
    get:
      tags:
      - BusinessData
      description: 'The ‘Tasks Ready’ endpoint is designed to provide you with the list of completed tasks, which haven’t been collected yet. If you don’t use the postback_url, you can receive the list of id for all completed tasks using this endpoint. Then, you can collect the results using the ‘Task GET’ endpoint.

        for more info please visit ''https://docs.dataforseo.com/v3/business_data/google/hotel_searches/tasks_ready/?bash'''
      operationId: GoogleHotelSearchesTasksReady
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleHotelSearchesTasksReadyResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/google/hotel_searches/task_get/{id}:
    get:
      tags:
      - BusinessData
      description: for more info please visit 'https://docs.dataforseo.com/v3/business_data/google/hotel_searches/task_get/?bash'
      operationId: GoogleHotelSearchesTaskGet
      parameters:
      - name: id
        in: path
        description: 'task identifier

          unique task identifier in our system in the UUID format

          you will be able to use it within 30 days to request the results of the task at any time'
        required: true
        schema:
          type: string
        example: 00000000-0000-0000-0000-000000000000
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleHotelSearchesTaskGetResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/google/hotel_searches/live:
    post:
      tags:
      - BusinessData
      description: 'Hotel Searches API provides results containing information about different hotels listed on Google Hotels. The provided results are specific to the selected location (see the List of Locations) and language (see the List of Languages) settings.

        for more info please visit ''https://docs.dataforseo.com/v3/business_data/google/hotel_searches/live/?bash'''
      operationId: GoogleHotelSearchesLive
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleHotelSearchesLiveRequestInfo'
              example:
              - language_code: en
                location_name: New York,New York,United States
                keyword: cheap hotel
                check_in: '2026-05-15'
                check_out: '2026-05-16'
                currency: USD
                adults: 2
                children:
                - 14
                sort_by: highest_rating
                tag: example
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleHotelSearchesLiveResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/google/hotel_info/task_post:
    post:
      tags:
      - BusinessData
      description: 'Google Hotel Info will provide you with structured data available for a specific hotel entity on the Google Hotels platform: such as service description, location details, rating, amenities, reviews, images, prices, and more.

        for more info please visit ''https://docs.dataforseo.com/v3/business_data/google/hotel_info/task_post/?bash'''
      operationId: GoogleHotelInfoTaskPost
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleHotelInfoTaskPostRequestInfo'
              example:
              - language_code: en
                location_name: New York,New York,United States
                hotel_identifier: ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE
                tag: some_string_123
                postback_url: https://your-server.com/postbackscript.php
                postback_data: advanced
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleHotelInfoTaskPostResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/google/hotel_info/tasks_ready:
    get:
      tags:
      - BusinessData
      description: 'The ‘Tasks Ready’ endpoint is designed to provide you with the list of completed tasks, which haven’t been collected yet. If you don’t use the postback_url, you can receive the list of id for all completed tasks using this endpoint. Then, you can collect the results using the ‘Task GET’ endpoint.

        for more info please visit ''https://docs.dataforseo.com/v3/business_data/google/hotel_info/tasks_ready/?bash'''
      operationId: GoogleHotelInfoTasksReady
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleHotelInfoTasksReadyResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/google/hotel_info/task_get/advanced/{id}:
    get:
      tags:
      - BusinessData
      description: for more info please visit 'https://docs.dataforseo.com/v3/business_data/google/hotel_info/task_get/advanced/?bash'
      operationId: GoogleHotelInfoTaskGetAdvanced
      parameters:
      - name: id
        in: path
        description: 'task identifier

          unique task identifier in our system in the UUID format

          you will be able to use it within 30 days to request the results of the task at any time'
        required: true
        schema:
          type: string
        example: 00000000-0000-0000-0000-000000000000
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleHotelInfoTaskGetAdvancedResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/google/hotel_info/task_get/html/{id}:
    get:
      tags:
      - BusinessData
      description: for more info please visit 'https://docs.dataforseo.com/v3/business_data/google/hotel_info/task_get/html/?bash'
      operationId: GoogleHotelInfoTaskGetHtml
      parameters:
      - name: id
        in: path
        description: 'task identifier

          unique task identifier in our system in the UUID format

          you will be able to use it within 7 days to request the results of the task at any time'
        required: true
        schema:
          type: string
        example: 00000000-0000-0000-0000-000000000000
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleHotelInfoTaskGetHtmlResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/google/hotel_info/live/advanced:
    post:
      tags:
      - BusinessData
      description: 'Google Hotel Info will provide you with structured data available for a specific hotel entity on the Google Hotels platform: such as service description, location details, rating, amenities, reviews, images, prices, and more.

        for more info please visit ''https://docs.dataforseo.com/v3/business_data/google/hotel_info/live/advanced/?bash'''
      operationId: GoogleHotelInfoLiveAdvanced
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleHotelInfoLiveAdvancedRequestInfo'
              example:
              - language_code: en
                location_name: New York,New York,United States
                hotel_identifier: CgoI-KWyzenM_MV3EAE
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleHotelInfoLiveAdvancedResponseInfo'
      security:
      - basicAuth: []
  /v3/business_data/google/hotel_info/live/html:
    post:
      tags:
      - BusinessData
      description: 'Google Hotel Info will provide you with unstructured HTML data available for a specific hotel entity on the Google Hotels platform: such as service description, location details, rating, amenities, reviews, images, prices, and more.

        for more info please visit ''https://docs.dataforseo.com/v3/business_data/google/hotel_info/live/html/?bash'''
      operationId: GoogleHotelInfoLiveHtml
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/BusinessDataGoogleHotelInfoLiveHtmlRequestInfo'
             

# --- truncated at 32 KB (402 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/openapi/dataforseo-businessdata-api-openapi.yml