# Airbnb 抓取參數

Web Scraper API Airbnb 抓取參數

使用 Thordata 的 Web Scraper API 配置 Airbnb 抓取參數，包括Airbnb 房源網址、位置、入住日期、退房日期、預訂人數、貨幣和其他參數。

**唯一标識：**

<details>

<summary><code>token</code> ，<strong>訪問令牌（必填）</strong></summary>

此參數用作 API 存取令牌，以確保抓取的合法性。

**請求範例：**

`Authorization: Bearer ********************`

```
curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer ********************" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=airbnb.com" ^
  -d "spider_id=airbnb_product_by-location" ^
  -d "spider_parameters=[{\"location\": \"Nice, France\",\"check_in\": \"2026-06-06\",\"check_out\": \"2026-06-010\",\"num_of_adults\": \"2\",\"num_of_children\": \"2\",\"num_of_infants\": \"0\",\"num_of_pets\": \"0\",\"country\": \"HK\",\"currency\": \"USD\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

**產品 - 抓取房源資訊：**

1\. Airbnb - 透過搜尋 URL 抓取房源信息

<details>

<summary><code>spider_id</code> ，<strong>抓取工具（必填）</strong></summary>

定義要使用的抓取工具。

**請求範例：**

`spider_id=airbnb_product_by-searchurl`

</details>

<details>

<summary><code>searchurl</code>，<strong>搜尋 URL （必填）</strong></summary>

此參數指定Airbnb網站上的搜尋網址。

**請求範例：**

`"searchurl": "https://www.airbnb.com/s/Greece/homes?query=Greece%26refinement_paths%5B%5D=%2Fhomes%26place_id=ChIJY2xxEcdKWxMRHS2a3HUXOjY%26flexible_trip_lengths%5B%5D=one_week%26monthly_start_date=2025-03-01%26monthly_length=3%26monthly_end_date=2025-06-01%26search_mode=regular_search%26price_filter_input_type=0%26channel=EXPLORE%26date_picker_type=calendar%26source=structured_search_input_header%26search_type=filter_change%26price_filter_num_nights=5%26flexible_date_search_filter_type=1"`

</details>

<details>

<summary><code>country</code>，<strong>國家/地區 （可選）</strong></summary>

此參數指定要從中收集資訊的國家/地區。

**請求範例：**

`"country": "US"`

</details>

<details>

<summary><strong>請求範例</strong></summary>

```sh
curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer Token-ID" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=airbnb.com" ^
  -d "spider_id=airbnb_product_by-searchurl" ^
  -d "spider_parameters=[{\"searchurl\": \"https://www.airbnb.com/s/Greece/homes?query=Greece%26refinement_paths%5B%5D=%2Fhomes%26place_id=ChIJY2xxEcdKWxMRHS2a3HUXOjY%26flexible_trip_lengths%5B%5D=one_week%26monthly_start_date=2025-03-01%26monthly_length=3%26monthly_end_date=2025-06-01%26search_mode=regular_search%26price_filter_input_type=0%26channel=EXPLORE%26date_picker_type=calendar%26source=structured_search_input_header%26search_type=filter_change%26price_filter_num_nights=5%26flexible_date_search_filter_type=1\",\"country\": \"US\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

2. Airbnb - 透過位置抓取房源資訊

<details>

<summary><code>spider_id</code> ，<strong>抓取工具（必填）</strong></summary>

定義要使用的抓取工具。

**請求範例：**

`spider_id=airbnb_product_by-location`

</details>

<details>

<summary><code>location</code>，<strong>位置（必填）</strong></summary>

此參數指定房源在 Airbnb 網站上的位置。

**請求範例：**

`"location": "Nice, France"`

</details>

<details>

<summary><code>check_in</code>，<strong>入住日期（選填）</strong></summary>

此參數指定入住日期。

**請求範例：**

`"check_in": "2026-06-06"`

</details>

<details>

<summary><code>check_out</code>，<strong>退房日期（选填）</strong></summary>

此參數指定退房日期。

**請求範例：**

`"check_out": "2026-06-10"`

</details>

<details>

<summary><code>num_of_adults</code>，<strong>成人人數（選填）</strong></summary>

此參數指定預訂的成人人數。

**請求範例：**

`"num_of_adults": "2"`

</details>

<details>

<summary><code>num_of_children</code>，<strong>儿童人数（选填）</strong></summary>

此参数指定预订的儿童人数。

**請求範例：**

`"num_of_children": "2"`

</details>

<details>

<summary><code>num_of_infants</code>，<strong>嬰兒數量（選填）</strong></summary>

此參數指定預訂的嬰兒數量。

**請求範例：**

`"num_of_infants": "0"`

</details>

<details>

<summary><code>num_of_pets</code>，<strong>寵物數量（選填）</strong></summary>

此參數指定預訂的寵物數量。

**請求範例：**

`"num_of_pets": "1"`

</details>

<details>

<summary><code>country</code>，<strong>國家/地區（選填）</strong></summary>

此參數指定要從中收集資訊的國家/地區。

**請求範例：**

`"country": "HK"`

</details>

<details>

<summary><code>currency</code>，<strong>貨幣（選填）</strong></summary>

此參數指定貨幣。

**請求範例：**

`"currency": "USD"`

</details>

<details>

<summary><strong>請求範例</strong></summary>

```sh
curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer Token-ID" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=airbnb.com" ^
  -d "spider_id=airbnb_product_by-location" ^
  -d "spider_parameters=[{\"location\": \"Nice, France\",\"check_in\": \"2026-06-06\",\"check_out\": \"2026-06-10\",\"num_of_adults\": \"2\",\"num_of_children\": \"2\",\"num_of_infants\": \"0\",\"num_of_pets\": \"1\",\"country\": \"HK\",\"currency\": \"USD\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

3. Airbnb - 透過 URL 抓取房源信息

<details>

<summary><code>spider_id</code> ，<strong>抓取工具（必填）</strong></summary>

定義要使用的抓取工具。

**請求範例：**

`spider_id=airbnb_product_by-url`

</details>

<details>

<summary><code>url</code>，<strong>URL （必填）</strong></summary>

此參數指定Airbnb網站上的URL。

**請求範例：**

`"url": "https://www.airbnb.com/rooms/21162039?search_mode=regular_search%26federated_search_id=1b9b58d9-8173-4981-af16-d28a7a3ece76%26locale=en%26currency=USD%26adults=2%26children=1%26infants=1%26pets=1%26check_in=2024-10-10%26source_impression_id=p3_1723723782_P31EcPsPoSdTizeX%26guests=1%26check_out=2024-10-20"`

</details>

<details>

<summary><code>country</code>，<strong>國家/地區（選填）</strong></summary>

此參數指定要從中收集資訊的國家/地區。

**請求範例：**

`"country": "US"`

</details>

<details>

<summary><strong>請求範例</strong></summary>

```sh
curl -X POST "https://scraperapi.thordata.com/builder" ^
  -H "Authorization: Bearer Token-ID" ^
  -H "Content-Type: application/x-www-form-urlencoded" ^
  -d "spider_name=airbnb.com" ^
  -d "spider_id=airbnb_product_by-url" ^
  -d "spider_parameters=[{\"url\": \"https://www.airbnb.com/rooms/21162039?search_mode=regular_search%26federated_search_id=1b9b58d9-8173-4981-af16-d28a7a3ece76%26locale=en%26currency=USD%26adults=2%26children=1%26infants=1%26pets=1%26check_in=2024-10-10%26source_impression_id=p3_1723723782_P31EcPsPoSdTizeX%26guests=1%26check_out=2024-10-20\",\"country\": \"US\"}]" ^
  -d "spider_errors=true" ^
  -d "file_name={{TasksID}}"
```

</details>

如果您需要進一步的協助，請透過電子郵件聯繫 <support@thordata.com>。