openapi: 3.0.1
info:
title: DataForSEO AiOptimization BusinessData 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
oneOf:
- $ref: '#/components/schemas/BusinessDataIdListRequestInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataIdListResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataErrorsRequestInfo'
nullable: true
example:
- limit: 10
offset: 0
filtered_function: pingback_url
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BusinessDataErrorsResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataBusinessListingsLocationsResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataBusinessListingsCategoriesResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataBusinessListingsAvailableFiltersResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataBusinessListingsSearchLiveRequestInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataBusinessListingsSearchLiveResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataBusinessListingsCategoriesAggregationLiveRequestInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataBusinessListingsCategoriesAggregationLiveResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleLocationsResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleLocationsCountryResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleLanguagesResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleMyBusinessInfoTaskPostRequestInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleMyBusinessInfoTaskPostResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleMyBusinessInfoTasksReadyResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataTasksReadyResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleMyBusinessInfoTaskGetResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleMyBusinessInfoLiveRequestInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleMyBusinessInfoLiveResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleMyBusinessUpdatesTaskPostRequestInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleMyBusinessUpdatesTaskPostResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleMyBusinessUpdatesTasksReadyResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleMyBusinessUpdatesTaskGetResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleHotelSearchesTaskPostRequestInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleHotelSearchesTaskPostResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleHotelSearchesTasksReadyResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleHotelSearchesTaskGetResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleHotelSearchesLiveRequestInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleHotelSearchesLiveResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleHotelInfoTaskPostRequestInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleHotelInfoTaskPostResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleHotelInfoTasksReadyResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleHotelInfoTaskGetAdvancedResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleHotelInfoTaskGetHtmlResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleHotelInfoLiveAdvancedRequestInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleHotelInfoLiveAdvancedResponseInfo'
nullable: true
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
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleHotelInfoLiveHtmlRequestInfo'
nullable: true
example:
- language_code: en
location_name: New York,New York,United States
hotel_identifier: ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
oneOf:
- $ref: '#/components/schemas/BusinessDataGoogleHotelInfoLiveHtmlResponseInfo
# --- truncated at 32 KB (393 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/openapi/dataforseo-businessdata-api-openapi.yml