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

клієнтський id, визначений Google
унікальний 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

клієнтський id, визначений Google
унікальний 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

Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника

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

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

Отримання результатів Google My Business Info за id

АвтентифікаціяRequired

DataForSEO

Отримання результатів Google My Business Info за id

Довідкові ціни