v0.2.0-beta

OpenAPI 3.1.0

Создание задач Google Hotel Info

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/hotel_info/task_post

Создание задач Google Hotel Info

Ставит в очередь поиск листинга отеля и возвращает id задачи. Ответ обёрнут в конверт DataForSEO: данные в tasks[0].result, результат в tasks[0].status_code — отклонённый запрос всё равно возвращает HTTP 200. Получайте разобранный результат через get_dataforseo_business_google_hotel_info_fetch, необработанный — через get_dataforseo_business_google_hotel_info_fetch_html.

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

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

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

Тело

application/json

Тип: array (object | null)[]
- adults
  Тип: integer | null
  
  количество взрослых
  необязательное поле
  если не указать это поле, по умолчанию будут использованы два взрослых
  пример:
  1
- check_in
  Тип: string | null
  
  дата заезда
  необязательное поле
  если не указать это поле, по умолчанию будет использована завтрашняя дата;
  значение не должно быть раньше сегодняшней даты
  формат даты: "yyyy-mm-dd"
  пример:
  "2019-01-15"
- check_out
  Тип: string | null
  
  дата выезда
  необязательное поле
  если не указать это поле, система по умолчанию применит дату через два дня;
  Примечание: значение не может быть меньше или равно check_in;
  диапазон между значениями check_in и check_out не может превышать 30 дней
  формат даты: "yyyy-mm-dd"
  пример:
  "2019-01-15"
- children
  Тип: array string[] | null
  
  количество и возраст детей
  необязательное поле
  если не указать это поле, дети не будут включены в поиск;
  
  укажите следующее значение, чтобы включить одного ребёнка 14 лет:
  [14]
  укажите следующее значение, чтобы включить одного ребёнка 13 лет и одного ребёнка 8 лет:
  [13,8]
- currency
  Тип: string | null
  
  валюта
  необязательное поле
  пример:
  "USD"
- hotel_identifier
  Тип: string
  
  уникальный идентификатор отеля
  обязательное поле, если не указан keyword
  если используете это поле, keyword указывать не нужно
  уникальный идентификатор объекта «отель» в поиске Google;
  значение можно получить, отправив запрос к Advanced Google SERP API (оно содержится в элементе hotels_pack ответа) или к эндпоинту Hotel Searches Business Data API
  пример:
  ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE
- keyword
  Тип: string
  
  ключевое слово
  обязательное поле, если не указан hotel_identifier
  если используете это поле, hotel_identifier указывать не нужно
  указанное ключевое слово должно содержать название объекта «отель»
  в поле keyword можно указать до 700 символов
  все %## будут декодированы (символ «+» декодируется в пробел)
  если в keyword нужен символ «%», укажите его как «%25»
- 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
- load_prices_by_dates
  Тип: boolean | null
  
  загрузка цен на проживание в отеле по датам
  необязательное поле
  если указать этот параметр со значением true, ответ будет содержать массив prices_by_dates с ценами на проживание, разбитыми по датам
  при использовании этого параметра взимается двойная базовая стоимость запроса
- 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"
  максимальное число десятичных знаков для "latitude" и "longitude": 7
  Примечание: если координаты используются для задания местоположения, поиск выполняется в ближайшем населённом пункте;
  пример:
  53.476225,-2.243572
- 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
- pingback_url
  Тип: string | null
  
  URL уведомления о завершении задачи
  необязательное поле
  когда задача будет выполнена, мы отправим GET-запрос на указанный вами URL;
  строку «$id» можно использовать как переменную $id, а «$tag» — как urlencoded-переменную $tag;
  перед отправкой запроса мы подставим нужные значения;
  пример:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Примечание: специальные символы в pingback_url будут urlencoded;
  в частности, символ # будет закодирован как %23
  
  Подробнее — в Help Center
- postback_data
  Тип: string
  
  тип данных postback_url
  обязательное поле, если указан postback_url
  соответствует типу данных, который будет отправлен на ваш сервер
  возможные значения:
  advanced, html
- postback_url
  Тип: string | null
  
  URL для отправки результатов задачи
  необязательное поле
  после завершения задачи мы отправим POST-запрос с её результатами, сжатыми в формате gzip, на указанный вами postback_url;
  строку «$id» можно использовать как переменную $id, а «$tag» — как urlencoded-переменную $tag. Перед отправкой запроса мы подставим нужные значения;
  пример:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  Примечание: специальные символы в postback_url будут urlencoded;
  в частности, символ # будет закодирован как %23
  
  Подробнее — в Help Center
- prices_date_range
  Тип: string | null
  
  предопределённый период для получения данных о ценах по дням
  необязательное поле
  чтобы использовать этот параметр, необходимо указать load_prices_by_dates со значением true
  если prices_start_date не указан, дата начала устанавливается равной дате check_in
  возможные значения: month, three_months, six_months, year
  значение по умолчанию: month
- prices_end_date
  Тип: string | null
  
  дата окончания загрузки цен по датам
  необязательное поле
  чтобы использовать этот параметр, необходимо указать load_prices_by_dates со значением true
  если этот параметр не указан, вы получите цены по датам за месяц
  формат даты: yyyy-mm-dd
  пример:
  2025-05-21
- prices_start_date
  Тип: string | null
  
  дата начала загрузки цен по датам
  необязательное поле
  чтобы использовать этот параметр, необходимо указать load_prices_by_dates со значением true
  если этот параметр не указан, дата начала устанавливается равной дате check_in
  формат даты: yyyy-mm-dd
  пример:
  2025-05-20
- priority
  Тип: integer | null
  
  приоритет задачи
  необязательное поле
  может принимать следующие значения:
  1 — обычный приоритет выполнения (устанавливается по умолчанию)
  2 — высокий приоритет выполнения. За задачи с высоким приоритетом взимается дополнительная плата.
  Стоимость можно рассчитать на странице тарифов.
- tag
  Тип: string | null
  
  пользовательский идентификатор задачи
  необязательное поле
  ограничение — 255 символов;
  этот параметр позволяет идентифицировать задачу и сопоставить её с результатом;
  указанное значение tag вы найдёте в объекте data ответа

Ответы

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

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

status_code
Тип: integer | null

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

status_message
Тип: string | null

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

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

массив задач

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

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

data
Тип: object | null

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

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

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

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

путь URL

result
Тип: object | null

массив результатов
в этом случае значение будет 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/business_data/google/hotel_info/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_info/task_post \
  --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",
    "hotel_identifier": "ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE",
    "tag": "some_string_123",
    "postback_url": "https://your-server.com/postbackscript.php",
    "postback_data": "advanced"
  }
]'

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

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

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

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

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

Создание задач Google Hotel Info

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

DataForSEO

Создание задач Google Hotel Info

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

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