v0.2.0-beta

OpenAPI 3.1.0

HTML-інформація про готель 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_info/live/html

HTML-інформація про готель Google у реальному часі

Той самий лістинг готелю, що й post_dataforseo_business_google_hotel_info_live, але у вигляді необробленого HTML. Відповідь обгорнуто в конверт DataForSEO: дані в tasks[0].result, результат у tasks[0].status_code — відхилений запит усе одно повертає HTTP 200.

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

Тарифікація: вартість відповіді за даними постачальника.
Довідкова оцінка запиту: 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
  
  дата виїзду
  необов'язкове поле
  якщо не вказати це поле, система за замовчуванням застосує дату через два дні;
  формат дати: "yyyy-mm-dd"
  приклад:
  "2019-01-15"
- children
  Тип: array string[] | null
  
  кількість і вік дітей
  необов'язкове поле
  якщо не вказати це поле, діти не будуть включені в пошук;
  
  вкажіть таке значення, щоб включити одну дитину 14 років:
  [14]
  вкажіть таке значення, щоб включити одну дитину 13 років і одну дитину 8 років:
  [13,8]
- currency
  Тип: string | null
  
  валюта
  необов'язкове поле
  приклад:
  "USD"
- hotel_identifier
  Тип: string
  
  унікальний ідентифікатор готелю
  обов'язкове поле
  унікальний ідентифікатор об'єкта «готель» у пошуку Google;
  значення можна отримати, надіславши запит до Advanced Google SERP API (воно міститься в елементі hotels відповіді) або до ендпоінта Hotel Searches Business Data API
  приклад:
  ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE
- 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
- priority
  Тип: integer | null
  
  пріоритет завдання
  необов'язкове поле
  може приймати такі значення:
  1 — звичайний пріоритет виконання (встановлюється за замовчуванням)
  2 — високий пріоритет виконання. За завдання з високим пріоритетом стягується додаткова плата.
  Вартість можна розрахувати на сторінці тарифів.
- tag
  Тип: string | null
  
  визначений користувачем ідентифікатор завдання
  необов'язкове поле
  обмеження — 255 символів
  цей параметр дає змогу ідентифікувати завдання й зіставити його з результатом
  вказане значення tag ви знайдете в масиві data відповіді

Відповіді

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

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

status_code
Тип: integer | null

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

status_message
Тип: string | null

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

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

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

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

HTML-сторінки

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

унікальний ідентифікатор готелю, заданий як "hotel_id:$"

language_code
Тип: string | null

код мови в масиві POST

location_code
Тип: integer | null

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

se_domain
Тип: string | null
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

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

application/json

post/v1/beta/dataforseo/business_data/google/hotel_info/live/html

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_info/live/html \
  --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"
  }
]'

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

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

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

HTML-інформація про готель Google у реальному часі

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

DataForSEO

HTML-інформація про готель Google у реальному часі

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