v0.2.0-beta

OpenAPI 3.1.0

Создание live-задач вопросов и ответов Google My Business

Felo API Support

MIT

Сервер

https://openapi.felo.ai

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

Shell Curl

DataForSEO

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

DataForSEO Операции

post/v1/beta/dataforseo/business_data/google/questions_and_answers/live

Создание live-задач вопросов и ответов Google My Business

Вопросы и ответы в профиле Google Business, найденные по keyword и location_code. Возвращает keyword, se_domain, location_code, language_code, check_url, datetime, cid, feature_id и item_types. Ответ обёрнут в конверт DataForSEO: данные в tasks[0].result, результат в tasks[0].status_code — отклонённый запрос всё равно возвращает HTTP 200.

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

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

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

Тело

application/json

Тип: array (object | null)[]
- depth
  Тип: integer | null
  
  глубина парсинга
  необязательное поле
  количество результатов в SERP
  значение по умолчанию: 20
  максимальное значение: 100
  С каждого SERP, содержащего до 20 результатов, с вашего аккаунта взимается плата;
  Установка глубины выше 20 может привести к дополнительным расходам, если поисковая система вернёт больше 20 результатов;
  Если указанная глубина превышает количество вопросов в ответе, разница будет автоматически возвращена на баланс аккаунта;
  Стоимость можно рассчитать на странице тарифов.
- keyword
  Тип: string
  
  ключевое слово
  обязательное поле
  указанное ключевое слово должно содержать название местного заведения
  в поле keyword можно указать до 700 символов
  все %## будут декодированы (символ «+» декодируется в пробел)
  если в keyword нужен символ «%», укажите его как «%25»;
  
  это поле также можно использовать для передачи следующих параметров:
  cid - уникальный идентификатор бизнес-сущности, заданный Google;
  place_id - идентификатор бизнес-сущности в Google Maps;
  
  пример:
  cid:194604053573767737
  place_id:GhIJQWDl0CIeQUARxks3icF8U8A
  
  Подробнее об идентификаторах cid и place_id — в этой статье Help Center
  
  Подробнее о правилах и ограничениях полей keyword и keywords в API DataForSEO читайте в этой статье Help Center
- language_code
  Тип: string
  
  код языка поисковой системы
  обязательное поле, если не указан language_name
  если используете это поле, language_name указывать не нужно
  список доступных языков с их language_code можно получить отдельным запросом к https://api.dataforseo.com/v3/business_data/google/languages
  пример:
  en
- language_name
  Тип: string
  
  полное название языка поисковой системы
  обязательное поле, если не указан language_code
  если используете это поле, language_code указывать не нужно
  список доступных языков с их language_name можно получить отдельным запросом к https://api.dataforseo.com/v3/business_data/google/languages
  пример:
  English
- location_code
  Тип: integer
  
  код местоположения поисковой системы
  обязательное поле, если не указаны location_name или location_coordinate
  если используется это поле, location_name или location_coordinate указывать не нужно
  список доступных местоположений с location_code можно получить отдельным запросом к https://api.dataforseo.com/v3/business_data/google/locations
  пример:
  2840
- location_coordinate
  Тип: string
  
  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_name
  Тип: string
  
  полное название местоположения поисковой системы
  обязательное поле, если не указаны 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 ответа

Ответы

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

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

status_code
Тип: integer | null

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

status_message
Тип: string | null

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

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

массив задач

Тип: object | null · Response36Afe1097B20_BusinessDataGoogleQuestionsAndAnswersLiveTaskInfo
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 к результатам поисковой системы
с его помощью можно убедиться, что мы предоставили точные результаты

cid
Тип: string | null

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

datetime
Тип: string | null

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

feature_id
Тип: string | null

уникальный идентификатор функции SERP

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

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

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

массив элементов
элементы внутри google_business_question_item

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

массив элементов
элементы внутри google_business_question_item

answer_id
Тип: string | null

ID ответа

answer_text
Тип: string | null

текущий текст ответа

original_answer_text
Тип: string | null

исходный текст ответа

profile_image_url
Тип: string | null

URL изображения профиля пользователя

profile_name
Тип: string | null

отображаемое имя пользователя

profile_url
Тип: string | null

URL профиля пользователя

time_ago
Тип: string | null

оценочное время публикации ответа

timestamp
Тип: string | null

точное время публикации ответа

type
Тип: string | null

тип элемента

original_question_text
Тип: string | null

исходный текст вопроса

profile_image_url
Тип: string | null

URL изображения профиля пользователя

profile_name
Тип: string | null

отображаемое имя пользователя

profile_url
Тип: string | null

URL профиля пользователя

question_id
Тип: string | null

ID вопроса

question_text
Тип: string | null

текущий текст вопроса

rank_absolute
Тип: integer | null

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

rank_group
Тип: integer | null

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

time_ago
Тип: string | null

предполагаемое время публикации вопроса

timestamp
Тип: string | null

точное время публикации вопроса

type
Тип: string | null

тип элемента

url
Тип: string | null

URL вопроса

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

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

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

массив элементов вопросов Google Business без ответов

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

массив элементов
элементы внутри google_business_question_item

answer_id
Тип: string | null

ID ответа

answer_text
Тип: string | null

текущий текст ответа

original_answer_text
Тип: string | null

исходный текст ответа

profile_image_url
Тип: string | null

URL изображения профиля пользователя

profile_name
Тип: string | null

отображаемое имя пользователя

profile_url
Тип: string | null

URL профиля пользователя

time_ago
Тип: string | null

оценочное время публикации ответа

timestamp
Тип: string | null

точное время публикации ответа

type
Тип: string | null

тип элемента

original_question_text
Тип: string | null

исходный текст вопроса

profile_image_url
Тип: string | null

URL изображения профиля пользователя

profile_name
Тип: string | null

отображаемое имя пользователя

profile_url
Тип: string | null

URL профиля пользователя

question_id
Тип: string | null

ID вопроса

question_text
Тип: string | null

текущий текст вопроса

rank_absolute
Тип: integer | null

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

rank_group
Тип: integer | null

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

time_ago
Тип: string | null

предполагаемое время публикации вопроса

timestamp
Тип: string | null

точное время публикации вопроса

type
Тип: string | null

тип элемента

url
Тип: string | null

URL вопроса

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

post/v1/beta/dataforseo/business_data/google/questions_and_answers/live

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/questions_and_answers/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_name": "Los Angeles,California,United States",
    "keyword": "The Last Bookstore"
  }
]'

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

{
  "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,
          "cid": null,
          "feature_id": null,
          "item_types": [
            null
          ],
          "items_without_answers": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "question_id": null,
              "url": null,
              "profile_image_url": null,
              "profile_url": null,
              "profile_name": null,
              "question_text": null,
              "original_question_text": null,
              "time_ago": null,
              "timestamp": null,
              "items": [
                "[Max Depth Exceeded]"
              ]
            }
          ],
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "question_id": null,
              "url": null,
              "profile_image_url": null,
              "profile_url": null,
              "profile_name": null,
              "question_text": null,
              "original_question_text": null,
              "time_ago": null,
              "timestamp": null,
              "items": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

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

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

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

Создание live-задач вопросов и ответов Google My Business

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

DataForSEO

Создание live-задач вопросов и ответов Google My Business

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

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