For the complete documentation index, see llms.txt. This page is also available as Markdown.

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:

tokenAccess token(required)

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

Request examples:

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

Product - Scrape properties information:

1. Airbnb - Scrape properties information by search URL

spider_idScraper tool (required)

Defines which scraper tool to use.

Request examples:

spider_id=airbnb_product_by-searchurl

searchurlSearch URL (required)

This parameter specifies the search URL on the airbnb site.

Request examples:

"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"

countryCountry (optional)

This parameter specifies the country to collect the information from.

Request examples:

"country": "US"

Request examples
  1. Airbnb - Scrape properties information by location

spider_idScraper tool (required)

Defines which scraper tool to use.

Request examples:

spider_id=airbnb_product_by-location

locationlocation (required)

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

Request examples:

"location": "Nice, France"

check_inCheck-in date (optional)

This parameter specifies the Check-in date.

Request examples:

"check_in": "2026-06-06"

check_outCheck-out date (optional)

This parameter specifies the Check-out date.

Request examples:

"check_out": "2026-06-10"

num_of_adultsNumber of adults (optional)

This parameter specifies the number of adults booking.

Request examples:

"num_of_adults": "2"

num_of_childrenNumber of children (optional)

This parameter specifies the number of children booking.

Request examples:

"num_of_children": "2"

num_of_infantsNumber of infants (optional)

This parameter specifies the number of infants booking.

Request examples:

"num_of_infants": "0"

num_of_petsNumber of pets (optional)

This parameter specifies the number of pets booking.

Request examples:

"num_of_pets": "1"

countryCountry (optional)

This parameter specifies the country to collect the information from.

Request examples:

"country": "HK"

currencycurrency(optional)

This parameter specifies the currency.

Request examples:

"currency": "USD"

Request examples
  1. Airbnb - Scrape properties information by URL

spider_idScraper tool (required)

Defines which scraper tool to use.

Request examples:

spider_id=airbnb_product_by-url

urlURL (required)

This parameter specifies the URL on the airbnb site.

Request examples:

"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"

countryCountry (optional)

This parameter specifies the country to collect the information from.

Request examples:

"country": "US"

Request examples

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

Last updated