> For the complete documentation index, see [llms.txt](https://doc.thordata.com/doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.thordata.com/doc/scraping/web-scraper-api/parameter-description/airbnb-scraping-parameters.md).

# Airbnb Scraping Parameters

Web Scraper API  Airbnb Scraping Parameters

Configure Airbnb Scraping Parameters using Thordata's Web Scraper API, including Airbnb URL,  location, Check-in date, Check-out date, Number of people booking, currency and other parameters.

Unique Identifier: 

<details>

<summary><code>token</code>，<strong>Access token(required)</strong></summary>

This parameter is used as the API access token to ensure the legitimacy of the scraping request.

**Request examples:**&#x20;

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

```sh
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>

**Product - Scrape properties information:**

1\. Airbnb - Scrape properties information by search URL

<details>

<summary><code>spider_id</code> ，<strong>Scraper tool (required)</strong></summary>

Defines which scraper tool to use.

**Request examples:**&#x20;

`spider_id=airbnb_product_by-searchurl`

</details>

<details>

<summary><code>searchurl</code>，<strong>Search URL (required)</strong></summary>

This parameter specifies the search URL on the airbnb site.

**Request examples:**&#x20;

`"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>Country (optional)</strong></summary>

This parameter specifies the country to collect the information from.

**Request examples:**&#x20;

`"country": "US"`

</details>

<details>

<summary><strong>Request examples</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 - Scrape properties information by location

<details>

<summary><code>spider_id</code> ，<strong>Scraper tool (required)</strong></summary>

Defines which scraper tool to use.

**Request examples:**&#x20;

`spider_id=airbnb_product_by-location`

</details>

<details>

<summary><code>location</code>，<strong>location (required)</strong></summary>

This parameter specifies the location of the properties on the airbnb site.

**Request examples:**&#x20;

`"location": "Nice, France"`

</details>

<details>

<summary><code>check_in</code>，<strong>Check-in date (optional)</strong></summary>

This parameter specifies the Check-in date.

**Request examples:**&#x20;

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

</details>

<details>

<summary><code>check_out</code>，<strong>Check-out date (optional)</strong></summary>

This parameter specifies the Check-out date.

**Request examples:**&#x20;

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

</details>

<details>

<summary><code>num_of_adults</code>，<strong>Number of adults (optional)</strong></summary>

This parameter specifies the number of adults booking.

**Request examples:**&#x20;

`"num_of_adults": "2"`

</details>

<details>

<summary><code>num_of_children</code>，<strong>Number of children (optional)</strong></summary>

This parameter specifies the number of children booking.

**Request examples:**&#x20;

`"num_of_children": "2"`

</details>

<details>

<summary><code>num_of_infants</code>，<strong>Number of infants (optional)</strong></summary>

This parameter specifies the number of infants booking.

**Request examples:**&#x20;

`"num_of_infants": "0"`

</details>

<details>

<summary><code>num_of_pets</code>，<strong>Number of pets (optional)</strong></summary>

This parameter specifies the number of pets booking.

**Request examples:**&#x20;

`"num_of_pets": "1"`

</details>

<details>

<summary><code>country</code>，<strong>Country (optional)</strong></summary>

This parameter specifies the country to collect the information from.

**Request examples:**&#x20;

`"country": "HK"`

</details>

<details>

<summary><code>currency</code>，<strong>currency(optional)</strong></summary>

This parameter specifies the currency.

**Request examples:**&#x20;

`"currency": "USD"`

</details>

<details>

<summary><strong>Request examples</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 - Scrape properties information by URL

<details>

<summary><code>spider_id</code> ，<strong>Scraper tool (required)</strong></summary>

Defines which scraper tool to use.

**Request examples:**&#x20;

`spider_id=airbnb_product_by-url`

</details>

<details>

<summary><code>url</code>，<strong>URL (required)</strong></summary>

This parameter specifies the  URL on the airbnb site.

**Request examples:**&#x20;

`"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>Country (optional)</strong></summary>

This parameter specifies the country to collect the information from.

**Request examples:**&#x20;

`"country": "US"`

</details>

<details>

<summary><strong>Request examples</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>

If you need further assistance, please contact us via email at <support@thordata.com>.