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 में - अस्वीकृत request भी HTTP 200 लौटाती है। get_dataforseo_business_google_hotel_searches_fetch से प्राप्त करें।

मूल्य संदर्भ

मीटरिंग: रिपोर्ट की गई response लागत
संदर्भ request अनुमान: 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 ऑर्गेनिक परिणामों के लिए आपके खाते से बिल लिया जाएगा, चाहे response में पेड लिस्टिंग हों या नहीं;
  इसलिए, 18 से अधिक गहराई सेट करने पर अतिरिक्त शुल्क लग सकता है यदि Google Hotels 18 से अधिक परिणाम लौटाता है;
  यदि निर्दिष्ट गहराई response में परिणामों की संख्या से अधिक है, तो अंतर स्वचालित रूप से आपके खाता शेष में वापस कर दिया जाएगा
- free_cancellation
  टाइप: boolean | null
  
  मुफ़्त रद्दीकरण वाले होटल
  वैकल्पिक फ़ील्ड
  यदि आप मुफ़्त रद्दीकरण वाले होटलों की सूची प्राप्त करना चाहते हैं, तो इस फ़ील्ड को true पर सेट करें
  डिफ़ॉल्ट मान: false
- is_vacation_rentals
  टाइप: boolean | null
  
  वेकेशन रेंटल खोजें
  वैकल्पिक फ़ील्ड
  यदि आप होटलों के बजाय वेकेशन रेंटल की सूची प्राप्त करना चाहते हैं, तो इस फ़ील्ड को true पर सेट करें
  डिफ़ॉल्ट मान: false
- keyword
  टाइप: string | null
  
  कीवर्ड
  वैकल्पिक फ़ील्ड
  आपका निर्दिष्ट कीवर्ड होटलों की सूची खोजने के लिए उपयोग किया जाता है;
  यदि आप यह फ़ील्ड उपयोग नहीं करते हैं, तो हम निर्दिष्ट स्थान में मिले होटलों की सूची लौटाएँगे;
  आप keyword फ़ील्ड में अधिकतम 700 अक्षर निर्दिष्ट कर सकते हैं
  सभी %## डिकोड किए जाएँगे (‘+’ अक्षर भी स्पेस अक्षर में डिकोड होगा)
  यदि आपको अपने keyword में “%” अक्षर का उपयोग करना है, तो उसे “%25” के रूप में निर्दिष्ट करें;
  नोट: सटीक खोज परिणाम प्राप्त करने के लिए, स्थान का नाम स्वचालित रूप से कीवर्ड में जोड़ा जाता है
  
  DataForSEO APIs में keyword और keywords फ़ील्ड के नियमों और सीमाओं के बारे में इस 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
  वैकल्पिक फ़ील्ड
  टास्क पूरा होने पर हम आपके निर्दिष्ट URL पर GET request भेजकर सूचित करेंगे
  आप ‘$id’ स्ट्रिंग को $id वैरिएबल और ‘$tag’ को URL-एन्कोडेड $tag वैरिएबल के रूप में उपयोग कर सकते हैं। रिक्वेस्ट भेजने से पहले हम आवश्यक मान सेट करेंगे।
  उदाहरण:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  नोट: pingback_url में विशेष वर्ण URL-एन्कोड किए जाएँगे;
  यानी, # वर्ण %23 में एन्कोड होगा
  
  हमारे Help Center पर अधिक जानें
- postback_url
  टाइप: string | null
  
  टास्क परिणाम भेजने का URL
  वैकल्पिक फ़ील्ड
  टास्क पूरा होने पर हम उसके परिणामों को gzip प्रारूप में संपीड़ित करके आपके निर्दिष्ट postback_url पर POST request भेजेंगे
  आप ‘$id’ स्ट्रिंग को $id वैरिएबल और ‘$tag’ को URL-एन्कोडेड $tag वैरिएबल के रूप में उपयोग कर सकते हैं। रिक्वेस्ट भेजने से पहले हम आवश्यक मान सेट करेंगे।
  उदाहरण:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  नोट: postback_url में विशेष वर्ण URL-एन्कोड किए जाएँगे;
  यानी, # वर्ण %23 में एन्कोड होगा
  
  हमारे Help Center पर अधिक जानें
- priority
  टाइप: integer | null
  
  टास्क प्राथमिकता
  वैकल्पिक फ़ील्ड
  निम्नलिखित मान ले सकता है:
  1 – सामान्य निष्पादन प्राथमिकता (डिफ़ॉल्ट रूप से सेट)
  2 – उच्च निष्पादन प्राथमिकता। उच्च निष्पादन प्राथमिकता वाले टास्क के लिए आपसे अतिरिक्त शुल्क लिया जाएगा।
  लागत की गणना Pricing पेज पर की जा सकती है।
- 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 मान response के data ऑब्जेक्ट में मिलेगा

responses

200
टाइप: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskPostResponseInfo
cost
टाइप: number | null फ़ॉर्मेट: double

टास्क की कुल लागत, USD

status_code
टाइप: integer | null

सामान्य स्टेटस कोड response कोड की पूरी सूची यहाँ देखी जा सकती है

status_message
टाइप: string | null

सामान्य सूचनात्मक संदेश सामान्य सूचनात्मक संदेशों की पूरी सूची यहाँ देखी जा सकती है

tasks
टाइप: array (object | null)[] | null

टास्क का ऐरे

टाइप: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskPostTaskInfo
cost
टाइप: number | null फ़ॉर्मेट: double

टास्क की कुल लागत, USD

data
टाइप: object | null

इसमें वही पैरामीटर हैं जो आपने POST request में निर्दिष्ट किए थे

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 response कोड की पूरी सूची यहाँ देखी जा सकती है

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

request संसाधित नहीं किया जा सका। request पैरामीटर जाँचें।
401

एक वैध Felo API key आवश्यक है।
402

request आगे नहीं बढ़ सकता क्योंकि बिलिंग आवश्यकता पूरी नहीं हुई है।
403

खाते को यह ऑपरेशन करने की अनुमति नहीं है।
429

request या खर्च की सीमा तक पहुँच गए हैं।
502

सेवा request पूरा नहीं कर सकी।
503

API या बिलिंग सेवा अस्थायी रूप से उपलब्ध नहीं है।
504

request संसाधित करते समय सेवा का समय समाप्त हो गया।
default

त्रुटि response; upstream passthrough response प्रोवाइडर फ़ॉर्मेट का उपयोग कर सकते हैं।

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 होटल सर्च टास्क सेट करें

मूल्य संदर्भ