Data API / DataForSEO / Business Data
Get Google My Business Info Results by id
Retrieves a queued Google Business Profile lookup by id. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. ⚠️ The response size was fixed by the depth or limit set at submit time and cannot be narrowed here; if it is too large, resubmit smaller rather than paging.
Параметры
путь
idstringОбязательныйDataForSEO task ID.
Пример запроса
curl -X GET "https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/my_business_info/task_get/{id}" \
-H "Authorization: Bearer $FELO_API_KEY"Ответ
Поля ответа
versionstringНеобязательныйthe current version of the API
status_codeintegerНеобязательныйgeneral status code you can find the full list of the response codes here Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions
status_messagestringНеобязательныйgeneral informational message you can find the full list of general informational messages here
timestringНеобязательныйexecution time, seconds
costnumberНеобязательный*total tasks cost, USD*
tasks_countintegerНеобязательный*the number of tasks in the
tasksarray*tasks_errorintegerНеобязательный*the number of tasks in the
tasksarray that were returned an error*tasksstring[]Необязательныйarray of tasks
idstringНеобязательныйtask identifier unique task identifier in our system in the UUID format
status_codeintegerНеобязательный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
status_messagestringНеобязательныйinformational message of the task you can find the full list of general informational messages here
timestringНеобязательныйexecution time, seconds
costnumberНеобязательныйcost of the task, USD
result_countintegerНеобязательныйnumber of elements in the
resultarraypathstring[]НеобязательныйURL path
dataobjectНеобязательныйcontains the same parameters that you specified in the POST request
resultstring[]Необязательныйarray of results
keywordstringНеобязательныйkeyword received in a POST array keyword is returned with decoded %## (plus character ‘+’ will be decoded to a space character) this field will contain the
cidparameter if you specified it in thekeywordfield when setting a task; example:cid:2946633002421908862learn more about the parameter in this help center articlese_domainstringНеобязательныйsearch engine domain as specified in a POST array
location_codeintegerНеобязательныйlocation code in a POST array
language_codestringНеобязательныйlanguage code in a POST array
check_urlstringНеобязательныйdirect URL to search engine results you can use it to make sure that we provided accurate results
datetimestringНеобязательный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:00item_typesstring[]Необязательныйitem types types of search engine results encountered in the
itemsarray; possible item types:google_business_infoitems_countintegerНеобязательныйitem types the number of items in the
itemsarrayitemsstring[]Необязательныйencountered item types types of search engine results encountered in the
itemsarray; possible item types:google_business_infotypestringНеобязательный*type of element = ‘google\_business\_info’*
rank_groupintegerНеобязательныйposition within a group of elements with identical
typevalues positions of elements with differenttypevalues are omitted fromrank_grouprank_absoluteintegerНеобязательныйabsolute rank among all the elements
positionstringНеобязательныйthe alignment in SERP
titlestringНеобязательныйtitle of the element in SERP the name of the business entity for which the results are collected
original_titlestringНеобязательныйoriginal title of the element original title not translated by Google
descriptionstringНеобязательныйdescription of the element in SERP the description of the business entity for which the results are collected
categorystringНеобязательныйbusiness category Google My Business general category that best describes the services provided by the business entity
category_idsstring[]Необязательныйglobal category IDs universal category IDs that do not change based on the selected country
additional_categoriesstring[]Необязательныйadditional business categories additional Google My Business categories that describe the services provided by the business entity in more detail
cidstringНеобязательныйgoogle-defined client id unique id of a local establishment learn more about the identifier in this help center article
feature_idstringНеобязательныйthe unique identifier of the element in SERP learn more about the identifier in this help center article
addressstringНеобязательныйstreet address of the business entity
address_infoobjectНеобязательныйobject containing address components of the business entity
boroughstringНеобязательныйadministrative unit or district the business entity location belongs to
citystringНеобязательныйname of the city where the business entity is located
zipstringНеобязательныйZIP code of the business entity
regionstringНеобязательныйDMA region of the business entity location
country_codestringНеобязательныйISO country code of the business entity location
place_idstringНеобязательныйunique place identifier place id of the local establishment featured in the element learn more about the identifier in this help center article
phonestringНеобязательныйphone number of the business entity
urlstringНеобязательныйabsolute url of the business entity
contact_urlstringНеобязательныйURL of the preferred contact page
contributor_urlstringНеобязательныйURL of the user’s or entity’s Local Guides profile, if available
book_online_urlstringНеобязательныйURL in the ‘book online’ button of the element URL directing users to the online booking or order page of the business entity
domainstringНеобязательныйdomain of the business entity
logostringНеобязательныйURL of the logo featured in Google My Business profile
main_imagestringНеобязательныйURL of the main image featured in Google My Business profile
total_photosintegerНеобязательныйtotal count of images featured in Google My Business profile
snippetstringНеобязательныйadditional information on the business entity
latitudenumberНеобязательныйlatitude coordinate of the local establishments in google maps example:
"latitude": 51.584091longitudenumberНеобязательныйlongitude coordinate of the local establishment in google maps example:
"longitude": -0.31365919999999997is_claimedbooleanНеобязательныйshows whether the entity is verified by its owner on Google Maps
attributesobjectНеобязательный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 business
categoryavailable_attributesobjectНеобязательныйavailable attributes indicates attributes a business entity can offer
unavailable_attributesobjectНеобязательныйunavailable attributes indicates attributes a business entity cannot offer
place_topicsobjectНеобязательный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}ratingobjectНеобязательныйthe element’s rating the popularity rate based on reviews and displayed in SERP
rating_typestringНеобязательныйthe type of rating here you can find the following elements:
Max5,Percents,CustomMaxvalueintegerНеобязательныйthe value of the rating
votes_countintegerНеобязательныйthe amount of feedback
rating_maxintegerНеобязательныйthe maximum value for a
rating_typerating_distributionobjectНеобязательныйthe distribution of ratings of the business entity the object displays the number of 1-star to 5-star ratings, as reviewed by users
1integerНеобязательныйthe number of 1-star ratings
2integerНеобязательныйthe number of 2-star ratings
3integerНеобязательныйthe number of 3-star ratings
4integerНеобязательныйthe number of 4-star ratings
5integerНеобязательныйthe number of 5-star ratings
people_also_searchstring[]Необязательныйrelated business entities
work_timeobjectНеобязательныйwork time details information related to operational hours of the business entity
work_hoursobjectНеобязательныйopen hours information about work hours of the local establishment
timetableobjectНеобязательныйwork hours timetable
sundaystring[]Необязательныйwork hours on Sundays
openobjectНеобязательныйopening time
hourintegerНеобязательныйhours in the 24-hour format
minuteintegerНеобязательныйminutes
closeobjectНеобязательныйclosing time
mondaystring[]Необязательныйwork hours on Mondays
tuesdaystring[]Необязательныйwork hours on Tuesdays
wednesdaystring[]Необязательныйwork hours on Wednesdays
thursdaystring[]Необязательныйwork hours on Thursdays
fridaystring[]Необязательныйwork hours on Fridays
saturdaystring[]Необязательныйwork hours on Saturday
current_statusstringНеобязательныйcurrent status of the establishment possible values:
opened,closed,temporarily_closed,closed_foreverpopular_timesobjectНеобязательныйpopular times information related to busy hours of the business entity
popular_times_by_daysobjectНеобязательныйpopular hours information about busy hours of the local establishment on each day of the week
sundaystring[]Необязательныйbusy hours on sunday can take values of the corresponding days of the week
timeobjectНеобязательныйbusy hours
hourintegerНеобязательныйhours in a 24-hour format
minuteintegerНеобязательныйminutes
popular_indexintegerНеобязательныйpopularity index relative time-bound popularity index measured from
0to100; higher value corresponds to a busier time of a daylocal_business_linksstring[]Необязательныйavailable interactions with the business list of options to interact with the business directly from search results
typestringНеобязательный*type of element = ‘menu’*
titlestringНеобязательныйtitle of the element domain of the online menu system
urlstringНеобязательныйURL to view the menu
delivery_servicesstring[]Необязательныйlists available delivery services
is_directory_itembooleanНеобязательныйbusiness establishment is a part of the directory indicates whether the business establishment is a part of the directory; if
true, 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 benulldirectorystring[]Необязательныйitems of the directory includes information about businesses that are located within the target business establishment and have the same address
titlestringНеобязательныйtitle of the element in SERP the name of the business entity
itemsstring[]Необязательный*array of directory items*
typestringНеобязательный*type of element = ‘maps\_search’*
rank_groupintegerНеобязательныйposition within a group of elements with identical
typevalues positions of elements with differenttypevalues are omitted from therank_grouprank_absoluteintegerНеобязательныйabsolute rank among all the elements
domainstringНеобязательныйdomain of the business entity
urlstringНеобязательныйabsolute url of the business entity
ratingobjectНеобязательныйthe element’s rating the popularity rate based on reviews and displayed in SERP
rating_typestringНеобязательныйthe type of rating here you can find the following elements:
Max5,Percents,CustomMaxvalueintegerНеобязательныйthe value of the rating
votes_countintegerНеобязательныйthe amount of feedback
rating_maxintegerНеобязательныйthe maximum value for a
rating_typerating_distributionobjectНеобязательныйthe distribution of ratings of the business entity the object displays the number of 1-star to 5-star ratings, as reviewed by users
1integerНеобязательныйthe number of 1-star ratings
2integerНеобязательныйthe number of 2-star ratings
3integerНеобязательныйthe number of 3-star ratings
4integerНеобязательныйthe number of 4-star ratings
5integerНеобязательныйthe number of 5-star ratings
snippetstringНеобязательныйadditional information about the business entity
addressstringНеобязательныйstreet address of the business entity
address_infoobjectНеобязательныйobject containing address components of the business entity
boroughstringНеобязательныйadministrative unit or district the business entity location belongs to
citystringНеобязательныйname of the city where the business entity is located
zipstringНеобязательныйZIP code of the business entity
regionstringНеобязательныйDMA region of the business entity location
country_codestringНеобязательныйISO country code of the business entity location
place_idstringНеобязательныйunique place identifier place id of the local establishment featured in the element learn more about the identifier in this help center article
phonestringНеобязательныйphone number of the business entity
main_imagestringНеобязательныйURL of the main image featured in Google My Business profile
total_photosintegerНеобязательныйtotal count of images featured in Google My Business profile
categorystringНеобязательныйbusiness category Google My Business general category that best describes the services provided by the business entity
category_idsstring[]Необязательныйglobal category IDs universal category IDs that do not change based on the selected country
work_hoursobjectНеобязательныйwork hours information about work hours of the local establishment
feature_idstringНеобязательныйthe unique identifier of the element in SERP learn more about the identifier in this help center article
cidstringНеобязательныйgoogle-defined client id unique id of a local establishment; can be used with Google Reviews API to get a full list of reviews learn more about the identifier in this help center article
latitudenumberНеобязательныйlatitude coordinate of the local establishments in google maps example:
"latitude": 51.584091longitudenumberНеобязательныйlongitude coordinate of the local establishment in google maps example:
"longitude": -0.31365919999999997is_claimedbooleanНеобязательныйshows whether the entity is verified by its owner on Google Maps
local_justificationsstring[]НеобязательныйGoogle local justifications snippets of text that “justify” why the business is showing up for search query
is_directory_itembooleanНеобязательныйbusiness establishment is a part of the directory indicates whether the business establishment is a part of the directory; if
true, 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 benullprice_levelstringНеобязательныйproperty price level can take values:
inexpensive,moderate,expensive,very_expensiveif there is no price level information, the value will benullhotel_ratingintegerНеобязательныйhotel class rating class ratings range between 1-5 stars, learn more if there is no hotel class rating information, the value will be
null