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:

token，Access 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_id ，Scraper tool (required)

Defines which scraper tool to use.

Request examples:

spider_id=airbnb_product_by-searchurl

searchurl，Search 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"

country，Country (optional)

This parameter specifies the country to collect the information from.

Request examples:

"country": "US"

Request examples

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

1. Airbnb - Scrape properties information by location

spider_id ，Scraper tool (required)

Defines which scraper tool to use.

Request examples:

spider_id=airbnb_product_by-location

location，location (required)

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

Request examples:

"location": "Nice, France"

check_in，Check-in date (optional)

This parameter specifies the Check-in date.

Request examples:

"check_in": "2026-06-06"

check_out，Check-out date (optional)

This parameter specifies the Check-out date.

Request examples:

"check_out": "2026-06-10"

num_of_adults，Number of adults (optional)

This parameter specifies the number of adults booking.

Request examples:

"num_of_adults": "2"

num_of_children，Number of children (optional)

This parameter specifies the number of children booking.

Request examples:

"num_of_children": "2"

num_of_infants，Number of infants (optional)

This parameter specifies the number of infants booking.

Request examples:

"num_of_infants": "0"

num_of_pets，Number of pets (optional)

This parameter specifies the number of pets booking.

Request examples:

"num_of_pets": "1"

country，Country (optional)

This parameter specifies the country to collect the information from.

Request examples:

"country": "HK"

currency，currency(optional)

This parameter specifies the currency.

Request examples:

"currency": "USD"

Request examples

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

1. Airbnb - Scrape properties information by URL

spider_id ，Scraper tool (required)

Defines which scraper tool to use.

Request examples:

spider_id=airbnb_product_by-url

url，URL (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"

country，Country (optional)

This parameter specifies the country to collect the information from.

Request examples:

"country": "US"

Request examples

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

If you need further assistance, please contact us via email at [e-mail].