# 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>.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.thordata.com/doc/scraping/web-scraper-api/parameter-description/airbnb-scraping-parameters.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.