Felo API PlatformFelo API Platform

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 tasks array*

  • tasks_errorintegerНеобязательный

    *the number of tasks in the tasks array 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 result array

  • pathstring[]Необязательный

    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 cid parameter if you specified it in the keyword field when setting a task; example: cid:2946633002421908862 learn more about the parameter in this help center article

  • se_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:00

  • item_typesstring[]Необязательный

    item types types of search engine results encountered in the items array; possible item types: google_business_info

  • items_countintegerНеобязательный

    item types the number of items in the items array

  • itemsstring[]Необязательный

    encountered item types types of search engine results encountered in the items array; possible item types: google_business_info

  • typestringНеобязательный

    *type of element = ‘google\_business\_info’*

  • rank_groupintegerНеобязательный

    position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group

  • rank_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.584091

  • longitudenumberНеобязательный

    longitude coordinate of the local establishment in google maps example: "longitude": -0.31365919999999997

  • is_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 category

  • available_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, CustomMax

  • valueintegerНеобязательный

    the value of the rating

  • votes_countintegerНеобязательный

    the amount of feedback

  • rating_maxintegerНеобязательный

    the maximum value for a rating_type

  • rating_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_forever

  • popular_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 0 to 100; higher value corresponds to a busier time of a day

  • local_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 be null

  • directorystring[]Необязательный

    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 type values positions of elements with different type values are omitted from the rank_group

  • rank_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, CustomMax

  • valueintegerНеобязательный

    the value of the rating

  • votes_countintegerНеобязательный

    the amount of feedback

  • rating_maxintegerНеобязательный

    the maximum value for a rating_type

  • rating_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.584091

  • longitudenumberНеобязательный

    longitude coordinate of the local establishment in google maps example: "longitude": -0.31365919999999997

  • is_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 be null

  • price_levelstringНеобязательный

    property price level can take values: inexpensive, moderate, expensive, very_expensive if there is no price level information, the value will be null

  • hotel_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