# Expedia Hotels Scraper (`shahidirfan/expedia-hotels-scraper`) Actor Extract hotel data from Expedia instantly. Scrape prices, reviews, ratings, availability & amenities across destinations. Perfect for travel research, price monitoring & market analysis. Get structured hotel information for comparison & analytics. No coding required. - **URL**: https://apify.com/shahidirfan/expedia-hotels-scraper.md - **Developed by:** [Shahid Irfan](https://apify.com/shahidirfan) (community) - **Categories:** Travel, Automation, Developer tools - **Stats:** 1 total users, 1 monthly users, 75.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Expedia Hotels Listings Scraper Extract structured Expedia hotel listing data from Hotel-Search result pages. Collect prices, ratings, property links, listing metadata, and search context for analysis, monitoring, and travel intelligence workflows. --- ### Features - **Hotel listings extraction** - Capture Expedia search-result cards with core property metadata. - **Rich pricing details** - Collect nightly, total, and strikeout prices when available. - **Rating and review context** - Include stars, guest score, and review counts. - **Clean output records** - Automatically omit empty values instead of storing null fields. - **Duplicate-safe collection** - Save each hotel once per run using hotel ID deduplication. --- ### Use Cases #### Price Monitoring Track hotel prices across destinations and travel windows to identify spikes, drops, and seasonal movement. #### Market Comparison Benchmark competing properties in the same region by rating, review volume, and price visibility. #### Travel Dataset Building Generate structured hotel datasets for BI dashboards, forecasting, and internal travel tools. #### Offer Intelligence Analyze member-price indicators, strikeout price patterns, and cancellation signals at listing level. --- ### Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `startUrl` | String | No | Expedia London Hotel-Search URL | Direct Expedia Hotel-Search URL. If provided, it overrides manual filters. | | `regionId` | String | No | `6139104` | Expedia region ID used when `startUrl` is not provided. | | `destination` | String | No | `London, United Kingdom (LON-All Airports)` | Destination label for the search query. | | `checkInDate` | String | No | `2026-04-19` | Check-in date in `YYYY-MM-DD` format. | | `checkOutDate` | String | No | `2026-04-20` | Check-out date in `YYYY-MM-DD` format. | | `adults` | Integer | No | `2` | Number of adults in room 1. | | `children` | String | No | `""` | Comma-separated child ages for room 1 (for example `4,8`). | | `sort` | String | No | `RECOMMENDED` | Search sort mode. | | `results_wanted` | Integer | No | `20` | Maximum number of listings to save. | | `max_pages` | Integer | No | `8` | Maximum result-load rounds to attempt. | | `proxyConfiguration` | Object | No | Residential Apify Proxy | Proxy settings for stable extraction. | --- ### Output Data Each dataset item can contain: | Field | Type | Description | |-------|------|-------------| | `hotel_id` | String | Expedia hotel ID | | `hotel_name` | String | Property name from search card | | `city` | String | City or area label | | `star_rating` | Number | Official hotel star rating | | `guest_rating` | Number | Guest score shown in listing card | | `guest_rating_out_of_five` | Number | Guest score in 5-point representation | | `review_count` | Integer | Number of guest reviews | | `review_label` | String | Rating label such as "Very Good" | | `nightly_price` | String | Nightly price text | | `total_price` | String | Total stay price text | | `strikeout_price` | String | Previous price text when present | | `taxes_and_fees_note` | String | Taxes and fees message | | `free_cancellation` | Boolean | Free cancellation signal when available | | `member_price_available` | Boolean | Member price indicator | | `vacation_rental` | Boolean | Vacation rental marker | | `image_url` | String | Primary listing image URL | | `property_url` | String | Expedia hotel detail URL | | `region_id` | String | Search region ID | | `region_name` | String | Search region name | | `check_in` | String | Check-in date | | `check_out` | String | Check-out date | | `adults` | Integer | Adults in room 1 | | `children` | Array | Child ages in room 1 | | `sort` | String | Sort mode used in request | | `search_id` | String | Expedia search identifier | | `source_url` | String | Source endpoint URL | | `operation_name` | String | Listing operation name | | `scraped_at` | String | ISO timestamp of capture | --- ### Usage Examples #### Basic Run ```json { "startUrl": "https://www.expedia.com/Hotel-Search?regionId=6139104&destination=London%2C%20United%20Kingdom%20%28LON-All%20Airports%29&adults=2&children=&sort=RECOMMENDED&useRewards=false&semdtl=&userIntent=&vip=false&startDate=2026-04-19&endDate=2026-04-20&theme=&latLong&pwaDialog=&daysInFuture&stayLength", "results_wanted": 20, "max_pages": 8 } ```` #### Manual Search Parameters ```json { "regionId": "6139104", "destination": "London, United Kingdom (LON-All Airports)", "checkInDate": "2026-04-19", "checkOutDate": "2026-04-20", "adults": 2, "children": "6", "sort": "RECOMMENDED", "results_wanted": 40, "max_pages": 10 } ``` #### Proxy-Optimized Run ```json { "startUrl": "https://www.expedia.com/Hotel-Search?regionId=6139104&destination=London%2C%20United%20Kingdom%20%28LON-All%20Airports%29&adults=2&children=&sort=RECOMMENDED&useRewards=false&semdtl=&userIntent=&vip=false&startDate=2026-04-19&endDate=2026-04-20&theme=&latLong&pwaDialog=&daysInFuture&stayLength", "results_wanted": 30, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ``` *** ### Sample Output ```json { "hotel_id": "5173526", "hotel_name": "Point A London Kings Cross - St Pancras", "city": "London", "star_rating": 2.5, "guest_rating": 8.4, "guest_rating_out_of_five": 4.2, "review_count": 2888, "review_label": "Very Good", "nightly_price": "$101 nightly", "total_price": "$121", "strikeout_price": "$135", "taxes_and_fees_note": "Total with taxes and fees", "free_cancellation": false, "member_price_available": true, "vacation_rental": false, "image_url": "https://images.trvl-media.com/lodging/6000000/5180000/5173600/5173526/24292dd5.jpg?impolicy=resizecrop&ra=fit&rw=455&rh=455", "property_url": "https://www.expedia.com/London-Hotels-Point-A-Hotel-London-Kings-Cross-St-Pancras.h5173526.Hotel-Information?...", "region_id": "6139104", "region_name": "London, United Kingdom (LON-All Airports)", "check_in": "2026-04-19", "check_out": "2026-04-20", "adults": 2, "children": [], "sort": "RECOMMENDED", "search_id": "5546132f-1251-4ae8-b52a-9ad927c5ee32", "source_url": "https://www.expedia.com/graphql", "operation_name": "PropertyListingQuery", "scraped_at": "2026-04-06T13:32:11.102Z" } ``` *** ### Tips For Best Results #### Start With Default Volume - Use `results_wanted: 20` first to validate destination and timing. - Increase volume only after verifying stable output. #### Use Residential Proxies - Residential routing improves reliability on protected travel pages. - Keep request volume moderate when collecting large destination sets. #### Keep Dates Valid - Use valid future check-in/check-out values when building URLs from parameters. - Ensure check-out is after check-in. #### Expect Field Variance - Not every listing exposes every field. - Empty/null fields are removed automatically from dataset records. *** ### Integrations - **Google Sheets** - Export pricing and rating snapshots for analysts. - **Airtable** - Build searchable destination and hotel tracking tables. - **Looker Studio** - Visualize market trends across city/date combinations. - **Webhooks** - Trigger downstream enrichment or alerting pipelines. #### Export Formats - **JSON** - Best for APIs and programmatic pipelines. - **CSV** - Best for spreadsheet workflows. - **Excel** - Best for reporting teams. - **XML** - Best for legacy integrations. *** ### Frequently Asked Questions #### Why are some fields missing in certain records? Listings do not always expose the same details. The actor keeps only non-empty values. #### Can I scrape multiple destinations? Yes. Run one job per destination URL or schedule separate runs with different input payloads. #### How many listings can I collect? It depends on destination inventory and load depth. Increase `max_pages` and `results_wanted` as needed. #### Why does proxy matter? Some Expedia result pages apply request-rate controls. Residential proxies improve run stability. #### Does the actor remove duplicates? Yes. Duplicate listing cards are filtered by hotel ID. *** ### Support For issues or feature requests, use Apify Console support channels. #### Resources - [Apify Documentation](https://docs.apify.com/) - [Apify API Reference](https://docs.apify.com/api/v2) - [Apify Schedules](https://docs.apify.com/platform/schedules) *** ### Legal Notice This actor is designed for legitimate data collection and analysis workflows. You are responsible for complying with website terms, applicable laws, and responsible data usage practices. # Actor input Schema ## `startUrl` (type: `string`): Optional direct Expedia Hotel-Search URL. Leave empty to build the request from the manual filters below. ## `regionId` (type: `string`): Expedia region ID used when startUrl is not provided. ## `destination` (type: `string`): Destination label used in Expedia search query. ## `checkInDate` (type: `string`): Check-in date in YYYY-MM-DD format. ## `checkOutDate` (type: `string`): Check-out date in YYYY-MM-DD format. ## `adults` (type: `integer`): Number of adults in room 1. ## `children` (type: `string`): Comma-separated child ages for room 1, for example: 4,8 ## `sort` (type: `string`): Sort order for listings. ## `results_wanted` (type: `integer`): Maximum number of hotel listings to save. ## `max_pages` (type: `integer`): Maximum result-load rounds to attempt while scrolling/loading more. ## `proxyConfiguration` (type: `object`): Residential proxy is strongly recommended for reliable extraction. ## Actor input object example ```json { "regionId": "6139104", "destination": "London, United Kingdom (LON-All Airports)", "checkInDate": "2026-04-19", "checkOutDate": "2026-04-20", "adults": 2, "sort": "RECOMMENDED", "results_wanted": 20, "max_pages": 8, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrl": "", "regionId": "6139104", "destination": "London, United Kingdom (LON-All Airports)", "checkInDate": "2026-04-19", "checkOutDate": "2026-04-20", "adults": 2, "children": "", "sort": "RECOMMENDED", "results_wanted": 20, "max_pages": 8 }; // Run the Actor and wait for it to finish const run = await client.actor("shahidirfan/expedia-hotels-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrl": "", "regionId": "6139104", "destination": "London, United Kingdom (LON-All Airports)", "checkInDate": "2026-04-19", "checkOutDate": "2026-04-20", "adults": 2, "children": "", "sort": "RECOMMENDED", "results_wanted": 20, "max_pages": 8, } # Run the Actor and wait for it to finish run = client.actor("shahidirfan/expedia-hotels-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrl": "", "regionId": "6139104", "destination": "London, United Kingdom (LON-All Airports)", "checkInDate": "2026-04-19", "checkOutDate": "2026-04-20", "adults": 2, "children": "", "sort": "RECOMMENDED", "results_wanted": 20, "max_pages": 8 }' | apify call shahidirfan/expedia-hotels-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=shahidirfan/expedia-hotels-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Expedia Hotels Scraper", "description": "Extract hotel data from Expedia instantly. Scrape prices, reviews, ratings, availability & amenities across destinations. Perfect for travel research, price monitoring & market analysis. Get structured hotel information for comparison & analytics. No coding required.", "version": "1.0", "x-build-id": "46blvjq9g4CRtKbBI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/shahidirfan~expedia-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-shahidirfan-expedia-hotels-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/shahidirfan~expedia-hotels-scraper/runs": { "post": { "operationId": "runs-sync-shahidirfan-expedia-hotels-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/shahidirfan~expedia-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-shahidirfan-expedia-hotels-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "startUrl": { "title": "Expedia Hotel-Search URL", "type": "string", "description": "Optional direct Expedia Hotel-Search URL. Leave empty to build the request from the manual filters below." }, "regionId": { "title": "Region ID", "type": "string", "description": "Expedia region ID used when startUrl is not provided." }, "destination": { "title": "Destination", "type": "string", "description": "Destination label used in Expedia search query." }, "checkInDate": { "title": "Check-in date", "type": "string", "description": "Check-in date in YYYY-MM-DD format." }, "checkOutDate": { "title": "Check-out date", "type": "string", "description": "Check-out date in YYYY-MM-DD format." }, "adults": { "title": "Adults", "minimum": 1, "type": "integer", "description": "Number of adults in room 1.", "default": 2 }, "children": { "title": "Children ages", "type": "string", "description": "Comma-separated child ages for room 1, for example: 4,8" }, "sort": { "title": "Sort", "type": "string", "description": "Sort order for listings.", "default": "RECOMMENDED" }, "results_wanted": { "title": "Maximum listings", "minimum": 1, "type": "integer", "description": "Maximum number of hotel listings to save.", "default": 20 }, "max_pages": { "title": "Maximum page loads", "minimum": 1, "type": "integer", "description": "Maximum result-load rounds to attempt while scrolling/loading more.", "default": 8 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxy is strongly recommended for reliable extraction.", "default": { "useApifyProxy": false } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```