Felo API PlatformFelo API Platform

データ API / DataForSEO / Business Data

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.

パラメータ

パス

  • idstring必須

    DataForSEO task ID.

リクエスト例

curl -X GET "https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_searches/task_get/{id}" \
  -H "Authorization: Bearer $FELO_API_KEY"

レスポンス

レスポンスのフィールド

  • versionstring任意

    the current version of the API

  • status_codeinteger任意

    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

  • status_messagestring任意

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

  • timestring任意

    execution time, seconds

  • costnumber任意

    *total tasks cost, USD*

  • tasks_countinteger任意

    *the number of tasks in the tasks array*

  • tasks_errorinteger任意

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

  • tasksstring[]任意

    array of tasks

  • idstring任意

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

  • status_codeinteger任意

    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

  • status_messagestring任意

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

  • timestring任意

    execution time, seconds

  • costnumber任意

    cost of the task, USD

  • result_countinteger任意

    number of elements in the result array

  • pathstring[]任意

    URL path

  • dataobject任意

    contains the same parameters that you specified in the POST request

  • resultstring[]任意

    array of results

  • keywordstring任意

    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_codeinteger任意

    location code in a POST array

  • language_codestring任意

    language code in a POST array

  • check_urlstring任意

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

  • datetimestring任意

    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_countinteger任意

    item types the number of items in the items array

  • itemsstring[]任意

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

  • typestring任意

    *type of element = ‘hotel\_search\_item’*

  • hotel_identifierstring任意

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

  • titlestring任意

    title of the hotel

  • starsinteger任意

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

  • is_paidboolean任意

    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

  • locationobject任意

    GPS coordinates of the hotel’s location

  • latitudenumber任意

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

  • longitudenumber任意

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

  • reviewsobject任意

    hotel reviews and rating information

  • valuenumber任意

    the average rating based on all reviews

  • votes_countinteger任意

    the number of votes

  • mentionsstring[]任意

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

  • rating_distributionobject任意

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

  • other_sites_reviewsstring[]任意

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

  • overview_imagesstring[]任意

    featured images for a hotel

  • pricesobject任意

    hotel price

  • priceinteger任意

    price per night

  • price_without_discountinteger任意

    full price per night without a discount applied

  • currencystring任意

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

  • discount_textstring任意

    text about a discount applied

  • check_instring任意

    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_outstring任意

    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

  • visitorsinteger任意

    number of hotel visitors for this price

  • itemsstring[]任意

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