v0.2.0-beta

OpenAPI 3.1.0

Live-результаты Google Local Finder SERP в HTML

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/serp/google/local_finder/live/html

Live-результаты Google Local Finder SERP в HTML

Синхронно возвращает расширенные локальные результаты, которые Google показывает, когда запрос явно локальный. Это необработанный исходный код страницы, а не разобранные результаты. Обёрнуто в конверт DataForSEO: данные в tasks[0].result, результат в tasks[0].status_code — отклонённый запрос всё равно возвращает HTTP 200.

Справочная информация о ценах

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

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

Тело

application/json

Тип: array (object | null)[]
- depth
  Тип: integer | null
  
  глубина парсинга
  
  необязательное поле
  
  количество результатов в SERP
  
  значение по умолчанию: 10
  
  максимальное значение: 100
  
  С каждого SERP, содержащего до 10 результатов, с вашего аккаунта взимается плата;
  Установка глубины выше 10 может привести к дополнительным расходам, если поисковая система вернёт больше 10 результатов;
  
  Если указанная глубина превышает количество результатов в ответе, разница автоматически возвращается на баланс вашего аккаунта
  
  Стоимость можно рассчитать на странице тарифов.
- device
  Тип: string | null
  
  тип устройства
  
  необязательное поле
  
  возвращать результаты для определённого типа устройства
  
  может принимать значения:desktop, mobile
  
  значение по умолчанию: desktop
- keyword
  Тип: string
  
  ключевое слово
  
  обязательное поле
  
  в поле keyword можно указать до 700 символов
  
  все %## будут декодированы (символ «+» декодируется в пробел)
  
  если в keyword нужен символ «%», укажите его как «%25»;
  
  если в keyword нужен символ «+», укажите его как «%2B»
- language_code
  Тип: string
  
  код языка поисковой системы
  
  обязательное поле, если не указан language_name
  
  если используете это поле, language_name указывать не нужно
  
  список доступных языков поисковой системы и их language_code можно получить отдельным запросом к https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
  
  пример:en
- language_name
  Тип: string
  
  полное название языка поисковой системы
  
  обязательное поле, если не указан language_code
  
  если используете это поле, language_code указывать не нужно
  
  список доступных языков поисковой системы и их language_name можно получить отдельным запросом к https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
  
  пример:
  
  English
- location_code
  Тип: integer
  
  код местоположения поисковой системы
  
  обязательное поле, если не указаны location_name или location_coordinate
  
  если используете это поле, location_name или location_coordinate указывать не нужно
  
  список доступных местоположений поисковых систем и их location_code можно получить отдельным запросом к https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
  
  пример:
  
  2840
- location_coordinate
  Тип: string
  
  GPS-координаты местоположения
  
  обязательное поле, если не указаны location_name или location_code
  
  если используете это поле, location_name или location_code указывать не нужно
  
  параметр location_coordinate нужно указывать в формате "latitude,longitude,zoom"
  
  если "zoom" не указан, по умолчанию применяется 9z
  
  максимальное число десятичных знаков для "latitude" и "longitude": 7
  
  минимальное значение для "zoom": 4z
  
  максимальное значение для "zoom": 18z
  
  пример:
  
  52.6178549,-155.352142,20z
- location_name
  Тип: string
  
  полное название местоположения поисковой системы
  
  обязательное поле, если не указаны location_code или location_coordinate
  
  если используете это поле, location_code или location_coordinate указывать не нужно
  
  список доступных местоположений поисковой системы с их location_name можно получить отдельным запросом к https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
  
  пример:
  
  London,England,United Kingdom
- min_rating
  Тип: string | null
  
  фильтрация результатов по минимальному рейтингу
  
  необязательное поле
  
  возможные значения для desktop: 3.5, 4, 4.5;
  
  возможные значения для mobile: 2, 2.5, 3, 3.5, 4, 4.5
- os
  Тип: string | null
  
  операционная система устройства
  
  необязательное поле
  
  если desktop указан в поле device, выбирайте из значений: windows, macos
  
  значение по умолчанию: windows
  
  если mobile указан в поле device, выбирайте из значений: android, ios
  
  значение по умолчанию: android
- tag
  Тип: string | null
  
  пользовательский идентификатор задачи
  
  необязательное поле
  
  ограничение — 255 символов
  
  этот параметр позволяет идентифицировать задачу и сопоставить её с результатом
  
  указанное значение tag вы найдёте в объекте data ответа
- time_filter
  Тип: string | null
  
  фильтрация результатов по часам работы
  
  необязательное поле
  
  с помощью этого поля можно фильтровать места в результатах по времени, когда место открыто для посетителей
  
  учтите, что Google также может предоставлять результаты, не соответствующие этому фильтру
  
  возможные значения: "open_now", "24_hours", "$day_value", "$day_value;$time_value";
  
  вместо $day_value используйте одно из следующих значений: "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday";
  
  вместо $time_value используйте одно из следующих значений: "00", "01", "02", "03", "04", "05", "06", "07", "08", "09", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23"
  
  пример: "tuesday;18"

Ответы

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

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

status_code
Тип: integer | null

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

status_message
Тип: string | null

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

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

массив задач

Тип: object | null · Response36Afe1097B20_SerpGoogleLocalFinderLiveHtmlTaskInfo
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

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

datetime
Тип: string | null

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

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

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

date
Тип: string | null

дата и время сканирования HTML-страницы
в формате UTC: “yyyy-mm-dd hh-mm-ss +00:00”
пример:
2019-11-15 12:57:46 +00:00

html
Тип: string | null

HTML страница

page
Тип: integer | null

порядковый номер возвращённой HTML-страницы

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

количество результатов, возвращённых в массиве items

keyword
Тип: string | null

ключевое слово, полученное в POST-массиве
ключевое слово возвращается с декодированным %## (символ '+' будет декодирован как пробел)

language_code
Тип: string | null

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

location_code
Тип: integer | null

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

se_domain
Тип: string | null

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

type
Тип: string | null

тип элемента

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/serp/google/local_finder/live/html

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/local_finder/live/html \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein"
  }
]'

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

{
  "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,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "page": null,
              "date": null,
              "html": null
            }
          ]
        }
      ]
    }
  ]
}

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

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

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

Live-результаты Google Local Finder SERP в HTML

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

DataForSEO

Live-результаты Google Local Finder SERP в HTML

Справочная информация о ценах

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