Felo API PlatformFelo API Platform
تمام DataForSEO endpoints
v0.2.0-beta
OpenAPI 3.1.0

Google Hotel Info ٹاسکس ترتیب دینا

Felo API Support
MIT
سرور:https://openapi.felo.ai
کلائنٹ لائبریریاں
Shell Curl

DataForSEO

​

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

DataForSEO آپریشنز

Google Hotel Info ٹاسکس ترتیب دینا

​

ہوٹل لسٹنگ کی تلاش قطار میں ڈالتا ہے اور ٹاسک id واپس کرتا ہے۔ DataForSEO کے لفافے میں لپٹا: ڈیٹا tasks[0].result میں، نتیجہ tasks[0].status_code میں - مسترد شدہ درخواست بھی HTTP 200 واپس کرتی ہے۔ پارس شدہ کے لیے get_dataforseo_business_google_hotel_info_fetch سے یا خام کے لیے get_dataforseo_business_google_hotel_info_fetch_html سے حاصل کریں۔

قیمت کا حوالہ

  • میٹرنگ: رپورٹ شدہ جواب کی لاگت۔
  • حوالہ جاتی درخواست کا تخمینہ: USD 0.2428۔
  • حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔

صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔

باڈی
application/json
  • قسم: array (object | null)[]
    • adults
      قسم: integer | null

      بالغوں کی تعداد
      اختیاری فیلڈ
      اگر آپ یہ فیلڈ متعین نہ کریں تو ڈیفالٹ طور پر دو بالغ استعمال ہوں گے
      مثال:
      1

    • check_in
      قسم: string | null

      چیک اِن تاریخ
      اختیاری فیلڈ
      اگر آپ یہ فیلڈ متعین نہ کریں تو ڈیفالٹ طور پر کل کی تاریخ استعمال ہوگی؛
      قدر آج کی تاریخ سے پہلے کی نہیں ہو سکتی
      تاریخ کی شکل: "yyyy-mm-dd"
      مثال:
      "2019-01-15"

    • check_out
      قسم: string | null

      چیک آؤٹ تاریخ
      اختیاری فیلڈ
      اگر آپ یہ فیلڈ متعین نہ کریں تو ہمارا سسٹم ڈیفالٹ طور پر آج سے دو دن بعد کی تاریخ لاگو کرے گا؛
      نوٹ: قدر check_in سے کم یا اس کے برابر نہیں ہو سکتی؛
      check_in اور check_out قدروں کے درمیان وقفہ 30 دن سے زیادہ نہیں ہو سکتا
      تاریخ کی شکل: "yyyy-mm-dd"
      مثال:
      "2019-01-15"

    • children
      قسم: array string[] | null

      بچوں کی تعداد اور عمر
      اختیاری فیلڈ
      اگر آپ یہ فیلڈ متعین نہ کریں تو تلاش میں کوئی بچہ شامل نہیں ہوگا؛

      اگر آپ ایک 14 سالہ بچہ شامل کرنا چاہتے ہیں تو درج ذیل قدر مقرر کریں:
      [14]
      اگر آپ ایک 13 سالہ بچہ اور ایک 8 سالہ بچہ شامل کرنا چاہتے ہیں تو درج ذیل قدر مقرر کریں:
      [13,8]

    • currency
      قسم: string | null

      کرنسی
      اختیاری فیلڈ
      مثال:
      "USD"

    • hotel_identifier
      قسم: string

      ہوٹل کا منفرد شناخت کنندہ
      اگر آپ keyword متعین نہ کریں تو درکار فیلڈ
      اگر آپ یہ فیلڈ استعمال کریں تو keyword متعین کرنے کی ضرورت نہیں
      Google تلاش میں ہوٹل ادارے کا منفرد شناخت کنندہ؛
      آپ یہ قدر Advanced Google SERP API (جواب کے hotels_pack عنصر میں شامل) یا Business Data API کے Hotel Searches endpoint پر درخواست بھیج کر حاصل کر سکتے ہیں
      مثال:
      ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE

    • keyword
      قسم: string

      کی ورڈ
      اگر آپ hotel_identifier متعین نہ کریں تو درکار فیلڈ
      اگر آپ یہ فیلڈ استعمال کریں تو hotel_identifier متعین کرنے کی ضرورت نہیں
      آپ جو کی ورڈ متعین کریں وہ ہوٹل ادارے کے نام کی نشاندہی کرنا چاہیے
      آپ keyword فیلڈ میں زیادہ سے زیادہ 700 حروف متعین کر سکتے ہیں
      تمام %## ڈی کوڈ ہوں گے (نیز ‘+’ حرف اسپیس حرف میں ڈی کوڈ ہوگا)
      اگر آپ کو اپنے keyword کے لیے “%” حرف استعمال کرنا ہو تو اسے “%25” کے طور پر متعین کریں

    • language_code
      قسم: string

      سرچ انجن زبان کا کوڈ
      اگر آپ language_name متعین نہ کریں تو درکار فیلڈ
      اگر آپ یہ فیلڈ استعمال کریں تو language_name متعین کرنے کی ضرورت نہیں
      آپ دستیاب زبانوں کی فہرست ان کے language_code_ کے ساتھ الگ درخواست بھیج کر https://api.dataforseo.com/v3/business_data/google/languages سے حاصل کر سکتے ہیں
      مثال:
      enn

    • language_name
      قسم: string

      سرچ انجن زبان کا پورا نام
      اگر آپ language_code متعین نہ کریں تو درکار فیلڈ
      اگر آپ یہ فیلڈ استعمال کریں تو language_code متعین کرنے کی ضرورت نہیں
      آپ دستیاب زبانوں کی فہرست language_name کے ساتھ الگ درخواست بھیج کر https://api.dataforseo.com/v3/business_data/google/languages سے حاصل کر سکتے ہیں
      مثال:
      English

    • load_prices_by_dates
      قسم: boolean | null

      تاریخوں کے حساب سے ہوٹل قیام کی قیمتیں لوڈ کریں
      اختیاری فیلڈ
      اگر آپ یہ پیرامیٹر true کے ساتھ متعین کریں تو جواب میں prices_by_dates صف شامل ہوگی جس میں ہوٹل قیام کی قیمتیں تاریخوں کے حساب سے تقسیم ہوں گی
      اگر آپ یہ پیرامیٹر استعمال کریں تو آپ سے فی درخواست بنیادی قیمت کی دو گنا رقم لی جائے گی

    • location_code
      قسم: integer

      سرچ انجن مقام کا کوڈ
      اگر آپ location_name_ یا location_coordinate متعین نہ کریں تو درکار فیلڈ
      اگر آپ یہ فیلڈ استعمال کریں تو location_name یا location_coordinate متعین کرنے کی ضرورت نہیں
      آپ دستیاب مقامات کی فہرست location_code کے ساتھ الگ درخواست بھیج کر https://api.dataforseo.com/v3/business_data/google/locations سے حاصل کر سکتے ہیں
      مثال:
      2840n

    • location_coordinate
      قسم: string

      مقام کے GPS کوآرڈینیٹس
      اگر آپ location_name_ یا location_code متعین نہ کریں تو درکار فیلڈ
      اگر آپ یہ فیلڈ استعمال کریں تو location_name یا location_code متعین کرنے کی ضرورت نہیں
      location_coordinate پیرامیٹر "latitude,longitude" فارمیٹ میں متعین کرنا چاہیے
      "latitude" اور "longitude" کے لیے زیادہ سے زیادہ اعشاریہ ہندسے: 7
      نوٹ: اگر کوآرڈینیٹس مقام متعین کرنے کے لیے استعمال ہوں تو تلاش قریبی بستی میں ہوگی؛
      مثال:
      53.476225,-2.243572n

    • 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

    • pingback_url
      قسم: string | null

      مکمل شدہ ٹاسک کا نوٹیفکیشن URL
      اختیاری فیلڈ
      ٹاسک مکمل ہونے پر ہم آپ کو آپ کے متعین کردہ URL پر GET درخواست بھیج کر مطلع کریں گے؛
      آپ ‘$id’ اسٹرنگ کو $id متغیر کے طور پر اور ‘$tag’ کو urlencoded $tag متغیر کے طور پر استعمال کر سکتے ہیں؛
      ہم درخواست بھیجنے سے پہلے ضروری اقدار سیٹ کر دیں گے؛
      مثال:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      نوٹ: pingback_url میں خصوصی حروف urlencoded ہو جائیں گے؛
      یعنی، # حرف %23 میں انکوڈ ہو جائے گا

      ہمارے Help Center پر مزید جانیں

    • postback_data
      قسم: string

      postback_url ڈیٹا ٹائپ
      اگر آپ postback_url متعین کریں تو درکار فیلڈ
      اس ڈیٹا ٹائپ سے مطابقت رکھتا ہے جو آپ کے سرور کو بھیجا جائے گا
      ممکنہ اقدار:
      advanced, html

    • postback_url
      قسم: string | null

      ٹاسک کے نتائج بھیجنے کے لیے URL
      اختیاری فیلڈ
      ٹاسک مکمل ہونے کے بعد ہم اس کے نتائج کو gzip فارمیٹ میں کمپریس کر کے آپ کے متعین کردہ postback_url پر POST درخواست کے ذریعے بھیجیں گے؛
      آپ ‘$id’ اسٹرنگ کو $id متغیر کے طور پر اور ‘$tag’ کو urlencoded $tag متغیر کے طور پر استعمال کر سکتے ہیں۔ ہم درخواست بھیجنے سے پہلے ضروری اقدار سیٹ کر دیں گے؛
      مثال:
      http://your-server.com/postbackscript?id=$id
      http://your-server.com/postbackscript?id=$id&tag=$tag
      نوٹ: postback_url میں خصوصی حروف urlencoded ہو جائیں گے؛
      یعنی، # حرف %23 میں انکوڈ ہو جائے گا

      ہمارے Help Center پر مزید جانیں

    • prices_date_range
      قسم: string | null

      روزانہ قیمت کا ڈیٹا حاصل کرنے کے لیے پیشگی متعین مدت
      اختیاری فیلڈ
      یہ پیرامیٹر استعمال کرنے کے لیے آپ کو load_prices_by_dates کو true کے ساتھ متعین کرنا ہوگا
      اگر prices_start_date متعین نہ ہو تو آغاز کی تاریخ check_in تاریخ پر سیٹ ہوتی ہے
      ممکنہ اقدار: month, three_months, six_months, year
      ڈیفالٹ قدر: month

    • prices_end_date
      قسم: string | null

      تاریخوں کے حساب سے قیمتیں لوڈ کرنے کی آخری تاریخ
      اختیاری فیلڈ
      یہ پیرامیٹر استعمال کرنے کے لیے آپ کو load_prices_by_dates کو true کے ساتھ متعین کرنا ہوگا
      اگر یہ پیرامیٹر متعین نہ ہو تو آپ کو ایک ماہ کی تاریخ کے حساب سے قیمتیں ملیں گی
      تاریخ کی شکل: yyyy-mm-dd
      مثال:
      2025-05-21

    • prices_start_date
      قسم: string | null

      تاریخوں کے حساب سے قیمتیں لوڈ کرنے کی آغاز تاریخ
      اختیاری فیلڈ
      یہ پیرامیٹر استعمال کرنے کے لیے آپ کو load_prices_by_dates کو true کے ساتھ متعین کرنا ہوگا
      اگر یہ پیرامیٹر متعین نہ ہو تو آغاز کی تاریخ check_in تاریخ پر سیٹ ہوتی ہے
      تاریخ کی شکل: yyyy-mm-dd
      مثال:
      2025-05-20

    • priority
      قسم: integer | null

      ٹاسک کی ترجیح
      اختیاری فیلڈ
      درج ذیل اقدار لے سکتا ہے:
      1 – معمول کی عمل درآمد کی ترجیح (ڈیفالٹ طور پر سیٹ)
      2 – اعلیٰ عمل درآمد کی ترجیح۔ اعلیٰ عمل درآمد کی ترجیح والے ٹاسکس پر آپ سے اضافی چارج لیا جائے گا۔
      لاگت Pricing صفحے پر شمار کی جا سکتی ہے۔

    • tag
      قسم: string | null

      صارف کے متعین کردہ ٹاسک کا شناخت کنندہ
      اختیاری فیلڈ
      حروف کی حد 255 ہے؛
      آپ اس پیرامیٹر سے ٹاسک کی شناخت کر سکتے ہیں اور اسے نتیجے سے ملا سکتے ہیں؛
      آپ جواب کے data آبجیکٹ میں متعین کردہ tag قدر دیکھیں گے

جوابات
  • 200
    قسم: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoTaskPostResponseInfo
    • cost
      قسم: number | null فارمیٹ: double

      ٹاسکس کی کل لاگت، USD

    • status_code
      قسم: integer | null

      عمومی اسٹیٹس کوڈ رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے

    • status_message
      قسم: string | null

      عمومی معلوماتی پیغام عمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے

    • tasks
      قسم: array (object | null)[] | null

      ٹاسکس کی صف

      • قسم: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoTaskPostTaskInfo
        • cost
          قسم: number | null فارمیٹ: double

          ٹاسکس کی کل لاگت، USD

        • data
          قسم: object | null

          وہی پیرامیٹرز رکھتا ہے جو آپ نے POST درخواست میں متعین کیے۔

          • 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 رسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے

        • 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

    درخواست پر کارروائی نہیں ہو سکی۔ درخواست کے پیرامیٹرز چیک کریں۔

  • 401

    درست Felo API کلید درکار ہے۔

  • 402

    درخواست آگے نہیں بڑھ سکتی کیونکہ بلنگ کی شرط پوری نہیں ہوئی۔

  • 403

    اکاؤنٹ کو یہ آپریشن کرنے کی اجازت نہیں۔

  • 429

    درخواست یا اخراجات کی حد پوری ہو گئی ہے۔

  • 502

    سروس درخواست مکمل نہیں کر سکی۔

  • 503

    API یا بلنگ سروس عارضی طور پر دستیاب نہیں۔

  • 504

    درخواست پر کارروائی کے دوران سروس کا وقت ختم ہو گیا۔

  • default

    خرابی کا جواب؛ اپ اسٹریم پاس تھرو جوابات پرووائیڈر کی شکلیں استعمال کر سکتے ہیں

    application/json
Request Example for post/v1/beta/dataforseo/business_data/google/hotel_info/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_info/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",
    "hotel_identifier": "ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE",
    "tag": "some_string_123",
    "postback_url": "https://your-server.com/postbackscript.php",
    "postback_data": "advanced"
  }
]'

{
  "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
    }
  ]
}

کامیاب آپریشن

Setting Google Hotel Info Tasks