v0.2.0-beta

OpenAPI 3.1.0

Створення завдань пошуку готелів Google

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

Створення завдань пошуку готелів Google

Ставить у чергу пошук у Google Hotels і повертає id завдання. Відповідь обгорнуто в конверт DataForSEO: дані в tasks[0].result, результат у tasks[0].status_code — відхилений запит усе одно повертає HTTP 200. Отримуйте через get_dataforseo_business_google_hotel_searches_fetch.

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

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

Лише довідкові метадані, а не котирування для облікового запису, гарантована ціна чи ліміт витрат. Кредити ресурсів — це не кредити Felo. Остаточні списання здійснюються за записами білінгу Felo.

Тіло

application/json

Тип: array (object | null)[]
- adults
  Тип: integer | null
  
  кількість дорослих
  необов'язкове поле
  якщо не вказати це поле, буде застосовано значення за замовчуванням 2;
  Примітка: можна вказати до 6 осіб, включно з дорослими та дітьми
  приклад:
  1
- amenities
  Тип: array string[] | null
  
  зручності готелю
  необов'язкове поле
  це поле дає змогу вказати різні зручності готелю
  приклад:
  [ "free_parking", "pets_allowed" ]
  можливі значення:
  "air_conditioning", "all_inclusive_available", "bar", "free_breakfast", "fitness_center", "kid_friendly", "free_parking", "pets_allowed", "pool", "restaurant", "room_service", "spa", "free_wifi", "parking", "indoor_pool", "outdoor_pool", "wheelchair_accessible", "beach_access"
- check_in
  Тип: string | null
  
  дата заїзду
  необов'язкове поле
  якщо не вказати це поле, за замовчуванням буде використано завтрашню дату;
  формат дати: "yyyy-mm-dd"
  приклад:
  "2019-01-15"
  Примітка: значення не може бути раніше сьогоднішньої дати
- check_out
  Тип: string | null
  
  дата виїзду
  необов'язкове поле
  якщо не вказати це поле, система за замовчуванням застосує дату через два дні;
  формат дати: "yyyy-mm-dd"
  приклад:
  "2019-01-15"
  Примітка: значення не може бути меншим або дорівнювати check_in;
  діапазон між значеннями check_in і check_out не може перевищувати 30 днів
- children
  Тип: array string[] | null
  
  кількість і вік дітей
  необов'язкове поле
  якщо не вказати це поле, діти не будуть включені в пошук;
  вік дитини може бути від 0 до 17;
  Примітка: можна вказати до 6 осіб, включно з дорослими та дітьми
  вкажіть таке значення, щоб включити одну дитину 14 років:
  [14]
  вкажіть таке значення, щоб включити одну дитину 13 років і одну дитину 8 років:
  [13,8]
- currency
  Тип: string | null
  
  валюта
  необов'язкове поле
  приклад:
  "USD"
- depth
  Тип: integer | null
  
  глибина парсингу
  необов'язкове поле
  кількість результатів у Google Hotels
  значення за замовчуванням: 18 органічних результатів
  максимальне значення: 140
  Примітка: плата з облікового запису стягується за кожні 18 органічних результатів незалежно від платних оголошень у відповіді;
  тому встановлення глибини понад 18 може призвести до додаткових витрат, якщо Google Hotels поверне більше 18 результатів;
  якщо вказана глибина перевищує кількість результатів у відповіді, різницю буде автоматично повернено на баланс облікового запису
- free_cancellation
  Тип: boolean | null
  
  готелі з безкоштовним скасуванням
  необов'язкове поле
  установіть для цього поля значення true, щоб отримати список готелів із безкоштовним скасуванням бронювання
  значення за замовчуванням: false
- is_vacation_rentals
  Тип: boolean | null
  
  пошук оренди житла для відпочинку
  необов'язкове поле
  установіть для цього поля значення true, щоб отримати список оренди житла для відпочинку замість готелів
  значення за замовчуванням: false
- keyword
  Тип: string | null
  
  ключове слово
  необов'язкове поле
  вказане ключове слово використовується для пошуку списку готелів;
  якщо не використовувати це поле, ми повернемо список готелів, знайдених у вказаному місцезнаходженні;
  у полі keyword можна вказати до 700 символів
  усі %## буде декодовано (символ «+» декодується в пробіл)
  якщо в keyword потрібен символ «%», вкажіть його як «%25»;
  Примітка: для отримання точних результатів пошуку назва місцезнаходження автоматично додається до ключового слова
  
  Докладніше про правила й обмеження полів 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"
  максимальна кількість десяткових цифр для "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
  Примітка: для отримання точних результатів пошуку вказане значення location_name буде автоматично додано до ключового слова
- max_price
  Тип: integer | null
  
  максимальна ціна за ніч
  необов'язкове поле
  валюта цього значення залежить від поля currency
  приклад:
  600
- min_price
  Тип: integer | null
  
  мінімальна ціна за ніч
  необов'язкове поле
  валюта цього значення залежить від поля currency
  приклад:
  100
- min_rating
  Тип: number | null
  
  мінімальний рейтинг
  необов'язкове поле
  це поле дає змогу вказати рейтинг гостей вище певного значення
  приклад:
  2.5
- 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_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
- priority
  Тип: integer | null
  
  пріоритет завдання
  необов'язкове поле
  може приймати такі значення:
  1 — звичайний пріоритет виконання (встановлюється за замовчуванням)
  2 — високий пріоритет виконання. За завдання з високим пріоритетом стягується додаткова плата.
  Вартість можна розрахувати на сторінці тарифів.
- search_this_area
  Тип: boolean | null
  
  показувати готелі з відображуваної області
  необов'язкове поле
  може приймати значення: true, false
  значення за замовчуванням: true
  якщо встановлено false, режим search_this_area буде вимкнено
  Примітка: якщо режим search_this_area вимкнено, location_name не додаватиметься до keyword під час пошуку
  Докладніше про цей параметр — у нашому Help Center
- sort_by
  Тип: string | null
  
  параметри сортування результатів
  необов'язкове поле
  це поле дає змогу сортувати результати
  можливі типи сортування:
  relevance – сортування за релевантністю
  lowest_price – сортування за найнижчою ціною
  highest_rating – сортування за найвищим рейтингом
  most_reviewed – сортування за кількістю відгуків
  значення за замовчуванням: relevance
- stars
  Тип: array string[] | null
  
  кількість зірок готелю
  необов'язкове поле
  установіть для цього поля значення [5], щоб отримати список лише 5-зіркових готелів
  приклад:
  [3,4,5]
- tag
  Тип: string | null
  
  визначений користувачем ідентифікатор завдання
  необов'язкове поле
  обмеження — 255 символів
  цей параметр дає змогу ідентифікувати завдання й зіставити його з результатом
  вказане значення tag ви знайдете в об'єкті data відповіді

Відповіді

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

загальна вартість завдань, USD

status_code
Тип: integer | null

загальний код стану. Повний список кодів відповіді можна знайти тут.

status_message
Тип: string | null

загальне інформаційне повідомлення. Повний список загальних інформаційних повідомлень можна знайти тут.

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

масив завдань

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

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

application/json

post/v1/beta/dataforseo/business_data/google/hotel_searches/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_searches/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",
    "keyword": "cheap hotel",
    "check_in": "2023-06-01",
    "check_out": "2023-06-30",
    "currency": "USD",
    "adults": 2,
    "children": [
      "14"
    ],
    "sort_by": "highest_rating",
    "priority": 2,
    "tag": "example"
  }
]'

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

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

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

Створення завдань пошуку готелів Google

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

DataForSEO

Створення завдань пошуку готелів Google

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