Створення live-завдань Google My Business Info
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Створення live-завдань Google My Business Info
Один профіль Google Business: назва, адреса, телефон, години роботи, рейтинг, категорія й атрибути, які Google показує на панелі. Відповідь обгорнуто в конверт DataForSEO: дані в tasks[0].result, результат у tasks[0].status_code — відхилений запит усе одно повертає HTTP 200. Близнюк через чергу — post_dataforseo_business_google_gmb_info_submit. Для недавніх публікацій власника використовуйте post_dataforseo_business_google_gmb_updates_submit, а для думок клієнтів — post_dataforseo_business_google_reviews_submit.
Довідкові ціни
- Тарифікація: вартість відповіді за даними постачальника.
- Довідкова оцінка запиту: USD 0.0054.
- Довідковий множник для клієнта: 1.0. Не застосовуйте його повторно до вже розрахованої суми клієнта.
Лише довідкові метадані, а не котирування для облікового запису, гарантована ціна чи ліміт витрат. Кредити ресурсів — це не кредити Felo. Остаточні списання здійснюються за записами білінгу Felo.
- Тип: array (object | null)[]
- keywordТип: string
ключове слово
обов'язкове поле
вказане ключове слово має містити назву місцевого закладу
у поліkeywordможна вказати до 700 символів
усі %## буде декодовано (символ «+» декодується в пробіл)
якщо вkeywordпотрібен символ «%», вкажіть його як «%25»;це поле також можна використовувати для передавання таких параметрів:
cid- унікальний ідентифікатор бізнес-сутності, визначений Google;place_id- ідентифікатор бізнес-сутності в Google Maps;приклад:
cid:194604053573767737place_id:GhIJQWDl0CIeQUARxks3icF8U8AДокладніше про ідентифікатори
cidіplace_id— у цій статті Help CenterДокладніше про правила й обмеження полів
keywordіkeywordsв API DataForSEO читайте в цій статті Help Center - languageТип: string
_code код мови пошукової системи
обов'язкове поле, якщо не вказаноlanguage_name
якщо використовуєте це поле,language_nameвказувати не потрібно
список доступних мов з їхнімlanguage_codeможна отримати окремим запитом доhttps://api.dataforseo.com/v3/business_data/google/languages
приклад:en - languageТип: string
_name повна назва мови пошукової системи
обов'язкове поле, якщо не вказаноlanguage_code
якщо використовуєте це поле,language_codeвказувати не потрібно
список доступних мов з їхньоюlanguage_nameможна отримати окремим запитом доhttps://api.dataforseo.com/v3/business_data/google/languages
приклад:English - locationТип: integer
_code код місцеположення пошукової системи
обов'язкове поле, якщо не вказаноlocation_nameабоlocation_coordinate
якщо використовується це поле,location_nameабоlocation_coordinateвказувати не потрібно
список доступних місцеположень ізlocation_codeможна отримати окремим запитом доhttps://api.dataforseo.com/v3/business_data/google/locations
приклад:2840 - locationТип: string
_coordinate GPS-координати місцезнаходження
обов'язкове поле, якщо не вказаноlocation_nameабоlocation_code
якщо використовуєте це поле,location_nameабоlocation_codeвказувати не потрібно
параметрlocation_coordinateмає бути вказаний у форматі "latitude,longitude,radius"
максимальна кількість десяткових цифр для "latitude" і "longitude": 7
мінімальне значення для "radius": 199.9 (мм)
максимальне значення для "radius": 199999 (мм)
приклад:53.476225,-2.243572,200 - locationТип: string
_name повна назва місцезнаходження пошукової системи
обов'язкове поле, якщо не вказаноlocation_codeабоlocation_coordinate
якщо використовуєте це поле,location_codeабоlocation_coordinateвказувати не потрібно
список доступних місцезнаходжень з їхнімlocation_nameможна отримати окремим запитом доhttps://api.dataforseo.com/v3/business_data/google/locations
приклад:London,England,United Kingdom - tagТип: string | null
визначений користувачем ідентифікатор завдання
необов'язкове поле
обмеження — 255 символів
цей параметр дає змогу ідентифікувати завдання й зіставити його з результатом
вказане значенняtagви знайдете в об'єктіdataвідповіді
- Тип: object | null · Response36Afe1097B20_BusinessDataGoogleMyBusinessInfoLiveResponseInfo200
- Тип: number | null Формат: doublecost
загальна вартість завдань, USD
- Тип: integer | nullstatus
_code загальний код стану. Повний список кодів відповіді можна знайти тут.
- Тип: string | nullstatus
_message загальне інформаційне повідомлення. Повний список загальних інформаційних повідомлень можна знайти тут.
- Тип: array (object | null)[] | nulltasks
масив завдань
- Тип: object | null · Response36Afe1097B20_BusinessDataGoogleMyBusinessInfoLiveTaskInfo
- costТип: number | null Формат: double
загальна вартість завдань, USD
- dataТип: object | null
містить ті самі параметри, які ви вказали в POST-запиті
- propertyТип: object | null
Name
- idТип: string | null
ідентифікатор завдання унікальний ідентифікатор завдання в нашій системі у форматі UUID
- pathТип: array (string | null)[] | null
шлях URL
- resultТип: array (object | null)[] | null
масив результатів
- checkТип: string | null
_url прямий URL до результатів пошукової системи
за його допомогою можна переконатися, що ми надали точні результати - datetimeТип: string | null
дата й час отримання результату
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:2019-11-15 12:57:46 +00:00 - itemТип: array (string | null)[] | null
_types типи елементів
типи результатів пошукової системи, що трапляються в масивіitems;
можливі типи елементів:google_business_info - itemsТип: array (object | null)[] | null
виявлені типи елементів
типи результатів пошукової системи, що трапляються в масивіitems;
можливі типи елементів:google_business_info- additionalТип: array string[] | null
_categories додаткові категорії бізнесу
додаткові категорії Google My Business, які докладніше описують послуги, що надає організація - addressТип: string | null
адреса бізнес-сутності
- addressТип: object | null · Response36Afe1097B20_AddressInfo
_info об'єкт, що містить компоненти адреси бізнес-сутності
- addressТип: string | null
адреса місцевого закладу
- boroughТип: string | null
адміністративна одиниця або район, до якого належить місцевий заклад
- cityТип: string | null
назва міста, у якому розташований місцевий заклад
- countryТип: string | null
_code код країни ISO місцевого закладу
- regionТип: string | null
регіон DMA, до якого належить місцевий заклад
- zipТип: string | null
поштовий індекс місцевого закладу
- attributesТип: object | null · Response36Afe1097B20_BusinessDataAttributesInfo
відомості про послуги у вигляді пунктів, перевірених користувачами;
відомості про послуги бізнес-сутності, показані у вигляді пунктів і на основі відгуків користувачів іcategoryбізнесу- availableТип: object | null
_attributes доступні атрибути
указує атрибути, які може надати бізнес-сутність- propertyТип: array (string | null)[] | null
Name
- unavailableТип: object | null
_attributes недоступні атрибути
указує атрибути, які бізнес-сутність не може надати- propertyТип: array (string | null)[] | null
Name
- bookТип: string | null
_online _url URL кнопки 'book online' елемента
URL, що скеровує користувачів на сторінку онлайн-бронювання або замовлення організації - categoryТип: string | null
категорія бізнесу
загальна категорія Google My Business, яка найкраще описує послуги, що надає організація - categoryТип: array string[] | null
_ids глобальні ID категорій
універсальні ID категорій, які не змінюються залежно від вибраної країни - cidТип: string | null
- contactТип: string | null
_url URL бажаної контактної сторінки
- contributorТип: string | null
_url URL профілю Local Guides користувача або організації, якщо доступний
- descriptionТип: string | null
опис елемента в SERP
опис бізнес-сутності, для якої збираються результати - directoryТип: object | null · Response36Afe1097B20_BusinessDirectoryInfo
елементи каталогу
містить інформацію про компанії, які розташовані в межах цільового підприємства та мають ту саму адресу- itemsТип: array (object | null)[] | null
виявлені типи елементів
типи результатів пошукової системи, що трапляються в масивіitems;
можливі типи елементів:google_business_info- additionalТип: array string[] | null
_categories додаткові категорії бізнесу
додаткові категорії Google My Business, які докладніше описують послуги, що надає організація - addressТип: string | null
адреса бізнес-сутності
- addressТип: object | null · Response36Afe1097B20_AddressInfo
_info об'єкт, що містить компоненти адреси бізнес-сутності
- addressТип: string | null
адреса місцевого закладу
- boroughТип: string | null
адміністративна одиниця або район, до якого належить місцевий заклад
- cityТип: string | null
назва міста, у якому розташований місцевий заклад
- countryТип: string | null
_code код країни ISO місцевого закладу
- regionТип: string | null
регіон DMA, до якого належить місцевий заклад
- zipТип: string | null
поштовий індекс місцевого закладу
- categoryТип: string | null
категорія бізнесу
загальна категорія Google My Business, яка найкраще описує послуги, що надає організація - categoryТип: array string[] | null
_ids глобальні ID категорій
універсальні ID категорій, які не змінюються залежно від вибраної країни - cidТип: string | null
- domainТип: string | null
домен бізнес-сутності
- featureТип: string | null
_id - hotelТип: string | null
_rating - isТип: boolean | null
_claimed показує, чи підтверджена сутність її власником у Google Maps
- isТип: boolean | null
_directory _item підприємство є частиною каталогу
вказує, чи є підприємство частиною каталогу;
якщоtrue, елемент є частиною більшого каталогу компаній із тією самою адресою (наприклад, торгового центру або бізнес-центру);
примітка: якщо підприємство є батьківським елементом у каталозі, значення будеnull - latitudeТип: number | null
координата широти місцевих закладів у google maps
приклад:"latitude": 51.584091 - localТип: array string[] | null
_justifications локальні обґрунтування Google
текстові фрагменти, які «обґрунтовують», чому компанія відображається за пошуковим запитом - longitudeТип: number | null
координата довготи місцевого закладу в google maps
приклад:"longitude": -0.31365919999999997 - mainТип: string | null
_image URL основного зображення в профілі Google My Business
- phoneТип: string | null
номер телефону бізнес-сутності
- placeТип: string | null
_id унікальний ідентифікатор місця
place id місцевого закладу, представленого в елементі
Докладніше про ідентифікатор — у цій статті довідкового центру - priceТип: string | null
_level рівень цін
може набувати значень:inexpensive,moderate,expensive,very_expensive
якщо інформації про рівень цін немає, значення будеnull - rankТип: integer | null
_absolute абсолютний рейтинг серед усіх елементів
- rankТип: integer | null
_group позиція всередині групи елементів з однаковими значеннями
type
позиції елементів з іншими значеннямиtypeне враховуються вrank_group - ratingТип: object | null · Response36Afe1097B20_RatingInfo
рейтинг елемента
показник популярності на основі відгуків, що відображається в SERP- ratingТип: integer | null
_max максимальне значення для rating_type
- ratingТип: string | null
_type тип рейтингу тут можна знайти такі елементи: Max5, Percents, CustomMax
- valueТип: number | null Формат: double
значення рейтингу
- votesТип: integer | null Формат: int64
_count кількість відгуків
- ratingТип: object | null
_distribution розподіл рейтингів бізнес-сутності об'єкт відображає кількість оцінок від 1 до 5 зірок за відгуками користувачів
- propertyТип: integer | null Формат: Int64
Name
- snippetТип: string | null
додаткова інформація про бізнес-сутність
- titleТип: string | null
заголовок каталогу
може набувати таких значень:At this place,Directory - totalТип: string | null Формат: int64
_photos загальна кількість зображень у профілі Google My Business
- typeТип: string | null
тип елемента
- urlТип: string | null
URL для перегляду меню
- workТип: object | null · Response36Afe1097B20_BusinessWorkHoursInfo
_hours години роботи
інформація про робочі години місцевого закладу- workТип: object | null · Response36Afe1097B20_WorkHours
_hours години роботи
інформація про робочі години місцевого закладу- currentТип: string | null
_status поточний статус закладу
вказує, чи заклад відчинено чи зачинено - timetableТип: object | null
графік роботи
- propertyТип: array (object | null)[] | null
Name години роботи в неділю
- 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Тип: string | null
_id - hotelТип: number | null
_rating - isТип: boolean | null
_claimed показує, чи підтверджена сутність її власником у Google Maps
- isТип: boolean | null
_directory _item підприємство є частиною каталогу
вказує, чи є підприємство частиною каталогу;
якщоtrue, елемент є частиною більшого каталогу компаній із тією самою адресою (наприклад, торгового центру або бізнес-центру);
примітка: якщо підприємство є батьківським елементом у каталозі, значення будеnull - latitudeТип: number | null
координата широти місцевих закладів у google maps
приклад:"latitude": 51.584091 - localТип: array (object | null)[] | null
_business _links доступні способи взаємодії з бізнесом
список варіантів взаємодії з бізнесом безпосередньо з результатів пошуку- typeТип: string | null
тип елемента
- logoТип: string | null
URL логотипа, показаного в профілі Google My Business
- longitudeТип: number | null
координата довготи місцевого закладу в google maps
приклад:"longitude": -0.31365919999999997 - mainТип: string | null
_image URL основного зображення в профілі Google My Business
- originalТип: string | null
_title вихідний заголовок елемента
вихідний заголовок, не перекладений Google - peopleТип: array (object | null)[] | null
_also _search пов'язані бізнес-сутності
- cidТип: string | null
- featureТип: string | null
_id - ratingТип: object | null · Response36Afe1097B20_RatingInfo
рейтинг елемента
показник популярності на основі відгуків, що відображається в SERP- ratingТип: integer | null
_max максимальне значення для rating_type
- ratingТип: string | null
_type тип рейтингу тут можна знайти такі елементи: Max5, Percents, CustomMax
- valueТип: number | null Формат: double
значення рейтингу
- votesТип: integer | null Формат: int64
_count кількість відгуків
- titleТип: string | null
заголовок елемента в SERP
назва бізнес-сутності, для якої збираються результати
- phoneТип: string | null
номер телефону бізнес-сутності
- placeТип: string | null
_id унікальний ідентифікатор місця
place id місцевого закладу, представленого в елементі
Докладніше про ідентифікатор — у цій статті довідкового центру - placeТип: object | null
_topics ключові слова, згадані у відгуках клієнтів
містить найпопулярніші ключові слова, пов'язані з продуктами та послугами, згаданими у відгуках клієнтів про бізнес-сутність, і кількість відгуків, у яких згадується кожне ключове слово
приклад:
"place_topics": {
"egg roll": 48,
"birthday": 33
}- propertyТип: integer | null Формат: int64
Name Signed 64-bit integers (long type).
- popularТип: object | null · Response36Afe1097B20_PopularTimes
_times популярні години
інформація про години високого навантаження бізнес-сутності- popularТип: object | null
_times _by _days популярні години
інформація про завантажені години локального закладу для кожного дня тижня- propertyТип: array (object | null)[] | null
Name години роботи в неділю
- popularТип: integer | null
_index індекс популярності відносний прив'язаний до часу індекс популярності від 0 до 100; вище значення відповідає більш завантаженому часу дня
- timeТип: object | null · Response36Afe1097B20_TimeInfo
години в 24-годинному форматі
- hourТип: integer | null
години в 24-годинному форматі
- minuteТип: integer | null
хвилини
- positionТип: string | null
вирівнювання в SERP
- priceТип: string | null
_level рівень цін
може набувати значень:inexpensive,moderate,expensive,very_expensive
якщо інформації про рівень цін немає, значення будеnull - questionsТип: integer | null
_and _answers _count Integer numbers.
- rankТип: integer | null
_absolute абсолютний рейтинг серед усіх елементів
- rankТип: integer | null
_group позиція в групі елементів з однаковими значеннями
type
позиції елементів з іншими значеннямиtypeвиключаються зrank_group - ratingТип: object | null · Response36Afe1097B20_RatingInfo
рейтинг елемента
показник популярності на основі відгуків, що відображається в SERP- ratingТип: integer | null
_max максимальне значення для rating_type
- ratingТип: string | null
_type тип рейтингу тут можна знайти такі елементи: Max5, Percents, CustomMax
- valueТип: number | null Формат: double
значення рейтингу
- votesТип: integer | null Формат: int64
_count кількість відгуків
- ratingТип: object | null
_distribution розподіл рейтингів бізнес-сутності
об'єкт показує кількість оцінок від 1 до 5 зірок за відгуками користувачів- propertyТип: integer | null Формат: Int64
Name
- 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Тип: string | null
_price рядок ціни в результаті вихідний рядок ціни, як надано в результаті
- isТип: boolean | null
_price _range ціна надана як діапазон указує, чи надається ціна як діапазон
- maxТип: number | null Формат: double
_value максимальна ціна максимальна ціна товару або послуги, зазначена в результаті
- regularТип: number | null Формат: double
звичайна ціна указує звичайну ціну товару або послуги без знижок
- snippetТип: string | null
додаткова інформація про бізнес-сутність
- titleТип: string | null
заголовок елемента в SERP
назва бізнес-сутності, для якої збираються результати
- snippetТип: string | null
додаткова інформація про бізнес-сутність
- titleТип: string | null
заголовок елемента в SERP
назва бізнес-сутності, для якої збираються результати - totalТип: integer | null Формат: int64
_photos загальна кількість зображень у профілі Google My Business
- typeТип: string | null
тип елемента
- urlТип: string | null
абсолютний URL бізнес-сутності
- workТип: object | null · Response36Afe1097B20_BusinessWorkHoursInfo
_time відомості про робочі години
інформація про години роботи бізнес-сутності- workТип: object | null · Response36Afe1097B20_WorkHours
_hours години роботи
інформація про робочі години місцевого закладу- currentТип: string | null
_status поточний статус закладу
вказує, чи заклад відчинено чи зачинено - timetableТип: object | null
графік роботи
- propertyТип: array (object | null)[] | null
Name години роботи в неділю
- 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Тип: integer | null Формат: int64
_count типи елементів
кількість елементів у масивіitems - keywordТип: string | null
ключове слово, отримане в масиві POST
ключове слово повертається з декодованими %## (символ '+' буде декодовано в пробіл)
це поле міститиме параметрcid, якщо ви вказали його в поліkeywordпід час постановки завдання;
приклад:cid:2946633002421908862
Докладніше про параметр — у цій статті довідкового центру - languageТип: string | null
_code код мови в масиві POST
- locationТип: integer | null
_code код місцеположення в масиві POST
- seТип: string | null
_domain домен пошукової системи, указаний у масиві POST
- resultТип: integer | null Формат: int64
_count кількість елементів у масиві result
- statusТип: integer | null
_code код стану завдання формується DataForSEO, може перебувати в діапазоні 10000-60000 Повний список кодів відповіді можна знайти тут.
- statusТип: string | null
_message інформаційне повідомлення завдання Повний список загальних інформаційних повідомлень можна знайти тут.
- timeТип: string | null
час виконання, секунди
- Тип: integer | null Формат: int64tasks
_count кількість завдань у масиві tasks
- Тип: integer | null Формат: int64tasks
_error кількість завдань у масиві tasks, повернутих з помилкою
- Тип: string | nulltime
загальний час виконання, секунди
- Тип: string | nullversion
поточна версія API
application/json - 400
Не вдалося обробити запит. Перевірте параметри запиту.
- 401
Потрібен дійсний API-ключ Felo.
- 402
Запит неможливо виконати: умови білінгу не виконано.
- 403
Обліковий запис не має дозволу на цю операцію.
- 429
Досягнуто ліміту запитів або витрат.
- 502
Служба не змогла виконати запит.
- 503
API або служба білінгу тимчасово недоступні.
- 504
Час очікування обробки запиту вичерпано.
- default
Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника
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]"
]
}
]
}
]
}
]
}