v0.1.0-beta

OpenAPI 3.1.0

Get Google Hotel Searches Results by id

Felo API Support

MIT

Сервер

https://openapi.felo.ai

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

Shell Curl

DataForSEO

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

DataForSEO Операции

get/v1/beta/dataforseo/business_data/google/hotel_searches/task_get/{id}

Get Google Hotel Searches Results by id

Retrieves a queued Google Hotels search by id. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. ⚠️ The response size was fixed by the depth or limit set at submit time and cannot be narrowed here; if it is too large, resubmit smaller rather than paging.

Параметры пути

id
Тип: string
обязательно

DataForSEO task ID.

Ответы

200
Тип: object

Successful response
items
Тип: array string[]

encountered item types types of search engine results encountered in the items array; possible item types: hotel_search_item

items.check_in
Тип: string

check-in date and time in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00

items.check_out
Тип: string

check-out date and time in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00

items.currency
Тип: string

price currency USD is applied by default, unless specified in the POST array

items.discount_text
Тип: string

text about a discount applied

items.hotel_identifier
Тип: string

unique identifier of a hotel entity in Google search example: CgoI-KWyzenM_MV3EAE

items.is_paid
Тип: boolean

indicates a paid hotel listing if true, related hotel_search_item is a paid ad if false, related hotel_search_item is an organic hotel listing

items.items
Тип: array string[]

array of items note: this field always equals null; use it to facilitate integration and ensure interoperability with the Hotel Info endpoint

items.latitude
Тип: number

latitude coordinate of the hotel in google maps example: "latitude": 51.584091

items.location
Тип: object

GPS coordinates of the hotel’s location

items.longitude
Тип: number

longitude coordinate of the hotel in google maps example: "longitude": -0.31365919999999997

items.mentions
Тип: array string[]

hotel mentions note: this field always equals null; use it to facilitate integration and ensure interoperability with the Hotel Info endpoint

items.other_sites_reviews
Тип: array string[]

reviews on third-party sites note: this field always equals null; use it to facilitate integration and ensure interoperability with the Hotel Info endpoint

items.overview_images
Тип: array string[]

featured images for a hotel

items.price
Тип: integer

price per night

items.price_without_discount
Тип: integer

full price per night without a discount applied

items.prices
Тип: object

hotel price

items.rating_distribution
Тип: object

rating distribution by votes note: this field always equals null; use it to facilitate integration and ensure interoperability with the Hotel Info endpoint

items.reviews
Тип: object

hotel reviews and rating information

items.stars
Тип: integer

hotel class rating class rating that ranges between 1-5 stars

items.title
Тип: string

title of the hotel

items.type
Тип: string

type of element = ‘hotel_search_item’

items.value
Тип: number

the average rating based on all reviews

items.visitors
Тип: integer

number of hotel visitors for this price

items.votes_count
Тип: integer

the number of votes

result
Тип: array string[]

array of results

result.check_url
Тип: string

direct URL to search engine results you can use it to make sure that we provided accurate results

result.datetime
Тип: string

date and time when the result was received in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00

result.items_count
Тип: integer

item types the number of items in the items array

result.keyword
Тип: string

keyword received in a POST array keyword is returned with decoded %## (plus character ‘+’ will be decoded to a space character); in order to obtain accurate search results, the location name is appended to the keyword automatically

result.language_code
Тип: string

language code in a POST array

result.location_code
Тип: integer

location code in a POST array

tasks
Тип: array string[]

array of tasks

tasks.cost
Тип: number

cost of the task, USD

tasks.data
Тип: object

contains the same parameters that you specified in the POST request

tasks.id
Тип: string

task identifier unique task identifier in our system in the UUID format

tasks.path
Тип: array string[]

URL path

tasks.result_count
Тип: integer

number of elements in the result array

tasks.status_code
Тип: integer

status code of the task generated by DataForSEO; can be within the following range: 10000-60000 you can find the full list of the response codes here

tasks.status_message
Тип: string

informational message of the task you can find the full list of general informational messages here

tasks.time
Тип: string

execution time, seconds

version
Тип: string

the current version of the API

version.cost
Тип: number

total tasks cost, USD

version.status_code
Тип: integer

general status code you can find the full list of the response codes here Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions

version.status_message
Тип: string

general informational message you can find the full list of general informational messages here

version.tasks_count
Тип: integer

the number of tasks in the tasks array

version.tasks_error
Тип: integer

the number of tasks in the tasks array that were returned an error

version.time
Тип: string

execution time, seconds
application/json
400

Bad request
401

Unauthorized
402

The request cannot proceed because a billing requirement is not met.
403

The account is not permitted to perform this operation.
429

Rate limit exceeded
500

Internal server error
502

The service could not complete the request.
503

The API or billing service is temporarily unavailable.
504

The service timed out while processing the request.
default

The operation failed. Keep the response request ID when contacting Felo support.

get/v1/beta/dataforseo/business_data/google/hotel_searches/task_get/{id}

curl 'https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_searches/task_get/{id}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

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

{
  "version": "string",
  "version.status_code": 1,
  "version.status_message": "string",
  "version.time": "string",
  "version.cost": 1,
  "version.tasks_count": 1,
  "version.tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks.id": "string",
  "tasks.status_code": 1,
  "tasks.status_message": "string",
  "tasks.time": "string",
  "tasks.cost": 1,
  "tasks.result_count": 1,
  "tasks.path": [
    "string"
  ],
  "tasks.data": {},
  "result": [
    "string"
  ],
  "result.keyword": "string",
  "result.location_code": 1,
  "result.language_code": "string",
  "result.check_url": "string",
  "result.datetime": "string",
  "result.items_count": 1,
  "items": [
    "string"
  ],
  "items.type": "string",
  "items.hotel_identifier": "string",
  "items.title": "string",
  "items.stars": 1,
  "items.is_paid": true,
  "items.location": {},
  "items.latitude": 1,
  "items.longitude": 1,
  "items.reviews": {},
  "items.value": 1,
  "items.votes_count": 1,
  "items.mentions": [
    "string"
  ],
  "items.rating_distribution": {},
  "items.other_sites_reviews": [
    "string"
  ],
  "items.overview_images": [
    "string"
  ],
  "items.prices": {},
  "items.price": 1,
  "items.price_without_discount": 1,
  "items.currency": "string",
  "items.discount_text": "string",
  "items.check_in": "string",
  "items.check_out": "string",
  "items.visitors": 1,
  "items.items": [
    "string"
  ]
}

Successful response

Get Google Hotel Searches Results by id

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

DataForSEO

Get Google Hotel Searches Results by id