# Get Google Hotel Searches Results by id **API:** Data API **Endpoint:** `GET /v1/beta/dataforseo/business_data/google/hotel_searches/task_get/{id}` **Tags:** DataForSEO 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. ### Pricing reference - Metering: Reported response cost. - Reference request estimate: USD 0.012. - Reference customer multiplier: 1.0. Do not apply it again to a settled customer amount. Reference metadata only, not an account quote, a guaranteed price or a spending cap. Resource credits are not Felo credits. Final charges follow Felo billing records. ## Base URL - `https://openapi.felo.ai` ## Authentication - `FeloBearerAuth` (http bearer, bearer format Felo API Key) - `FeloApiKey` (apiKey in header `X-API-Key`) ## Parameters | Name | In | Required | Type | Description | | --- | --- | --- | --- | --- | | `id` | path | yes | string | task identifier
unique task identifier in our system in the UUID format
you will be able to use it within 30 days to request the results of the task at any time | ## Responses ### 200 — Successful operation Headers: - `X-Request-Id` (string) — Request identifier to include when contacting Felo support. **application/json** Schema: object | null ```json { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskGetResponseInfo" } ] } ``` ### 400 — The request could not be processed. Check the request parameters. ### 401 — A valid Felo API key is required. ### 402 — The request cannot proceed because a billing requirement is not met. ### 403 — The account is not permitted to perform this operation. ### 429 — A request or spending limit has been reached. ### 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 — Error response; upstream passthrough responses may use provider formats **application/json** Schema: ```json {} ``` ## Schema definitions ### Response36Afe1097B20_BaseResponseInfo `#/components/schemas/Response36Afe1097B20_BaseResponseInfo` ```json { "properties": { "version": { "type": [ "string", "null" ], "description": "the current version of the API" }, "status_code": { "type": [ "integer", "null" ], "description": "general status code\nyou can find the full list of the response codes here" }, "status_message": { "type": [ "string", "null" ], "description": "general informational message\nyou can find the full list of general informational messages here" }, "time": { "type": [ "string", "null" ], "description": "total execution time, seconds" }, "cost": { "type": [ "number", "null" ], "description": "total tasks cost, USD", "format": "double" }, "tasks_count": { "type": [ "integer", "null" ], "description": "the number of tasks in the tasks array", "format": "int64" }, "tasks_error": { "type": [ "integer", "null" ], "description": "the number of tasks in the tasks array returned with an error", "format": "int64" } } } ``` ### Response36Afe1097B20_BaseResponseTaskInfo `#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo` ```json { "properties": { "id": { "type": [ "string", "null" ], "description": "task identifier\nunique task identifier in our system in the UUID format" }, "status_code": { "type": [ "integer", "null" ], "description": "status code of the task\ngenerated by DataForSEO, can be within the following range: 10000-60000\nyou can find the full list of the response codes here" }, "status_message": { "type": [ "string", "null" ], "description": "informational message of the task\nyou can find the full list of general informational messages here" }, "time": { "type": [ "string", "null" ], "description": "execution time, seconds" }, "cost": { "type": [ "number", "null" ], "description": "total tasks cost, USD", "format": "double" }, "result_count": { "type": [ "integer", "null" ], "description": "number of elements in the result array", "format": "int64" }, "path": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "URL path" }, "data": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "object", "null" ] }, "description": "contains the same parameters that you specified in the POST request" } } } ``` ### Response36Afe1097B20_BusinessDataGoogleHotelSearchesItem `#/components/schemas/Response36Afe1097B20_BusinessDataGoogleHotelSearchesItem` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "type of element" }, "hotel_identifier": { "type": [ "string", "null" ], "description": "unique identifier of a hotel entity in Google search
example:
CgoI-KWyzenM_MV3EAE" }, "title": { "type": [ "string", "null" ], "description": "title of the hotel" }, "stars": { "type": [ "integer", "null" ], "description": "hotel class rating
class rating that ranges between 1-5 stars" }, "is_paid": { "type": [ "boolean", "null" ], "description": "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" }, "location": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_GpsCoordinatesLocationInfo" } ], "description": "GPS coordinates of the hotel's location" }, "reviews": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_HotelReviewInfo" } ], "description": "hotel reviews and rating information" }, "overview_images": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "featured images for a hotel" }, "prices": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_HotelPriceInfo" } ], "description": "hotel price" } } } ``` ### Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskGetResponseInfo `#/components/schemas/Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskGetResponseInfo` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo" }, { "type": "object", "properties": { "tasks": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskGetTaskInfo" } ] }, "description": "array of tasks" } } } ] } ``` ### Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskGetResultInfo `#/components/schemas/Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskGetResultInfo` ```json { "type": "object", "properties": { "keyword": { "type": [ "string", "null" ], "description": "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" }, "location_code": { "type": [ "integer", "null" ], "description": "location code in a POST array" }, "language_code": { "type": [ "string", "null" ], "description": "language code in a POST array" }, "check_url": { "type": [ "string", "null" ], "description": "direct URL to search engine results
you can use it to make sure that we provided accurate results" }, "datetime": { "type": [ "string", "null" ], "description": "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" }, "items_count": { "type": [ "integer", "null" ], "description": "item types
the number of items in the items array", "format": "int64" }, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataGoogleHotelSearchesItem" } ] }, "description": "array of items
note: this field always equals null; use it to facilitate integration and ensure interoperability with the Hotel Info endpoint" } } } ``` ### Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskGetTaskInfo `#/components/schemas/Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskGetTaskInfo` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo" }, { "type": "object", "properties": { "result": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskGetResultInfo" } ] }, "description": "array of results" } } } ] } ``` ### Response36Afe1097B20_GpsCoordinatesLocationInfo `#/components/schemas/Response36Afe1097B20_GpsCoordinatesLocationInfo` ```json { "type": "object", "properties": { "latitude": { "type": [ "number", "null" ], "description": "latitude coordinate of the hotel in google maps
example:
\"latitude\": 51.584091" }, "longitude": { "type": [ "number", "null" ], "description": "longitude coordinate of the hotel in google maps
example:
\"longitude\": -0.31365919999999997" } } } ``` ### Response36Afe1097B20_HotelInfoPriceOffer `#/components/schemas/Response36Afe1097B20_HotelInfoPriceOffer` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "type of element" }, "title": { "type": [ "string", "null" ], "description": "title of the hotel" }, "price": { "type": [ "number", "null" ], "description": "price per night" }, "currency": { "type": [ "string", "null" ], "description": "price currency
USD is applied by default, unless specified in the POST array" }, "url": { "type": [ "string", "null" ], "description": "url of the price offer\nURL to the page of the website where price offer appears" }, "max_visitors": { "type": [ "integer", "null" ], "description": "the maximal number of visitors\nthe maximum number of visitors for which the price offer is valid" }, "offer_images": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "price offer images\nURLs of the images featured in the price offer" }, "free_cancellation_until": { "type": [ "string", "null" ], "description": "date until free cancellation is available\nin the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”\nequals null if free cancellation is not available for the selected dates" } }, "description": "featured price offers" } ``` ### Response36Afe1097B20_HotelPriceInfo `#/components/schemas/Response36Afe1097B20_HotelPriceInfo` ```json { "type": "object", "properties": { "price": { "type": [ "number", "null" ], "description": "price per night" }, "price_without_discount": { "type": [ "number", "null" ], "description": "full price per night without a discount applied", "format": "int64" }, "currency": { "type": [ "string", "null" ], "description": "price currency
USD is applied by default, unless specified in the POST array" }, "discount_text": { "type": [ "string", "null" ], "description": "text about a discount applied" }, "check_in": { "type": [ "string", "null" ], "description": "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" }, "check_out": { "type": [ "string", "null" ], "description": "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" }, "visitors": { "type": [ "integer", "null" ], "description": "number of hotel visitors for this price" }, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_HotelPriceItemInfo" } ] }, "description": "encountered item types
types of search engine results encountered in the items array;
possible item types: hotel_search_item" }, "prices_by_dates": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_PricesByDates" } ] } } } } ``` ### Response36Afe1097B20_HotelPriceItemInfo `#/components/schemas/Response36Afe1097B20_HotelPriceItemInfo` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "type of element" }, "title": { "type": [ "string", "null" ], "description": "title of the hotel" }, "price": { "type": [ "number", "null" ], "description": "price per night" }, "currency": { "type": [ "string", "null" ], "description": "price currency
USD is applied by default, unless specified in the POST array" }, "url": { "type": [ "string", "null" ], "description": "third-party page url\nURL to the third-party website page with pricing information" }, "domain": { "type": [ "string", "null" ], "description": "third-party domain\ndomain of the third-party website page with pricing information" }, "is_paid": { "type": [ "boolean", "null" ], "description": "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" }, "official_site": { "type": [ "boolean", "null" ] }, "free_cancellation_until": { "type": [ "string", "null" ], "description": "date until which free cancellation is available\nin the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”\nequals null if free cancellation is not available for the selected dates" }, "offers": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_HotelInfoPriceOffer" } ] } } } } ``` ### Response36Afe1097B20_HotelReviewInfo `#/components/schemas/Response36Afe1097B20_HotelReviewInfo` ```json { "type": "object", "properties": { "value": { "type": [ "number", "null" ], "description": "overall hotel rating based on customer votes" }, "votes_count": { "type": [ "integer", "null" ], "description": "number of customer votes
the number of customer votes included in the calculation of the hotel rating", "format": "int64" }, "mentions": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_ReviewMentionInfo" } ] }, "description": "hotel mentions
information about hotel reviews by criteria" }, "rating_distribution": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "integer", "null" ], "format": "Int64" }, "description": "rating distribution by votes
the distribution of votes across the rating in the range from 1 to 5" }, "other_sites_reviews": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_OtherSitesReviewsInfo" } ] }, "description": "reviews on third-party sites
reviews from third-party sites" } } } ``` ### Response36Afe1097B20_OtherSitesReviewsInfo `#/components/schemas/Response36Afe1097B20_OtherSitesReviewsInfo` ```json { "type": "object", "properties": { "title": { "type": [ "string", "null" ], "description": "review title
contains a name of the third-party site where review initially appeared" }, "url": { "type": [ "string", "null" ], "description": "review url
URL to the a third-party site where review initially appeared" }, "review_text": { "type": [ "string", "null" ], "description": "review text
text of the review" }, "rating": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_RatingInfo" } ], "description": "rating in the review
information about the rating enclosed in the review on a third-party site" } } } ``` ### Response36Afe1097B20_PricesByDates `#/components/schemas/Response36Afe1097B20_PricesByDates` ```json { "type": "object", "properties": { "price": { "type": [ "number", "null" ], "description": "price per night" }, "currency": { "type": [ "string", "null" ], "description": "price currency
USD is applied by default, unless specified in the POST array" }, "check_in_date": { "type": [ "string", "null" ] }, "check_out_date": { "type": [ "string", "null" ] } } } ``` ### Response36Afe1097B20_RatingInfo `#/components/schemas/Response36Afe1097B20_RatingInfo` ```json { "properties": { "rating_type": { "type": [ "string", "null" ], "description": "the type of rating\nhere you can find the following elements: Max5, Percents, CustomMax" }, "value": { "type": [ "number", "null" ], "description": "the value of the rating", "format": "double" }, "votes_count": { "type": [ "integer", "null" ], "description": "the amount of feedback", "format": "int64" }, "rating_max": { "type": [ "integer", "null" ], "description": "the maximum value for a rating_type" } } } ``` ### Response36Afe1097B20_ReviewMentionInfo `#/components/schemas/Response36Afe1097B20_ReviewMentionInfo` ```json { "type": "object", "properties": { "title": { "type": [ "string", "null" ], "description": "title of the evaluated criterion" }, "positive_score": { "type": [ "number", "null" ], "description": "positive score by criterion" }, "positive_count": { "type": [ "integer", "null" ], "description": "count of positive reviews by criterion", "format": "int64" }, "negative_count": { "type": [ "integer", "null" ], "description": "count of negative reviews by criterion", "format": "int64" }, "total_count": { "type": [ "integer", "null" ], "description": "count of all reviews by criterion", "format": "int64" }, "visible_by_default": { "type": [ "boolean", "null" ], "description": "element is visible by default
indicates whether the review element is visible by default" } } } ```