Setting Live Google My Business Info Tasks
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Setting Live Google My Business Info Tasks
One Google Business Profile: name, address, phone, hours, rating, category and the attributes Google shows on the panel. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. The queued twin is post_dataforseo_business_google_gmb_info_submit. For what the owner has posted recently use post_dataforseo_business_google_gmb_updates_submit, and for customer opinion post_dataforseo_business_google_reviews_submit.
Pricing reference
- Metering: Reported response cost.
- Reference request estimate: USD 0.0054.
- Reference customer multiplier: 1.0. Do not apply it again to a settled customer amount.
Reference metadata only, not an account quote, a guaranteed price or a spending cap. Resource credits are not Felo credits. Final charges follow Felo billing records.
- Type: array (object | null)[]
- keywordType: string
keyword
required field
the keyword you specify should indicate the name of the local establishment
you can specify up to 700 characters in thekeywordfiled
all %## will be decoded (plus character ‘+’ will be decoded to a space character)
if you need to use the “%” character for yourkeyword, please specify it as “%25”;this field can also be used to pass the following parameters:
cid- a unique, google-defined id of the business entity;place_id- an identifier of the business entity in Google Maps;example:
cid:194604053573767737place_id:GhIJQWDl0CIeQUARxks3icF8U8Alearn more about the
cidandplace_ididentifiers in this help center articlelearn more about rules and limitations of
keywordandkeywordsfields in DataForSEO APIs in this Help Center article - languageType: string
_code search engine language code
required field if you don't specifylanguage_name
if you use this field, you don't need to specifylanguage_name
you can receive the list of available languages with theirlanguage_code_by making a separate request tohttps://api.dataforseo.com/v3/business_data/google/languages
example:enn - languageType: string
_name full name of search engine language
required field if you don't specifylanguage_code
if you use this field, you don't need to specifylanguage_code
you can receive the list of available languages withlanguage_nameby making a separate request tohttps://api.dataforseo.com/v3/business_data/google/languages
example:English - locationType: integer
_code search engine location code
required field if you don't specifylocation_name_orlocation_coordinate
if you use this field, you don't need to specifylocation_nameorlocation_coordinate
you can receive the list of available locations withlocation_codeby making a separate request to thehttps://api.dataforseo.com/v3/business_data/google/locations
example:2840n - locationType: string
_coordinate GPS coordinates of a location
required field if you don't specifylocation_name_orlocation_code
if you use this field, you don't need to specifylocation_nameorlocation_codelocation_coordinateparameter should be specified in the "latitude,longitude,radius" format
the maximum number of decimal digits for "latitude" and "longitude": 7
the minimum value for "radius": 199.9 (mm)
the maximum value for "radius": 199999 (mm)
example:53.476225,-2.243572,200n - locationType: string
_name full name of search engine location
required field if you don't specifylocation_codeorlocation_coordinate
if you use this field, you don't need to specifylocation_codeorlocation_coordinate
you can receive the list of available locations withlocation_nameby making a separate request tohttps://api.dataforseo.com/v3/business_data/google/locations
example:London,England,United Kingdom - tagType: string | null
user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specifiedtagvalue in thedataobject of the response
- Type: object | null · Response36Afe1097B20_BusinessDataGoogleMyBusinessInfoLiveResponseInfo200
- Type: number | null Format: doublecost
total tasks cost, USD
- Type: integer | nullstatus
_code general status code you can find the full list of the response codes here
- Type: string | nullstatus
_message general informational message you can find the full list of general informational messages here
- Type: array (object | null)[] | nulltasks
array of tasks
- Type: object | null · Response36Afe1097B20_BusinessDataGoogleMyBusinessInfoLiveTaskInfo
- costType: number | null Format: double
total tasks cost, USD
- dataType: object | null
contains the same parameters that you specified in the POST request
- propertyType: object | null
Name
- idType: string | null
task identifier unique task identifier in our system in the UUID format
- pathType: array (string | null)[] | null
URL path
- resultType: array (object | null)[] | null
array of results
- checkType: string | null
_url direct URL to search engine results
you can use it to make sure that we provided accurate results - datetimeType: string | null
date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:2019-11-15 12:57:46 +00:00 - itemType: array (string | null)[] | null
_types item types
types of search engine results encountered in theitemsarray;
possible item types:google_business_info - itemsType: array (object | null)[] | null
encountered item types
types of search engine results encountered in theitemsarray;
possible item types:google_business_info- additionalType: array string[] | null
_categories additional business categories
additional Google My Business categories that describe the services provided by the business entity in more detail - addressType: string | null
address of the business entity
- addressType: object | null · Response36Afe1097B20_AddressInfo
_info object containing address components of the business entity
- addressType: string | null
street address of the local establishment
- boroughType: string | null
administrative unit or district the local establishment belongs to
- cityType: string | null
name of the city where the local establishment is located
- countryType: string | null
_code ISO country code of the local establishment
- regionType: string | null
DMA region the local establishment belongs to
- zipType: string | null
ZIP code of the local establishment
- attributesType: object | null · Response36Afe1097B20_BusinessDataAttributesInfo
service details in a form of user-reviewed checks;
service details of a business entity displayed in a form of checks and based on user feedback and businesscategory- availableType: object | null
_attributes available attributes
indicates attributes a business entity can offer- propertyType: array (string | null)[] | null
Name
- unavailableType: object | null
_attributes unavailable attributes
indicates attributes a business entity cannot offer- propertyType: array (string | null)[] | null
Name
- bookType: string | null
_online _url URL in the 'book online' button of the element
URL directing users to the online booking or order page of the business entity - categoryType: string | null
business category
Google My Business general category that best describes the services provided by the business entity - categoryType: array string[] | null
_ids global category IDs
universal category IDs that do not change based on the selected country - cidType: string | null
- contactType: string | null
_url URL of the preferred contact page
- contributorType: string | null
_url URL of the user's or entity's Local Guides profile, if available
- descriptionType: string | null
description of the element in SERP
the description of the business entity for which the results are collected - directoryType: object | null · Response36Afe1097B20_BusinessDirectoryInfo
items of the directory
includes information about businesses that are located within the target business establishment and have the same address- itemsType: array (object | null)[] | null
encountered item types
types of search engine results encountered in theitemsarray;
possible item types:google_business_info- additionalType: array string[] | null
_categories additional business categories
additional Google My Business categories that describe the services provided by the business entity in more detail - addressType: string | null
address of the business entity
- addressType: object | null · Response36Afe1097B20_AddressInfo
_info object containing address components of the business entity
- addressType: string | null
street address of the local establishment
- boroughType: string | null
administrative unit or district the local establishment belongs to
- cityType: string | null
name of the city where the local establishment is located
- countryType: string | null
_code ISO country code of the local establishment
- regionType: string | null
DMA region the local establishment belongs to
- zipType: string | null
ZIP code of the local establishment
- categoryType: string | null
business category
Google My Business general category that best describes the services provided by the business entity - categoryType: array string[] | null
_ids global category IDs
universal category IDs that do not change based on the selected country - cidType: string | null
- domainType: string | null
domain of the business entity
- featureType: string | null
_id - hotelType: string | null
_rating - isType: boolean | null
_claimed shows whether the entity is verified by its owner on Google Maps
- isType: boolean | null
_directory _item business establishment is a part of the directory
indicates whether the business establishment is a part of the directory;
iftrue, the item is a part of the larger directory of businesses with the same address (e.g., a mall or a business centre);
note: if the business establishment is a parent item in the directory, the value will benull - latitudeType: number | null
latitude coordinate of the local establishments in google maps
example:"latitude": 51.584091 - localType: array string[] | null
_justifications Google local justifications
snippets of text that “justify” why the business is showing up for search query - longitudeType: number | null
longitude coordinate of the local establishment in google maps
example:"longitude": -0.31365919999999997 - mainType: string | null
_image URL of the main image featured in Google My Business profile
- phoneType: string | null
phone number of the business entity
- placeType: string | null
_id unique place identifier
place id of the local establishment featured in the element
learn more about the identifier in this help center article - priceType: string | null
_level property price level
can take values:inexpensive,moderate,expensive,very_expensive
if there is no price level information, the value will benull - rankType: integer | null
_absolute absolute rank among all the elements
- rankType: integer | null
_group position within a group of elements with identical
typevalues
positions of elements with differenttypevalues are omitted from therank_group - ratingType: object | null · Response36Afe1097B20_RatingInfo
the element's rating
the popularity rate based on reviews and displayed in SERP- ratingType: integer | null
_max the maximum value for a rating_type
- ratingType: string | null
_type the type of rating here you can find the following elements: Max5, Percents, CustomMax
- valueType: number | null Format: double
the value of the rating
- votesType: integer | null Format: int64
_count the amount of feedback
- ratingType: object | null
_distribution the distribution of ratings of the business entity the object displays the number of 1-star to 5-star ratings, as reviewed by users
- propertyType: integer | null Format: Int64
Name
- snippetType: string | null
additional information about the business entity
- titleType: string | null
directory title
can take the following values:At this place,Directory - totalType: string | null Format: int64
_photos total count of images featured in Google My Business profile
- typeType: string | null
type of element
- urlType: string | null
URL to view the menu
- workType: object | null · Response36Afe1097B20_BusinessWorkHoursInfo
_hours open hours
information about work hours of the local establishment- workType: object | null · Response36Afe1097B20_WorkHours
_hours open hours
information about work hours of the local establishment- currentType: string | null
_status current status of the establishment
indicates whether the establishment is opened or closed - timetableType: object | null
work hours timetable
- propertyType: array (object | null)[] | null
Name work hours on Sundays
- closeType: object | null · Response36Afe1097B20_TimeInfo
closing time
- hourType: integer | null
hours in the 24-hour format
- minuteType: integer | null
minutes
- openType: object | null · Response36Afe1097B20_TimeInfo
opening time
- hourType: integer | null
hours in the 24-hour format
- minuteType: integer | null
minutes
- titleType: string | null
title of the element
domain of the online menu system
- domainType: string | null
domain of the business entity
- featureType: string | null
_id - hotelType: number | null
_rating - isType: boolean | null
_claimed shows whether the entity is verified by its owner on Google Maps
- isType: boolean | null
_directory _item business establishment is a part of the directory
indicates whether the business establishment is a part of the directory;
iftrue, the item is a part of the larger directory of businesses with the same address (e.g., a mall or a business centre);
note: if the business establishment is a parent item in the directory, the value will benull - latitudeType: number | null
latitude coordinate of the local establishments in google maps
example:"latitude": 51.584091 - localType: array (object | null)[] | null
_business _links available interactions with the business
list of options to interact with the business directly from search results- typeType: string | null
type of element
- logoType: string | null
URL of the logo featured in Google My Business profile
- longitudeType: number | null
longitude coordinate of the local establishment in google maps
example:"longitude": -0.31365919999999997 - mainType: string | null
_image URL of the main image featured in Google My Business profile
- originalType: string | null
_title original title of the element
original title not translated by Google - peopleType: array (object | null)[] | null
_also _search related business entities
- cidType: string | null
- featureType: string | null
_id - ratingType: object | null · Response36Afe1097B20_RatingInfo
the element's rating
the popularity rate based on reviews and displayed in SERP- ratingType: integer | null
_max the maximum value for a rating_type
- ratingType: string | null
_type the type of rating here you can find the following elements: Max5, Percents, CustomMax
- valueType: number | null Format: double
the value of the rating
- votesType: integer | null Format: int64
_count the amount of feedback
- titleType: string | null
title of the element in SERP
the name of the business entity for which the results are collected
- phoneType: string | null
phone number of the business entity
- placeType: string | null
_id unique place identifier
place id of the local establishment featured in the element
learn more about the identifier in this help center article - placeType: object | null
_topics keywords mentioned in customer reviews
contains most popular keywords related to products/services mentioned in customer reviews of a business entity and the number of reviews mentioning each keyword
example:
"place_topics": {
"egg roll": 48,
"birthday": 33
}- propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- popularType: object | null · Response36Afe1097B20_PopularTimes
_times popular times
information related to busy hours of the business entity- popularType: object | null
_times _by _days popular hours
information about busy hours of the local establishment on each day of the week- propertyType: array (object | null)[] | null
Name work hours on Sundays
- popularType: integer | null
_index popularity index relative time-bound popularity index measured from 0 to 100; higher value corresponds to a busier time of a day
- timeType: object | null · Response36Afe1097B20_TimeInfo
hours in the 24-hour format
- hourType: integer | null
hours in the 24-hour format
- minuteType: integer | null
minutes
- positionType: string | null
the alignment in SERP
- priceType: string | null
_level property price level
can take values:inexpensive,moderate,expensive,very_expensive
if there is no price level information, the value will benull - questionsType: integer | null
_and _answers _count Integer numbers.
- rankType: integer | null
_absolute absolute rank among all the elements
- rankType: integer | null
_group position within a group of elements with identical
typevalues
positions of elements with differenttypevalues are omitted fromrank_group - ratingType: object | null · Response36Afe1097B20_RatingInfo
the element's rating
the popularity rate based on reviews and displayed in SERP- ratingType: integer | null
_max the maximum value for a rating_type
- ratingType: string | null
_type the type of rating here you can find the following elements: Max5, Percents, CustomMax
- valueType: number | null Format: double
the value of the rating
- votesType: integer | null Format: int64
_count the amount of feedback
- ratingType: object | null
_distribution the distribution of ratings of the business entity
the object displays the number of 1-star to 5-star ratings, as reviewed by users- propertyType: integer | null Format: Int64
Name
- servicesType: array (object | null)[] | null
list of services offered by the business
- categoryType: string | null
business category
Google My Business general category that best describes the services provided by the business entity - priceType: object | null · Response36Afe1097B20_PriceInfo
- currencyType: string | null
currency of the listed price ISO code of the currency applied to the price
- currentType: number | null Format: double
current price indicates the current price of the product or service featured in the result
- displayedType: string | null
_price price string in the result raw price string as provided in the result
- isType: boolean | null
_price _range price is provided as a range indicates whether a price is provided in a range
- maxType: number | null Format: double
_value the maximum price the maximum price of the product or service as indicated in the result
- regularType: number | null Format: double
regular price indicates the regular price of the product or service with no discounts applied
- snippetType: string | null
additional information on the business entity
- titleType: string | null
title of the element in SERP
the name of the business entity for which the results are collected
- snippetType: string | null
additional information on the business entity
- titleType: string | null
title of the element in SERP
the name of the business entity for which the results are collected - totalType: integer | null Format: int64
_photos total count of images featured in Google My Business profile
- typeType: string | null
type of element
- urlType: string | null
absolute url of the business entity
- workType: object | null · Response36Afe1097B20_BusinessWorkHoursInfo
_time work time details
information related to operational hours of the business entity- workType: object | null · Response36Afe1097B20_WorkHours
_hours open hours
information about work hours of the local establishment- currentType: string | null
_status current status of the establishment
indicates whether the establishment is opened or closed - timetableType: object | null
work hours timetable
- propertyType: array (object | null)[] | null
Name work hours on Sundays
- closeType: object | null · Response36Afe1097B20_TimeInfo
closing time
- hourType: integer | null
hours in the 24-hour format
- minuteType: integer | null
minutes
- openType: object | null · Response36Afe1097B20_TimeInfo
opening time
- hourType: integer | null
hours in the 24-hour format
- minuteType: integer | null
minutes
- itemsType: integer | null Format: int64
_count item types
the number of items in theitemsarray - keywordType: string | null
keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character)
this field will contain thecidparameter if you specified it in thekeywordfield when setting a task;
example:cid:2946633002421908862
learn more about the parameter in this help center article - languageType: string | null
_code language code in a POST array
- locationType: integer | null
_code location code in a POST array
- seType: string | null
_domain search engine domain as specified in a POST array
- resultType: integer | null Format: int64
_count number of elements in the result array
- statusType: integer | null
_code status code of the task generated by DataForSEO, can be within the following range: 10000-60000 you can find the full list of the response codes here
- statusType: string | null
_message informational message of the task you can find the full list of general informational messages here
- timeType: string | null
execution time, seconds
- Type: integer | null Format: int64tasks
_count the number of tasks in the tasks array
- Type: integer | null Format: int64tasks
_error the number of tasks in the tasks array returned with an error
- Type: string | nulltime
total execution time, seconds
- Type: string | nullversion
the current version of the API
application/json - 400
The request could not be processed. Check the request parameters.
- 401
A valid Felo API key is required.
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
A request or spending limit has been reached.
- 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
Error response; upstream passthrough responses may use provider formats
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/my_business_info/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_name": "New York,New York,United States",
"keyword": "RustyBrick, Inc."
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"keyword": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"item_types": [
null
],
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"position": null,
"title": null,
"original_title": null,
"description": null,
"category": null,
"category_ids": [
"[Max Depth Exceeded]"
],
"additional_categories": [
"[Max Depth Exceeded]"
],
"cid": null,
"feature_id": null,
"address": null,
"address_info": "[Max Depth Exceeded]",
"place_id": null,
"phone": null,
"url": null,
"contact_url": null,
"contributor_url": null,
"book_online_url": null,
"domain": null,
"logo": null,
"main_image": null,
"total_photos": null,
"snippet": null,
"latitude": null,
"longitude": null,
"is_claimed": null,
"questions_and_answers_count": null,
"attributes": "[Max Depth Exceeded]",
"place_topics": null,
"rating": "[Max Depth Exceeded]",
"hotel_rating": null,
"price_level": null,
"rating_distribution": null,
"people_also_search": [
"[Max Depth Exceeded]"
],
"work_time": "[Max Depth Exceeded]",
"popular_times": "[Max Depth Exceeded]",
"local_business_links": [
"[Max Depth Exceeded]"
],
"is_directory_item": null,
"directory": "[Max Depth Exceeded]",
"services": [
"[Max Depth Exceeded]"
]
}
]
}
]
}
]
}