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

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/business_data/google/hotel_info/task_post`

**Tags:** DataForSEO

ہوٹل لسٹنگ کی تلاش قطار میں ڈالتا ہے اور ٹاسک `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 کے بلنگ ریکارڈز کے مطابق ہوں گے۔

## Related links

- [Google SERP API](<https://docs.dataforseo.com/v3/serp/google/organic/overview/>)
- [Hotel Searches endpoint](<https://docs.dataforseo.com/v3/business_data/google/hotel_searches/task_post/>)
- [Pricing](<https://dataforseo.com/pricing/business-data/google-hotels-api>)
- [Help Center](<https://dataforseo.com/help-center/pingbacks-postbacks-with-dataforseo-api>)

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **no**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "hotel_identifier": {
            "type": "string",
            "description": "<em>ہوٹل کا منفرد شناخت کنندہ</em><br><strong>اگر آپ <code>keyword</code> متعین نہ کریں تو درکار فیلڈ</strong><br><strong>اگر آپ یہ فیلڈ استعمال کریں تو <code>keyword</code> متعین کرنے کی ضرورت نہیں</strong><br>Google تلاش میں ہوٹل ادارے کا منفرد شناخت کنندہ؛<br>آپ یہ قدر Advanced Google SERP API (جواب کے <code>hotels_pack</code> عنصر میں شامل) یا Business Data API کے Hotel Searches endpoint پر درخواست بھیج کر حاصل کر سکتے ہیں<br>مثال:<br><code>ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE</code>"
          },
          "keyword": {
            "type": "string",
            "description": "<em>کی ورڈ</em><br><strong>اگر آپ <code>hotel_identifier</code> متعین نہ کریں تو درکار فیلڈ</strong><br><strong>اگر آپ یہ فیلڈ استعمال کریں تو <code>hotel_identifier</code> متعین کرنے کی ضرورت نہیں</strong><br>آپ جو کی ورڈ متعین کریں وہ ہوٹل ادارے کے نام کی نشاندہی کرنا چاہیے<br>آپ <code>keyword</code> فیلڈ میں <strong>زیادہ سے زیادہ 700 حروف</strong> متعین کر سکتے ہیں<br><strong>تمام %## ڈی کوڈ ہوں گے (نیز ‘+’ حرف اسپیس حرف میں ڈی کوڈ ہوگا)</strong><br>اگر آپ کو اپنے <code>keyword</code> کے لیے “%” حرف استعمال کرنا ہو تو اسے “%25” کے طور پر متعین کریں"
          },
          "priority": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>ٹاسک کی ترجیح</em><br>اختیاری فیلڈ<br>درج ذیل اقدار لے سکتا ہے:<br>1 – معمول کی عمل درآمد کی ترجیح (ڈیفالٹ طور پر سیٹ)<br>2 – اعلیٰ عمل درآمد کی ترجیح۔ اعلیٰ عمل درآمد کی ترجیح والے ٹاسکس پر آپ سے اضافی چارج لیا جائے گا۔<br>لاگت Pricing صفحے پر شمار کی جا سکتی ہے۔"
          },
          "location_name": {
            "type": "string",
            "description": "<em>سرچ انجن مقام کا پورا نام</em><br><strong>اگر آپ <code>location_code</code> یا <code>location_coordinate</code> متعین نہ کریں تو درکار فیلڈ</strong><br><strong>اگر آپ یہ فیلڈ استعمال کریں تو <code>location_code</code> یا <code>location_coordinate</code> متعین کرنے کی ضرورت نہیں</strong><br>آپ دستیاب مقامات کی فہرست <code>location_name</code> کے ساتھ الگ درخواست بھیج کر <code>https://api.dataforseo.com/v3/business_data/google/locations</code> سے حاصل کر سکتے ہیں<br>مثال:<br><code class=\"long-string\">London,England,United Kingdom</code>"
          },
          "location_code": {
            "type": "integer",
            "description": "<em>سرچ انجن مقام کا کوڈ</em><br><strong>اگر آپ <code>location_name</code>_ یا <code>location_coordinate</code> متعین نہ کریں تو درکار فیلڈ</strong><br><strong>اگر آپ یہ فیلڈ استعمال کریں تو <code>location_name</code> یا <code>location_coordinate</code> متعین کرنے کی ضرورت نہیں</strong><br>آپ دستیاب مقامات کی فہرست <code>location_code</code> کے ساتھ الگ درخواست بھیج کر <code>https://api.dataforseo.com/v3/business_data/google/locations</code> سے حاصل کر سکتے ہیں<br>مثال:<br><code class=\"long-string\">2840</code>n"
          },
          "location_coordinate": {
            "type": "string",
            "description": "<em>مقام کے GPS کوآرڈینیٹس</em><br><strong>اگر آپ <code>location_name</code>_ یا <code>location_code</code> متعین نہ کریں تو درکار فیلڈ</strong><br><strong>اگر آپ یہ فیلڈ استعمال کریں تو <code>location_name</code> یا <code>location_code</code> متعین کرنے کی ضرورت نہیں</strong><br><code>location_coordinate</code> پیرامیٹر <em>\"latitude,longitude\"</em> فارمیٹ میں متعین کرنا چاہیے<br><em>\"latitude\"</em> اور <em>\"longitude\"</em> کے لیے زیادہ سے زیادہ اعشاریہ ہندسے: 7<br><strong>نوٹ</strong>: اگر کوآرڈینیٹس مقام متعین کرنے کے لیے استعمال ہوں تو تلاش قریبی بستی میں ہوگی؛<br>مثال:<br><code class=\"long-string\">53.476225,-2.243572</code>n"
          },
          "language_name": {
            "type": "string",
            "description": "<em>سرچ انجن زبان کا پورا نام</em><br><strong>اگر آپ <code>language_code</code> متعین نہ کریں تو درکار فیلڈ</strong><br><strong>اگر آپ یہ فیلڈ استعمال کریں تو <code>language_code</code> متعین کرنے کی ضرورت نہیں</strong><br>آپ دستیاب زبانوں کی فہرست <code>language_name</code> کے ساتھ الگ درخواست بھیج کر <code>https://api.dataforseo.com/v3/business_data/google/languages</code> سے حاصل کر سکتے ہیں<br>مثال:<br><code class=\"long-string\">English</code>"
          },
          "language_code": {
            "type": "string",
            "description": "<em>سرچ انجن زبان کا کوڈ</em><br><strong>اگر آپ <code>language_name</code> متعین نہ کریں تو درکار فیلڈ</strong><br><strong>اگر آپ یہ فیلڈ استعمال کریں تو <code>language_name</code> متعین کرنے کی ضرورت نہیں</strong><br>آپ دستیاب زبانوں کی فہرست ان کے <code>language_code</code>_ کے ساتھ الگ درخواست بھیج کر <code>https://api.dataforseo.com/v3/business_data/google/languages</code> سے حاصل کر سکتے ہیں<em><br></em>مثال:<em><br></em><code class=\"long-string\">en</code>n"
          },
          "check_in": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>چیک اِن تاریخ</em><br>اختیاری فیلڈ<br>اگر آپ یہ فیلڈ متعین نہ کریں تو ڈیفالٹ طور پر کل کی تاریخ استعمال ہوگی؛<br>قدر آج کی تاریخ سے پہلے کی نہیں ہو سکتی<br>تاریخ کی شکل: <code>\"yyyy-mm-dd\"</code><br>مثال:<br><code>\"2019-01-15\"</code>"
          },
          "check_out": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>چیک آؤٹ تاریخ</em><br>اختیاری فیلڈ<br>اگر آپ یہ فیلڈ متعین نہ کریں تو ہمارا سسٹم ڈیفالٹ طور پر آج سے دو دن بعد کی تاریخ لاگو کرے گا؛<br><strong>نوٹ:</strong> قدر <code>check_in</code> سے کم یا اس کے برابر نہیں ہو سکتی؛<br><code>check_in</code> اور <code>check_out</code> قدروں کے درمیان وقفہ 30 دن سے زیادہ نہیں ہو سکتا<br>تاریخ کی شکل: <code>\"yyyy-mm-dd\"</code><br>مثال:<br><code>\"2019-01-15\"</code>"
          },
          "currency": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>کرنسی</em><br>اختیاری فیلڈ<br>مثال:<br><code>\"USD\"</code>"
          },
          "adults": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>بالغوں کی تعداد</em><br>اختیاری فیلڈ<br>اگر آپ یہ فیلڈ متعین نہ کریں تو ڈیفالٹ طور پر دو بالغ استعمال ہوں گے<br>مثال:<br><code>1</code>"
          },
          "children": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>بچوں کی تعداد اور عمر</em><br>اختیاری فیلڈ<br>اگر آپ یہ فیلڈ متعین نہ کریں تو تلاش میں کوئی بچہ شامل نہیں ہوگا؛<p>اگر آپ ایک 14 سالہ بچہ شامل کرنا چاہتے ہیں تو درج ذیل قدر مقرر کریں:<br><code>[14]</code><br>اگر آپ ایک 13 سالہ بچہ اور ایک 8 سالہ بچہ شامل کرنا چاہتے ہیں تو درج ذیل قدر مقرر کریں:<br><code>[13,8]</code>"
          },
          "load_prices_by_dates": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>تاریخوں کے حساب سے ہوٹل قیام کی قیمتیں لوڈ کریں</em><br>اختیاری فیلڈ<br>اگر آپ یہ پیرامیٹر <code>true</code> کے ساتھ متعین کریں تو جواب میں <code>prices_by_dates</code> صف شامل ہوگی جس میں ہوٹل قیام کی قیمتیں تاریخوں کے حساب سے تقسیم ہوں گی<br>اگر آپ یہ پیرامیٹر استعمال کریں تو آپ سے <strong>فی درخواست بنیادی قیمت کی دو گنا</strong> رقم لی جائے گی"
          },
          "prices_start_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>تاریخوں کے حساب سے قیمتیں لوڈ کرنے کی آغاز تاریخ</em><br>اختیاری فیلڈ<br>یہ پیرامیٹر استعمال کرنے کے لیے آپ کو <code>load_prices_by_dates</code> کو <code>true</code> کے ساتھ متعین کرنا ہوگا<br>اگر یہ پیرامیٹر متعین نہ ہو تو آغاز کی تاریخ <code>check_in</code> تاریخ پر سیٹ ہوتی ہے<br>تاریخ کی شکل: <code>yyyy-mm-dd</code><br>مثال:<br><code>2025-05-20</code>"
          },
          "prices_end_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>تاریخوں کے حساب سے قیمتیں لوڈ کرنے کی آخری تاریخ</em><br>اختیاری فیلڈ<br>یہ پیرامیٹر استعمال کرنے کے لیے آپ کو <code>load_prices_by_dates</code> کو <code>true</code> کے ساتھ متعین کرنا ہوگا<br>اگر یہ پیرامیٹر متعین نہ ہو تو آپ کو ایک ماہ کی تاریخ کے حساب سے قیمتیں ملیں گی <br>تاریخ کی شکل: <code>yyyy-mm-dd</code><br>مثال:<br><code>2025-05-21</code>"
          },
          "prices_date_range": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>روزانہ قیمت کا ڈیٹا حاصل کرنے کے لیے پیشگی متعین مدت</em><br>اختیاری فیلڈ<br>یہ پیرامیٹر استعمال کرنے کے لیے آپ کو <code>load_prices_by_dates</code> کو <code>true</code> کے ساتھ متعین کرنا ہوگا<br>اگر <code>prices_start_date </code> متعین نہ ہو تو آغاز کی تاریخ <code>check_in</code> تاریخ پر سیٹ ہوتی ہے<br>ممکنہ اقدار: <code>month</code>, <code>three_months</code>, <code>six_months</code>, <code>year</code><br>ڈیفالٹ قدر: <code>month</code>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>صارف کے متعین کردہ ٹاسک کا شناخت کنندہ</em><br>اختیاری فیلڈ<br><em>حروف کی حد 255 ہے؛</em><br>آپ اس پیرامیٹر سے ٹاسک کی شناخت کر سکتے ہیں اور اسے نتیجے سے ملا سکتے ہیں؛<br>آپ جواب کے <code>data</code> آبجیکٹ میں متعین کردہ <code>tag</code> قدر دیکھیں گے"
          },
          "postback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>ٹاسک کے نتائج بھیجنے کے لیے URL</em><br>اختیاری فیلڈ<br>ٹاسک مکمل ہونے کے بعد ہم اس کے نتائج کو <code>gzip</code> فارمیٹ میں کمپریس کر کے آپ کے متعین کردہ <code>postback_url</code> پر POST درخواست کے ذریعے بھیجیں گے؛<br>آپ ‘$id’ اسٹرنگ کو <code>$id</code> متغیر کے طور پر اور ‘$tag’ کو urlencoded <code>$tag</code> متغیر کے طور پر استعمال کر سکتے ہیں۔ ہم درخواست بھیجنے سے پہلے ضروری اقدار سیٹ کر دیں گے؛<br>مثال:<br><code>http://your-server.com/postbackscript?id=$id</code><br><code>http://your-server.com/postbackscript?id=$id&amp;tag=$tag</code><br><strong>نوٹ:</strong> <code>postback_url</code> میں خصوصی حروف urlencoded ہو جائیں گے؛ <br>یعنی، <code>#</code> حرف <code>%23</code> میں انکوڈ ہو جائے گا<p>ہمارے Help Center پر مزید جانیں"
          },
          "postback_data": {
            "type": "string",
            "description": "<em>postback_url ڈیٹا ٹائپ</em><br><strong>اگر آپ <code>postback_url</code> متعین کریں تو درکار فیلڈ</strong><br>اس ڈیٹا ٹائپ سے مطابقت رکھتا ہے جو آپ کے سرور کو بھیجا جائے گا<br>ممکنہ اقدار:<br><code>advanced</code>, <code>html</code>"
          },
          "pingback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>مکمل شدہ ٹاسک کا نوٹیفکیشن URL</em><br>اختیاری فیلڈ<br>ٹاسک مکمل ہونے پر ہم آپ کو آپ کے متعین کردہ URL پر GET درخواست بھیج کر مطلع کریں گے؛<br>آپ ‘$id’ اسٹرنگ کو <code>$id</code> متغیر کے طور پر اور ‘$tag’ کو urlencoded <code>$tag</code> متغیر کے طور پر استعمال کر سکتے ہیں؛<br>ہم درخواست بھیجنے سے پہلے ضروری اقدار سیٹ کر دیں گے؛<br>مثال:<br><code>http://your-server.com/pingscript?id=$id</code><br><code>http://your-server.com/pingscript?id=$id&amp;tag=$tag</code><br><strong>نوٹ:</strong> <code>pingback_url</code> میں خصوصی حروف urlencoded ہو جائیں گے؛ <br>یعنی، <code>#</code> حرف <code>%23</code> میں انکوڈ ہو جائے گا<p>ہمارے Help Center پر مزید جانیں"
          }
        },
        "example": [
          {
            "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"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "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"
    }
  ]
}
```

## Responses

### 200 — کامیاب آپریشن

Headers:
- `X-Request-Id` (string) — Felo سپورٹ سے رابطہ کرتے وقت شامل کرنے کے لیے درخواست کا شناخت کنندہ۔

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataGoogleHotelInfoTaskPostResponseInfo"
    }
  ]
}
```

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

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

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

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

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

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

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

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

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

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "API کا موجودہ ورژن"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "عمومی اسٹیٹس کوڈ\nرسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "عمومی معلوماتی پیغام\nعمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "کل عمل درآمد کا وقت، سیکنڈ"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "ٹاسکس کی کل لاگت، USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "tasks صف میں ٹاسکس کی تعداد",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "خرابی کے ساتھ واپس ہونے والے tasks صف میں ٹاسکس کی تعداد",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "ٹاسک شناخت کنندہ\nہمارے نظام میں UUID فارمیٹ کا منفرد ٹاسک شناخت کنندہ"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "ٹاسک کا اسٹیٹس کوڈ\nDataForSEO کی جانب سے تیار کردہ، درج ذیل حد میں ہو سکتا ہے: 10000-60000\nرسپانس کوڈز کی مکمل فہرست یہاں مل سکتی ہے"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "ٹاسک کا معلوماتی پیغام\nعمومی معلوماتی پیغامات کی مکمل فہرست یہاں مل سکتی ہے"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "عمل درآمد کا وقت، سیکنڈز"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "ٹاسکس کی کل لاگت، USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "result صف میں عناصر کی تعداد",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "URL پاتھ"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "وہی پیرامیٹرز رکھتا ہے جو آپ نے POST درخواست میں متعین کیے۔"
    }
  }
}
```

### Response36Afe1097B20_BusinessDataGoogleHotelInfoTaskPostResponseInfo

`#/components/schemas/Response36Afe1097B20_BusinessDataGoogleHotelInfoTaskPostResponseInfo`

```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_BusinessDataGoogleHotelInfoTaskPostTaskInfo"
              }
            ]
          },
          "description": "<em>ٹاسکس کی صف</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_BusinessDataGoogleHotelInfoTaskPostTaskInfo

`#/components/schemas/Response36Afe1097B20_BusinessDataGoogleHotelInfoTaskPostTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "object",
            "null"
          ],
          "description": "<em>نتائج کی صف</em><br>اس صورت میں قدر <code>null</code> ہوگی"
        }
      }
    }
  ]
}
```
