v0.2.0-beta

OpenAPI 3.1.0

Получение результатов Google My Business Info по id

Felo API Support

MIT

Сервер

https://openapi.felo.ai

Клиентские библиотеки

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Операции

get/v1/beta/dataforseo/business_data/google/my_business_info/task_get/{id}

Получение результатов Google My Business Info по id

По id получает из очереди результат поиска профиля Google Business. Ответ обёрнут в конверт DataForSEO: данные в tasks[0].result, результат в tasks[0].status_code — отклонённый запрос всё равно возвращает HTTP 200. ⚠️ Размер ответа зафиксирован параметром depth или лимитом, заданным при отправке, и здесь его нельзя уменьшить; если он слишком велик, отправьте запрос заново с меньшим значением, а не листайте страницы.

Справочные цены

Тарификация: стоимость ответа по данным провайдера.
Справочная оценка запроса: USD 0.012.
Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.

Только справочные метаданные, а не коммерческое предложение для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.

Параметры пути

id
Тип: string
обязательно

идентификатор задачи
уникальный идентификатор задачи в нашей системе в формате UUID
в течение 30 дней вы сможете в любое время запросить по нему результаты задачи

Ответы

200
Тип: object | null · Response36Afe1097B20_BusinessDataGoogleMyBusinessInfoTaskGetResponseInfo
cost
Тип: number | null Формат: double

общая стоимость задач, USD

status_code
Тип: integer | null

общий код состояния. Полный список кодов ответа можно найти здесь.

status_message
Тип: string | null

общее информационное сообщение. Полный список общих информационных сообщений можно найти здесь.

tasks
Тип: array (object | null)[] | null

массив задач

Тип: object | null · Response36Afe1097B20_BusinessDataGoogleMyBusinessInfoTaskGetTaskInfo
cost
Тип: number | null Формат: double

общая стоимость задач, USD

data
Тип: object | null

содержит те же параметры, что вы указали в POST-запросе

propertyName
Тип: object | null
id
Тип: string | null

идентификатор задачи уникальный идентификатор задачи в нашей системе в формате UUID

path
Тип: array (string | null)[] | null

путь URL

result
Тип: array (object | null)[] | null

массив результатов

check_url
Тип: string | null

прямой URL к результатам поисковой системы
с его помощью можно убедиться, что мы предоставили точные результаты

datetime
Тип: string | null

дата и время получения результата
в формате UTC: “yyyy-mm-dd hh-mm-ss +00:00”
пример:
2019-11-15 12:57:46 +00:00

item_types
Тип: array (string | null)[] | null

типы элементов
типы результатов поисковой системы, встречающиеся в массиве items;
возможные типы элементов: google_business_info

items
Тип: array (object | null)[] | null

массив элементов каталога

additional_categories
Тип: array string[] | null

дополнительные категории бизнеса
дополнительные категории Google My Business, которые подробнее описывают услуги, предоставляемые организацией

address
Тип: string | null

адрес бизнес-сущности

address_info
Тип: object | null · Response36Afe1097B20_AddressInfo

объект, содержащий компоненты адреса бизнес-сущности

address
Тип: string | null

адрес местного заведения

borough
Тип: string | null

административная единица или район, к которому относится местное заведение

city
Тип: string | null

название города, в котором находится местное заведение

country_code
Тип: string | null

код страны ISO местного заведения

region
Тип: string | null

регион DMA, к которому относится местное заведение

zip
Тип: string | null

почтовый индекс местного заведения

attributes
Тип: object | null · Response36Afe1097B20_BusinessDataAttributesInfo

сведения об услугах в виде пунктов, проверенных пользователями;
сведения об услугах бизнес-сущности, отображаемые в виде пунктов и основанные на отзывах пользователей и category бизнеса

available_attributes
Тип: object | null

доступные атрибуты
указывает атрибуты, которые может предоставить бизнес-сущность

propertyName
Тип: array (string | null)[] | null
unavailable_attributes
Тип: object | null

недоступные атрибуты
указывает атрибуты, которые бизнес-сущность не может предоставить

propertyName
Тип: array (string | null)[] | null
book_online_url
Тип: string | null

URL кнопки 'book online' элемента
URL, направляющий пользователей на страницу онлайн-бронирования или заказа организации

category
Тип: string | null

категория бизнеса
общая категория Google My Business, которая лучше всего описывает услуги, предоставляемые организацией

category_ids
Тип: array string[] | null

глобальные ID категорий
универсальные ID категорий, которые не меняются в зависимости от выбранной страны

cid
Тип: string | null

определённый Google клиентский id
уникальный id локального заведения;
можно использовать с Google Reviews API для получения полного списка отзывов
подробнее об идентификаторе — в этой статье справочного центра

contact_url
Тип: string | null

URL предпочтительной контактной страницы

contributor_url
Тип: string | null

URL профиля Local Guides пользователя или организации, если доступен

description
Тип: string | null

описание элемента в SERP
описание бизнес-сущности, для которой собираются результаты

directory
Тип: object | null · Response36Afe1097B20_BusinessDirectoryInfo

элементы каталога
включает информацию о компаниях, которые находятся в пределах целевого предприятия и имеют тот же адрес

items
Тип: array (object | null)[] | null

встреченные типы элементов
типы результатов поисковой системы, встречающиеся в массиве items;
возможные типы элементов: google_business_info

additional_categories
Тип: array string[] | null

дополнительные категории бизнеса
дополнительные категории Google My Business, которые подробнее описывают услуги, предоставляемые организацией

address
Тип: string | null

адрес бизнес-сущности

address_info
Тип: object | null · Response36Afe1097B20_AddressInfo

объект, содержащий компоненты адреса бизнес-сущности

address
Тип: string | null

адрес местного заведения

borough
Тип: string | null

административная единица или район, к которому относится местное заведение

city
Тип: string | null

название города, в котором находится местное заведение

country_code
Тип: string | null

код страны ISO местного заведения

region
Тип: string | null

регион DMA, к которому относится местное заведение

zip
Тип: string | null

почтовый индекс местного заведения

category
Тип: string | null

категория бизнеса
общая категория Google My Business, которая лучше всего описывает услуги, предоставляемые организацией

category_ids
Тип: array string[] | null

глобальные ID категорий
универсальные ID категорий, которые не меняются в зависимости от выбранной страны

cid
Тип: string | null

определённый Google клиентский id
уникальный id локального заведения;
можно использовать с Google Reviews API для получения полного списка отзывов
подробнее об идентификаторе — в этой статье справочного центра

domain
Тип: string | null

домен бизнес-сущности

feature_id
Тип: string | null

уникальный идентификатор элемента в SERP
подробнее об идентификаторе — в этой статье справочного центра

hotel_rating
Тип: string | null

классовый рейтинг отеля
классовые рейтинги варьируются от 1 до 5 звёзд, подробнее
если информации о классовом рейтинге отеля нет, значение будет null

is_claimed
Тип: boolean | null

показывает, подтверждена ли сущность её владельцем в Google Maps

is_directory_item
Тип: boolean | null

предприятие является частью каталога
указывает, является ли предприятие частью каталога;
если true, элемент является частью более крупного каталога компаний с тем же адресом (например, торгового центра или бизнес-центра);
примечание: если предприятие является родительским элементом в каталоге, значение будет null

latitude
Тип: number | null

координата широты местных заведений в google maps
пример:
"latitude": 51.584091

local_justifications
Тип: array string[] | null

локальные обоснования Google
текстовые фрагменты, которые «обосновывают», почему компания отображается по поисковому запросу

longitude
Тип: number | null

координата долготы местного заведения в google maps
пример:
"longitude": -0.31365919999999997

main_image
Тип: string | null

URL основного изображения в профиле Google My Business

phone
Тип: string | null

номер телефона бизнес-сущности

place_id
Тип: string | null

уникальный идентификатор места
place id местного заведения, представленного в элементе
Подробнее об идентификаторе — в этой статье справочного центра

price_level
Тип: string | null

уровень цен
может принимать значения: inexpensive, moderate, expensive, very_expensive
если информации об уровне цен нет, значение будет null

rank_absolute
Тип: integer | null

абсолютный рейтинг среди всех элементов

rank_group
Тип: integer | null

позиция внутри группы элементов с одинаковыми значениями type
позиции элементов с другими значениями type не учитываются в rank_group

rating
Тип: object | null · Response36Afe1097B20_RatingInfo

рейтинг элемента
показатель популярности на основе отзывов, отображаемый в SERP

rating_max
Тип: integer | null

максимальное значение для rating_type

rating_type
Тип: string | null

тип рейтинга здесь можно найти следующие элементы: Max5, Percents, CustomMax

value
Тип: number | null Формат: double

значение рейтинга

votes_count
Тип: integer | null Формат: int64

количество отзывов

rating_distribution
Тип: object | null

распределение рейтингов бизнес-сущности объект отображает количество оценок от 1 до 5 звёзд по отзывам пользователей

propertyName
Тип: integer | null Формат: Int64
snippet
Тип: string | null

дополнительная информация о бизнес-сущности

title
Тип: string | null

заголовок каталога
может принимать следующие значения: At this place, Directory

total_photos
Тип: string | null Формат: int64

общее количество изображений в профиле Google My Business

type
Тип: string | null

тип элемента

url
Тип: string | null

URL для просмотра меню

work_hours
Тип: object | null · Response36Afe1097B20_BusinessWorkHoursInfo

часы работы
информация о рабочих часах местного заведения

work_hours
Тип: object | null · Response36Afe1097B20_WorkHours

часы работы
информация о рабочих часах местного заведения

current_status
Тип: string | null

текущий статус заведения
указывает, открыто заведение или закрыто

timetable
Тип: object | null

график работы

propertyName
Тип: array (object | null)[] | null

часы работы в воскресенье

close
Тип: object | null · Response36Afe1097B20_TimeInfo

время закрытия

hour
Тип: integer | null

часы в 24-часовом формате

minute
Тип: integer | null

минуты

open
Тип: object | null · Response36Afe1097B20_TimeInfo

время открытия

hour
Тип: integer | null

часы в 24-часовом формате

minute
Тип: integer | null

минуты

title
Тип: string | null

заголовок элемента
домен системы онлайн-меню

domain
Тип: string | null

домен бизнес-сущности

feature_id
Тип: string | null

уникальный идентификатор элемента в SERP
подробнее об идентификаторе — в этой статье справочного центра

hotel_rating
Тип: number | null

классовый рейтинг отеля
классовые рейтинги варьируются от 1 до 5 звёзд, подробнее
если информации о классовом рейтинге отеля нет, значение будет null

is_claimed
Тип: boolean | null

показывает, подтверждена ли сущность её владельцем в Google Maps

is_directory_item
Тип: boolean | null

предприятие является частью каталога
указывает, является ли предприятие частью каталога;
если true, элемент является частью более крупного каталога компаний с тем же адресом (например, торгового центра или бизнес-центра);
примечание: если предприятие является родительским элементом в каталоге, значение будет null

latitude
Тип: number | null

координата широты местных заведений в google maps
пример:
"latitude": 51.584091

local_business_links
Тип: array (object | null)[] | null

доступные способы взаимодействия с бизнесом
список вариантов взаимодействия с бизнесом напрямую из результатов поиска

type
Тип: string | null

тип элемента

logo
Тип: string | null

URL логотипа, показанного в профиле Google My Business

longitude
Тип: number | null

координата долготы местного заведения в google maps
пример:
"longitude": -0.31365919999999997

main_image
Тип: string | null

URL основного изображения в профиле Google My Business

original_title
Тип: string | null

исходный заголовок элемента
исходный заголовок, не переведённый Google

people_also_search
Тип: array (object | null)[] | null

связанные бизнес-сущности

cid
Тип: string | null

идентификатор клиента, определённый Google
уникальный идентификатор локального заведения
подробнее об идентификаторе — в этой статье справочного центра

feature_id
Тип: string | null

уникальный идентификатор элемента в SERP
подробнее об идентификаторе — в этой статье справочного центра

rating
Тип: object | null · Response36Afe1097B20_RatingInfo

рейтинг элемента
показатель популярности на основе отзывов, отображаемый в SERP

rating_max
Тип: integer | null

максимальное значение для rating_type

rating_type
Тип: string | null

тип рейтинга здесь можно найти следующие элементы: Max5, Percents, CustomMax

value
Тип: number | null Формат: double

значение рейтинга

votes_count
Тип: integer | null Формат: int64

количество отзывов

title
Тип: string | null

заголовок элемента в SERP
название бизнес-сущности, для которой собираются результаты

phone
Тип: string | null

номер телефона бизнес-сущности

place_id
Тип: string | null

уникальный идентификатор места
place id местного заведения, представленного в элементе
Подробнее об идентификаторе — в этой статье справочного центра

place_topics
Тип: object | null

ключевые слова, упомянутые в отзывах клиентов
содержит самые популярные ключевые слова, связанные с продуктами и услугами, упомянутыми в отзывах клиентов о бизнес-сущности, и число отзывов, в которых упоминается каждое ключевое слово
пример:"place_topics": { "egg roll": 48, "birthday": 33 }

propertyName
Тип: integer | null Формат: int64

Signed 64-bit integers (long type).

popular_times
Тип: object | null · Response36Afe1097B20_PopularTimes

популярные часы
информация о часах высокой загрузки бизнес-сущности

popular_times_by_days
Тип: object | null

популярные часы
информация о загруженных часах локального заведения по каждому дню недели

propertyName
Тип: array (object | null)[] | null

часы работы в воскресенье

popular_index
Тип: integer | null

индекс популярности относительный привязанный ко времени индекс популярности от 0 до 100; более высокое значение соответствует более загруженному времени дня

time
Тип: object | null · Response36Afe1097B20_TimeInfo

часы в 24-часовом формате

hour
Тип: integer | null

часы в 24-часовом формате

minute
Тип: integer | null

минуты

position
Тип: string | null

выравнивание в SERP

price_level
Тип: string | null

уровень цен
может принимать значения: inexpensive, moderate, expensive, very_expensive
если информации об уровне цен нет, значение будет null

questions_and_answers_count
Тип: integer | null

Integer numbers.

rank_absolute
Тип: integer | null

абсолютный рейтинг среди всех элементов

rank_group
Тип: integer | null

позиция в группе элементов с одинаковыми значениями type
позиции элементов с другими значениями type исключаются из rank_group

rating
Тип: object | null · Response36Afe1097B20_RatingInfo

рейтинг элемента
показатель популярности на основе отзывов, отображаемый в SERP

rating_max
Тип: integer | null

максимальное значение для rating_type

rating_type
Тип: string | null

тип рейтинга здесь можно найти следующие элементы: Max5, Percents, CustomMax

value
Тип: number | null Формат: double

значение рейтинга

votes_count
Тип: integer | null Формат: int64

количество отзывов

rating_distribution
Тип: object | null

распределение рейтингов бизнес-сущности
объект показывает количество оценок от 1 до 5 звёзд по отзывам пользователей

propertyName
Тип: integer | null Формат: Int64
services
Тип: array (object | null)[] | null

список услуг, предлагаемых бизнесом

category
Тип: string | null

категория бизнеса
общая категория Google My Business, которая лучше всего описывает услуги, предоставляемые организацией

price
Тип: object | null · Response36Afe1097B20_PriceInfo
currency
Тип: string | null

валюта указанной цены ISO-код валюты, применяемой к цене

current
Тип: number | null Формат: double

текущая цена указывает текущую цену товара или услуги, представленных в результате

displayed_price
Тип: string | null

строка цены в результате исходная строка цены, как она предоставлена в результате

is_price_range
Тип: boolean | null

цена указана в виде диапазона указывает, предоставляется ли цена в виде диапазона

max_value
Тип: number | null Формат: double

максимальная цена максимальная цена товара или услуги, указанная в результате

regular
Тип: number | null Формат: double

обычная цена указывает обычную цену товара или услуги без скидок

snippet
Тип: string | null

дополнительная информация о бизнес-сущности

title
Тип: string | null

заголовок элемента в SERP
название бизнес-сущности, для которой собираются результаты

snippet
Тип: string | null

дополнительная информация о бизнес-сущности

title
Тип: string | null

заголовок элемента в SERP
название бизнес-сущности, для которой собираются результаты

total_photos
Тип: integer | null Формат: int64

общее количество изображений в профиле Google My Business

type
Тип: string | null

тип элемента

url
Тип: string | null

абсолютный URL бизнес-сущности

work_time
Тип: object | null · Response36Afe1097B20_BusinessWorkHoursInfo

сведения о рабочих часах
информация о часах работы бизнес-сущности

work_hours
Тип: object | null · Response36Afe1097B20_WorkHours

часы работы
информация о рабочих часах местного заведения

current_status
Тип: string | null

текущий статус заведения
указывает, открыто заведение или закрыто

timetable
Тип: object | null

график работы

propertyName
Тип: array (object | null)[] | null

часы работы в воскресенье

close
Тип: object | null · Response36Afe1097B20_TimeInfo

время закрытия

hour
Тип: integer | null

часы в 24-часовом формате

minute
Тип: integer | null

минуты

open
Тип: object | null · Response36Afe1097B20_TimeInfo

время открытия

hour
Тип: integer | null

часы в 24-часовом формате

minute
Тип: integer | null

минуты

items_count
Тип: integer | null Формат: int64

типы элементов
количество элементов в массиве items

keyword
Тип: string | null

ключевое слово, полученное в массиве POST
ключевое слово возвращается с декодированными %## (символ '+' будет декодирован в пробел)
это поле будет содержать параметр cid, если вы указали его в поле keyword при постановке задачи;
пример:
cid:2946633002421908862
Подробнее о параметре — в этой статье справочного центра

language_code
Тип: string | null

код языка в массиве POST

location_code
Тип: integer | null

код местоположения в массиве POST

se_domain
Тип: string | null

домен поисковой системы, указанный в массиве POST

result_count
Тип: integer | null Формат: int64

число элементов в массиве result

status_code
Тип: integer | null

код состояния задачи формируется DataForSEO, может находиться в диапазоне 10000-60000 Полный список кодов ответа можно найти здесь.

status_message
Тип: string | null

информационное сообщение задачи Полный список общих информационных сообщений можно найти здесь.

time
Тип: string | null

время выполнения, секунды

tasks_count
Тип: integer | null Формат: int64

число задач в массиве tasks

tasks_error
Тип: integer | null Формат: int64

число задач в массиве tasks, возвращённых с ошибкой

time
Тип: string | null

общее время выполнения, секунды

version
Тип: string | null

текущая версия API
application/json
400

Запрос не удалось обработать. Проверьте параметры запроса.
401

Требуется действительный API-ключ Felo.
402

Запрос не может быть выполнен: не выполнено требование биллинга.
403

Аккаунту не разрешено выполнять эту операцию.
429

Достигнут лимит запросов или расходов.
502

Сервис не смог выполнить запрос.
503

API или сервис биллинга временно недоступны.
504

Истекло время ожидания обработки запроса.
default

Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

application/json

get/v1/beta/dataforseo/business_data/google/my_business_info/task_get/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/my_business_info/task_get/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Показать схему

{
  "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]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Успешная операция

Нужна помощь?

По вопросам API, оплаты и аккаунта пишите в поддержку.
Общайтесь с разработчиками Felo в Discord.
Загляните в наш журнал изменений.
Нужны цены за объём или помощь с закупкой? Связаться с отделом продаж.
Создаёте на LLM? Прочитайте llms.txt.

Получение результатов Google My Business Info по id

АутентификацияRequired

DataForSEO

Получение результатов Google My Business Info по id

Справочные цены

Нужна помощь?