DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google Hotel Searches ٹاسکس ترتیب دینا
Google Hotels تلاش قطار میں ڈالتا ہے اور ٹاسک id واپس کرتا ہے۔ DataForSEO کے لفافے میں لپٹا: ڈیٹا tasks[0].result میں، نتیجہ tasks[0].status_code میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔ get_dataforseo_business_google_hotel_searches_fetch سے حاصل کریں۔
قیمت کا حوالہ
- میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
- حوالہ جاتی درخواست کا تخمینہ: USD 0.2428۔
- حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔
صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔
- قسم: 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قسم: string | null
_in چیک اِن تاریخ
اختیاری فیلڈ
اگر آپ یہ فیلڈ متعین نہ کریں تو ڈیفالٹ طور پر کل کی تاریخ استعمال ہوگی؛
تاریخ کی شکل:"yyyy-mm-dd"
مثال:"2019-01-15"
نوٹ: قدر آج کی تاریخ سے پہلے کی نہیں ہو سکتی - checkقسم: string | null
_out چیک آؤٹ تاریخ
اختیاری فیلڈ
اگر آپ یہ فیلڈ متعین نہ کریں تو ہمارا سسٹم ڈیفالٹ طور پر آج سے دو دن بعد کی تاریخ لاگو کرے گا؛
تاریخ کی شکل:"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 نامیاتی نتائج کے لیے بل لیا جائے گا؛
چنانچہ18سے زیادہ ڈیپتھ مقرر کرنے پر اضافی چارجز آ سکتے ہیں اگر Google Hotels 18 سے زیادہ نتائج واپس کرے؛
اگر متعین کردہ ڈیپتھ جواب میں نتائج کی تعداد سے زیادہ ہو تو فرق خود بخود آپ کے اکاؤنٹ بیلنس میں واپس کر دیا جائے گا - freeقسم: boolean | null
_cancellation مفت منسوخی والے ہوٹل
اختیاری فیلڈ
اگر آپ مفت منسوخی کی سہولت والے ہوٹل کی فہرست حاصل کرنا چاہتے ہیں تو یہ فیلڈtrueپر سیٹ کریں
ڈیفالٹ قدر:false - isقسم: boolean | null
_vacation _rentals چھٹیوں کے کرائے کی رہائشیں تلاش کریں
اختیاری فیلڈ
اگر آپ ہوٹل کے بجائے چھٹیوں کے کرائے کی رہائشوں کی فہرست حاصل کرنا چاہتے ہیں تو یہ فیلڈtrueپر سیٹ کریں
ڈیفالٹ قدر:false - keywordقسم: string | null
کی ورڈ
اختیاری فیلڈ
آپ جو کی ورڈ متعین کرتے ہیں وہ ہوٹل کی فہرست تلاش کرنے کے لیے استعمال ہوتا ہے؛
اگر آپ یہ فیلڈ استعمال نہ کریں تو ہم متعین کردہ مقام میں ملنے والے ہوٹل کی فہرست واپس کریں گے؛
آپkeywordفیلڈ میں زیادہ سے زیادہ 700 حروف متعین کر سکتے ہیں
تمام %## ڈی کوڈ ہوں گے (نیز ‘+’ حرف اسپیس حرف میں ڈی کوڈ ہوگا)
اگر آپ کو اپنےkeywordکے لیے “%” حرف استعمال کرنا ہو تو اسے “%25” کے طور پر متعین کریں؛
نوٹ: درست تلاش کے نتائج حاصل کرنے کے لیے مقام کا نام خود بخود کی ورڈ کے ساتھ شامل کر دیا جاتا ہےDataForSEO APIs میں
keywordاورkeywordsفیلڈز کے قواعد اور پابندیوں کے بارے میں اس Help Center مضمون میں مزید جانیں - languageقسم: string
_code سرچ انجن زبان کا کوڈ
اگر آپlanguage_nameمتعین نہ کریں تو درکار فیلڈ
اگر آپ یہ فیلڈ استعمال کریں توlanguage_nameمتعین کرنے کی ضرورت نہیں
آپ دستیاب زبانوں کی فہرست ان کےlanguage_code_ کے ساتھ الگ درخواست بھیج کرhttps://api.dataforseo.com/v3/business_data/google/languagesسے حاصل کر سکتے ہیں
مثال:en - languageقسم: string
_name سرچ انجن زبان کا پورا نام
اگر آپlanguage_codeمتعین نہ کریں تو درکار فیلڈ
اگر آپ یہ فیلڈ استعمال کریں توlanguage_codeمتعین کرنے کی ضرورت نہیں
آپ دستیاب زبانوں کی فہرستlanguage_nameکے ساتھ الگ درخواست بھیج کرhttps://api.dataforseo.com/v3/business_data/google/languagesسے حاصل کر سکتے ہیں
مثال:English - locationقسم: integer
_code سرچ انجن مقام کا کوڈ
اگر آپlocation_name_ یاlocation_coordinateمتعین نہ کریں تو درکار فیلڈ
اگر آپ یہ فیلڈ استعمال کریں توlocation_nameیاlocation_coordinateمتعین کرنے کی ضرورت نہیں
آپ دستیاب مقامات کی فہرستlocation_codeکے ساتھ الگ درخواست بھیج کرhttps://api.dataforseo.com/v3/business_data/google/locationsسے حاصل کر سکتے ہیں
مثال:2840n - locationقسم: string
_coordinate مقام کے GPS کوآرڈینیٹس
اگر آپlocation_name_ یاlocation_codeمتعین نہ کریں تو درکار فیلڈ
اگر آپ یہ فیلڈ استعمال کریں توlocation_nameیاlocation_codeمتعین کرنے کی ضرورت نہیںlocation_coordinateپیرامیٹر "latitude,longitude" فارمیٹ میں متعین کرنا چاہیے
"latitude" اور "longitude" کے لیے زیادہ سے زیادہ اعشاریہ ہندسے: 7
نوٹ: اگر کوآرڈینیٹس مقام متعین کرنے کے لیے استعمال ہوں تو تلاش قریبی بستی میں ہوگی؛
مثال:53.476225,-2.243572 - locationقسم: string
_name سرچ انجن مقام کا پورا نام
اگر آپ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قسم: integer | null
_price فی رات زیادہ سے زیادہ قیمت
اختیاری فیلڈ
اس قدر کی کرنسیcurrencyفیلڈ پر منحصر ہے
مثال:600 - minقسم: integer | null
_price فی رات کم از کم قیمت
اختیاری فیلڈ
اس قدر کی کرنسیcurrencyفیلڈ پر منحصر ہے
مثال:100 - minقسم: number | null
_rating کم از کم ریٹنگ
اختیاری فیلڈ
آپ یہ فیلڈ کسی مخصوص قدر سے زیادہ مہمان ریٹنگ متعین کرنے کے لیے استعمال کر سکتے ہیں
مثال:2.5 - pingbackقسم: string | null
_url مکمل شدہ ٹاسک کا اطلاعی URL
اختیاری فیلڈ
جب ٹاسک مکمل ہو جائے گا تو ہم آپ کے متعین کردہ URL پر GET درخواست بھیج کر آپ کو مطلع کریں گے
آپ ‘$id’ اسٹرنگ کو$idویری ایبل کے طور پر اور ‘$tag’ کو urlencoded$tagویری ایبل کے طور پر استعمال کر سکتے ہیں۔ درخواست بھیجنے سے پہلے ہم مطلوبہ اقدار سیٹ کریں گے۔
مثال:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
نوٹ:pingback_urlمیں خصوصی حروف urlencode کیے جائیں گے؛
مثلاً#حرف%23میں انکوڈ کیا جائے گا - postbackقسم: string | null
_url ٹاسک کے نتائج بھیجنے کے لیے URL
اختیاری فیلڈ
ٹاسک مکمل ہونے پر ہم اس کے نتائجgzipفارمیٹ میں کمپریس کر کے آپ کے متعین کردہpostback_urlپر POST درخواست کے ذریعے بھیجیں گے
آپ ‘$id’ اسٹرنگ کو$idویری ایبل کے طور پر اور ‘$tag’ کو urlencoded$tagویری ایبل کے طور پر استعمال کر سکتے ہیں۔ درخواست بھیجنے سے پہلے ہم مطلوبہ اقدار سیٹ کریں گے۔
مثال:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
نوٹ:postback_urlمیں خصوصی حروف urlencode کیے جائیں گے؛
مثلاً#حرف%23میں انکوڈ کیا جائے گا - priorityقسم: integer | null
- searchقسم: boolean | null
_this _area دکھائے گئے علاقے کے ہوٹل دکھائیں
اختیاری فیلڈ
درج ذیل اقدار لے سکتا ہے:true,false
ڈیفالٹ قدر:true
اگرfalseپر سیٹ ہو توsearch_this_areaموڈ بند ہو جائے گا
نوٹ: اگرsearch_this_areaموڈ بند ہو تو تلاش کے دورانlocation_namekeywordکے ساتھ شامل نہیں کیا جائے گا
اس پیرامیٹر کے بارے میں ہمارے Help Center پر مزید جانیں - sortقسم: string | null
_by نتائج کی ترتیب کے پیرامیٹرز
اختیاری فیلڈ
آپ یہ فیلڈ نتائج کی ترتیب کے لیے استعمال کر سکتے ہیں
ممکنہ ترتیب کی اقسام:relevance– سب سے زیادہ متعلقہ کے حساب سے ترتیبlowest_price– سب سے کم قیمت کے حساب سے ترتیبhighest_rating– سب سے زیادہ ریٹنگ کے حساب سے ترتیبmost_reviewed– سب سے زیادہ ریویوز کے حساب سے ترتیب
ڈیفالٹ قدر:relevance - starsقسم: array string[] | null
ہوٹل کے ستارے
اختیاری فیلڈ
اگر آپ صرف 5 ستارہ ہوٹل کی فہرست حاصل کرنا چاہتے ہیں تو یہ فیلڈ[5]پر سیٹ کریں
مثال:[3,4,5] - tagقسم: string | null
صارف کے متعین کردہ ٹاسک کا شناخت کنندہ
اختیاری فیلڈ
حروف کی حد 255 ہے
آپ اس پیرامیٹر سے ٹاسک کی شناخت کر سکتے ہیں اور اسے نتیجے سے ملا سکتے ہیں
آپ جواب کےdataآبجیکٹ میں متعین کردہtagقدر دیکھیں گے
- قسم: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskPostResponseInfo200
- قسم: number | null فارمیٹ: doublecost
ٹاسکس کی کل لاگت، USD
- قسم: integer | nullstatus
_code عمومی اسٹیٹس کوڈ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے
- قسم: string | nullstatus
_message عمومی معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے
- قسم: array (object | null)[] | nulltasks
ٹاسکس کی صف
- قسم: object | null · Response36Afe1097B20_BusinessDataGoogleHotelSearchesTaskPostTaskInfo
- costقسم: number | null فارمیٹ: double
ٹاسکس کی کل لاگت، USD
- dataقسم: object | null
وہی پیرامیٹرز رکھتا ہے جو آپ نے POST درخواست میں متعین کیے۔
- propertyقسم: object | null
Name
- idقسم: string | null
ٹاسک شناخت کنندہ ہمارے نظام میں UUID فارمیٹ کا منفرد ٹاسک شناخت کنندہ
- pathقسم: array (string | null)[] | null
URL پاتھ
- resultقسم: object | null
نتائج کی صف
اس صورت میں قدرnullہوگی - resultقسم: integer | null فارمیٹ: int64
_count result صف میں عناصر کی تعداد
- statusقسم: integer | null
_code ٹاسک کا اسٹیٹس کوڈ DataForSEO کی جانب سے تیار کردہ، درج ذیل حد میں ہو سکتا ہے: 10000-60000 رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے
- statusقسم: string | null
_message ٹاسک کا معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے
- timeقسم: string | null
عمل درآمد کا وقت، سیکنڈز
- قسم: integer | null فارمیٹ: int64tasks
_count tasks صف میں ٹاسکس کی تعداد
- قسم: integer | null فارمیٹ: int64tasks
_error خرابی کے ساتھ واپس ہونے والے tasks صف میں ٹاسکس کی تعداد
- قسم: string | nulltime
کل عمل درآمد کا وقت، سیکنڈ
- قسم: string | nullversion
API کا موجودہ ورژن
application/json - 400
درخواست پر کارروائی نہیں ہو سکی۔ درخواست کے پیرامیٹرز چیک کریں۔
- 401
درست Felo API کلید درکار ہے۔
- 402
درخواست آگے نہیں بڑھ سکتی کیونکہ بلنگ کی شرط پوری نہیں ہوئی۔
- 403
اکاؤنٹ کو یہ آپریشن کرنے کی اجازت نہیں۔
- 429
درخواست یا اخراجات کی حد پوری ہو گئی ہے۔
- 502
سروس درخواست مکمل نہیں کر سکی۔
- 503
API یا بلنگ سروس عارضی طور پر دستیاب نہیں۔
- 504
درخواست پر کارروائی کے دوران سروس کا وقت ختم ہو گیا۔
- default
خرابی کا جواب؛ اپ اسٹریم پاس تھرو جوابات پرووائیڈر کی شکلیں استعمال کر سکتے ہیں
application/json
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
}
]
}