# Expedia  Hotels + Reviews (`abotapi/expedia-universal-scraper`) Actor

From $1/1K. Extract hotel listings and reviews from Expedia.com. Get comprehensive data, including prices, ratings, review text, photos, and location details for any destination.

- **URL**: https://apify.com/abotapi/expedia-universal-scraper.md
- **Developed by:** [Abot API](https://apify.com/abotapi) (community)
- **Categories:** Travel, Developer tools, Automation
- **Stats:** 47 total users, 15 monthly users, 86.9% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $1.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 Hotel Scraper

Extract hotel listings and reviews from **Expedia.com**, the world's largest online travel marketplace with millions of properties across 200+ countries. Get comprehensive data including prices, ratings, review text, photos, and location details for any destination.

### What does Expedia Hotel Scraper do?

This Actor collects hotel data from Expedia in two ways:

1. **Search by destination.** Paste a city name, get back a paginated list of hotels with prices, ratings, and photos for your selected dates.
2. **Fetch by URL.** Paste Expedia hotel or search URLs and get matching hotel cards up to your `maxItems` limit.

A single toggle switches the output between aggregate hotel cards and individual review records (one row per review).

#### Key Features

| Feature | Description |
|---------|-------------|
| **Destination search** | Type any city; the Actor resolves it to the correct Expedia region |
| **URL mode** | Accepts hotel URLs and Expedia search URLs |
| **Deeplink support** | Expedia share links (expe.onelink.me and similar) are auto-resolved to the canonical hotel URL |
| **Reviews only toggle** | Output individual review records instead of hotel cards |
| **Date and guest filters** | Check in/out dates, adults, rooms, children with ages |
| **Price and rating filters** | Min/max price, star ratings, sort order |
| **29 locales, 36 currencies** | Localized content and prices |
| **Photos and pricing** | Up to 4 images per hotel, nightly price, strikeout discounts |
| **Per hotel review cap** | Cap reviews per hotel to control cost on high volume properties |

### What data can you extract?

#### Hotel card (Search mode or URL mode)

<table>
<tr><td>

**Identity and location**

- Property ID and URL
- Name and description
- Star rating
- Destination context

</td><td>

**Pricing**

- Nightly price (numeric and formatted)
- Strikeout price when discounted
- Currency

</td></tr>
<tr><td>

**Reviews (aggregate)**

- Overall rating (0 to 10)
- Rating label (Good, Excellent, etc.)
- Total review count

</td><td>

**Media and dates**

- Gallery image URLs
- Check in and check out dates
- Adult count used for search

</td></tr>
</table>

#### Review record (Reviews Only mode)

- Review ID, title, text
- Rating value (0 to 10) and label
- Author name
- Review and stay date
- Sentiment: liked and disliked lists
- Guest photo URLs
- Linked hotel ID and URL

### How to use the Expedia Hotel Scraper

#### Search by destination

```json
{
  "mode": "search",
  "destination": "Paris",
  "adults": 2,
  "currency": "USD",
  "locale": "en_US",
  "maxItems": 50
}
```

#### Filter by price and star rating

```json
{
  "mode": "search",
  "destination": "Tokyo",
  "checkIn": "2026-09-10",
  "checkOut": "2026-09-13",
  "adults": 2,
  "starRatings": ["4", "5"],
  "minPrice": 150,
  "maxPrice": 400,
  "sortBy": "REVIEW"
}
```

#### Fetch specific hotels by URL

```json
{
  "mode": "url",
  "startUrls": [
    { "url": "https://www.expedia.com/Example-City-Hotels-Sample-Hotel.h11111.Hotel-Information" },
    { "url": "https://www.expedia.com/Example-City-Hotels-Another-Sample.h22222.Hotel-Information" }
  ]
}
```

#### Paste a deeplink (expe.onelink.me share link)

Share links generated by the Expedia mobile app's "Share" button, as well as marketing and social deeplinks, are accepted as is. The Actor follows the redirect, identifies the hotel, and scrapes it like any other URL.

```json
{
  "mode": "url",
  "startUrls": [
    { "url": "https://expe.onelink.me/hnLd/9o2lnq8o" }
  ]
}
```

Supported deeplink hosts: `expe.onelink.me` (primary), `expe.app.link`, `trip.expedia.com`. Only Expedia hotel deeplinks are handled. Hotels.com and Vrbo short links are out of scope for this release.

#### Use a search URL

Paste an Expedia search URL with your filters already applied. The Actor returns matching records up to `maxItems`.

```json
{
  "mode": "url",
  "startUrls": [
    { "url": "https://www.expedia.com/Hotel-Search?destination=Barcelona&d1=2026-07-01&d2=2026-07-05&adults=2" }
  ],
  "maxItems": 200
}
```

#### Scrape reviews only

```json
{
  "mode": "search",
  "destination": "New York",
  "reviewsOnly": true,
  "maxReviewsPerHotel": 50,
  "maxItems": 500
}
```

Or supply hotel URLs directly:

```json
{
  "mode": "url",
  "startUrls": [
    { "url": "https://www.expedia.com/Example-City-Hotels-Sample-Hotel.h11111.Hotel-Information" }
  ],
  "reviewsOnly": true,
  "maxReviewsPerHotel": 100
}
```

#### Family travel with children

```json
{
  "mode": "search",
  "destination": "Orlando",
  "adults": 2,
  "children": ["5", "10"],
  "rooms": 1
}
```

### Input Parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `mode` | string | `search` | `search` or `url` |
| `destination` | string | | City name (Search mode) |
| `startUrls` | object\[] | | Expedia URLs (URL mode) |
| `destinationId` | string | | Optional numeric region ID. Skips auto resolution |
| `reviewsOnly` | boolean | `false` | Output reviews instead of hotel cards |
| `checkIn` | string | tomorrow | YYYY-MM-DD or a relative offset like `1 day` |
| `checkOut` | string | day after tomorrow | YYYY-MM-DD or a relative offset like `2 days` |
| `adults` | integer | `2` | Adult guests, 1 to 14 |
| `children` | string\[] | `[]` | Ages of children, 0 to 17 (one entry per child) |
| `rooms` | integer | `1` | Rooms to book, 1 to 8 |
| `minPrice` | integer | | Minimum nightly price |
| `maxPrice` | integer | | Maximum nightly price |
| `starRatings` | string\[] | `[]` | One or more of `1`, `2`, `3`, `4`, `5` |
| `sortBy` | string | `RECOMMENDED` | `RECOMMENDED`, `PRICE_LOW_TO_HIGH`, `PRICE_HIGH_TO_LOW`, `DISTANCE`, `PROPERTY_CLASS`, `REVIEW` |
| `currency` | string | `USD` | 3 letter ISO code from the dropdown |
| `locale` | string | `en_US` | Language and region locale from the dropdown |
| `maxItems` | integer | `20` | Hard cap on total records |
| `maxReviewsPerHotel` | integer | `25` | Cap reviews per hotel |
| `proxy` | object | Apify Residential | Proxy configuration |

### Send results into your apps (MCP connectors)

Optionally pipe the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. This is an extra delivery step **after** the scrape; the Apify dataset is never changed.

**What gets written to the connector:** a condensed, human-readable **summary** of each record, not the full JSON. Each item becomes one entry with a **title** and its key fields flattened to plain text. The **complete record always stays in the Apify dataset**.

1. Authorize a connector once under **Apify → Settings → Integrations** (Notion, Linear, Airtable, or Apify).
2. Select it in the **"Pipe results into your apps"** input field. (If the picker is empty, you haven't authorized a connector yet.)
3. For **Notion**, also set `notionParentPageUrl` to the page where items should be created.

The connection is mediated by Apify's MCP proxy, so this actor never sees your third-party credentials. Leave the field empty to skip.

### Output Example

#### Hotel card

```json
{
  "mode": "search",
  "placeName": "Example Hotel Paris",
  "hotelId": "11111",
  "hotelUrl": "https://www.expedia.com/Example-City-Hotels-Sample-Hotel.h11111.Hotel-Information",
  "hotelOverallRating": 9.2,
  "hotelRatingLabel": "Wonderful",
  "hotelTotalReviews": 1843,
  "provider": "expedia",
  "scrapedAt": "2026-04-18T07:30:00.000Z",
  "extra": {
    "searchDestination": "Paris",
    "starRating": 5,
    "description": "Recently renovated boutique hotel steps from the city center",
    "priceFrom": 420,
    "priceFormatted": "$420 nightly",
    "priceStrikeout": "$600",
    "currency": "USD",
    "images": [
      "https://images.example.com/lodging/sample-1.jpg",
      "https://images.example.com/lodging/sample-2.jpg"
    ],
    "checkIn": "2026-07-01",
    "checkOut": "2026-07-03",
    "adults": 2
  }
}
```

#### Review record

```json
{
  "mode": "reviews",
  "placeName": "Example Hotel Paris",
  "hotelId": "11111",
  "hotelUrl": "https://www.expedia.com/Example-City-Hotels-Sample-Hotel.h11111.Hotel-Information",
  "hotelOverallRating": 9.2,
  "hotelRatingLabel": "Wonderful",
  "hotelTotalReviews": 1843,
  "hotelCategoryRatings": {
    "Cleanliness": 9.4,
    "Staff": 9.3
  },
  "locale": "en_US",
  "provider": "expedia",
  "reviewId": "abc123def456",
  "reviewTitle": "Memorable stay",
  "reviewText": "Beautiful hotel with great service and a convenient location.",
  "reviewRating": 10,
  "reviewRatingLabel": "Excellent",
  "reviewDate": "Oct 14, 2025",
  "stayDuration": "Stayed 3 nights in Oct 2025",
  "authorName": "Sarah",
  "sentiment": {
    "liked": ["Cleanliness", "staff and service", "location"],
    "disliked": []
  },
  "photos": [
    "https://images.example.com/ugc/review-photo-1.jpg"
  ],
  "scrapedAt": "2026-04-18T07:30:00.000Z",
  "extra": {}
}
```

### Tips

- **Use `maxItems` to control run size.** The Actor saves matching records until that limit is reached or there are no more results.
- **`destinationId` speeds up search.** Pass the numeric ID from any Expedia URL (the segment after `.d`) to skip the name resolution round trip.
- **Reviews mode respects `maxItems`.** If you cap at 500, the Actor stops at 500 total reviews across all hotels.
- **Use reliable proxy settings for best results.** Expedia availability can vary by network.

# Actor input Schema

## `mode` (type: `string`):

Search mode runs a destination query and paginates results. URL mode fetches hotels by property or search URL.

## `destination` (type: `string`):

Search mode only. Type a city (for example Paris, New York, Tokyo).

## `destinationId` (type: `string`):

Numeric region ID from an Expedia URL (for example 2734 for Paris, 178293 for New York). It is the number after .d in any Expedia URL. If left empty, the Actor resolves it from the Destination text above.

## `startUrls` (type: `array`):

URL mode only. Paste Expedia property URLs (Hotel-Information pages) or Expedia Hotel-Search URLs.

## `checkIn` (type: `string`):

Required. Pick a date, or type a relative value such as 1 day (tomorrow) or 7 days.

## `checkOut` (type: `string`):

Required. Pick a date, or type a relative value such as 2 days (day after tomorrow).

## `adults` (type: `integer`):

Number of adult guests. Affects pricing and availability in the results.

## `children` (type: `array`):

Add one entry per child and type the age in years (0 to 17). Two kids age 5 and 10? Add 5 and 10. Two 5 year olds? Add 5 twice.

## `rooms` (type: `integer`):

Number of rooms to book. Each room uses the same adult and children configuration.

## `minPrice` (type: `integer`):

Minimum nightly price filter in the selected currency. Leave empty for no minimum.

## `maxPrice` (type: `integer`):

Maximum nightly price filter in the selected currency. Leave empty for no maximum.

## `starRatings` (type: `array`):

Filter by star rating. Select one or more. Leave empty to include all star ratings.

## `sortBy` (type: `string`):

Order in which hotels are returned.

## `reviewsOnly` (type: `boolean`):

When enabled, the output is individual review records (one row per review) instead of hotel cards. Works in both Search and URL input types.

## `includeReviews` (type: `boolean`):

When enabled, each hotel card gets up to Max Reviews per Hotel reviews embedded under extra.reviews. Ignored if Scrape reviews only is on.

## `maxReviewsPerHotel` (type: `integer`):

Cap on reviews embedded in each hotel card. Only applies when Include reviews in hotel cards is on. Ignored in Scrape reviews only mode (Max Items caps the overall total).

## `reviewsFrom` (type: `string`):

YYYY-MM-DD. Only keep reviews on or after this date. Speeds up runs when you only need recent reviews.

## `includeCategoryRatings` (type: `boolean`):

Attach hotel level aggregate ratings (cleanliness, staff, location, and similar categories) to each review record.

## `currency` (type: `string`):

Currency for prices shown on hotel cards.

## `locale` (type: `string`):

Language and region for content on hotel cards and for review language.

## `maxItems` (type: `integer`):

Hard cap on the total number of records saved to the dataset across all pages and hotels.

## `resumeFromRunId` (type: `string`):

Paste a previous run ID or dataset ID to continue a large crawl of hotels without returning or charging for hotels already collected there. Use this after an interrupted run, or when continuing a destination pull in another run. For recurring daily monitoring of the same search or URLs, use Incremental mode below instead.

## `incrementalMode` (type: `boolean`):

Turn this on for daily or recurring monitoring of the same destination search or hotel/search URLs. The first run returns all matching hotels as NEW. Later runs normally return only NEW, UPDATED, and REAPPEARED hotels. Turn on "Emit unchanged" or "Emit expired" only when you also want those hotels returned (and billed). State is kept separately for each mode/destination/URL/filter setup; use State key when you want to name or deliberately share a monitoring campaign. To continue one specific interrupted run instead, use Resume from a previous run above.

## `stateKey` (type: `string`):

Optional. Name this monitoring campaign to keep its state stable, or to deliberately share state across differently-configured runs. Leave empty to let the actor derive a key automatically from the destination/URLs and filters — different searches then never mix state with each other.

## `emitUnchanged` (type: `boolean`):

Off by default. Turn on to also return hotels that have not changed since the last run, marked UNCHANGED. This returns — and bills — extra rows you already have, so leave it off unless you specifically want the full snapshot every run.

## `emitExpired` (type: `boolean`):

Off by default. Turn on to also return hotels that were present in a previous run but are no longer found, marked EXPIRED. Only produced once a run has fully scanned the tracked search/URLs — not when Max Items capped it or when Resume was used. This returns — and bills — extra synthetic rows, so leave it off unless you need expiry tracking.

## `proxy` (type: `object`):

Proxy settings. Residential proxies are recommended for reliable access.

## `mcpConnectors` (type: `array`):

Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify > Settings > Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON; the complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com).

## `notionParentPageUrl` (type: `string`):

URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors.

## `maxNotifyListings` (type: `integer`):

Cap on items written to each connector per run. Does not affect the dataset.

## Actor input object example

```json
{
  "mode": "search",
  "destination": "Paris",
  "destinationId": "2734",
  "startUrls": [
    {
      "url": "https://www.expedia.com/Paris-Hotels-Hotel-Trianon-Rive-Gauche.h891081.Hotel-Information"
    }
  ],
  "checkIn": "1 day",
  "checkOut": "2 days",
  "adults": 2,
  "children": [],
  "rooms": 1,
  "starRatings": [],
  "sortBy": "RECOMMENDED",
  "reviewsOnly": false,
  "includeReviews": false,
  "maxReviewsPerHotel": 25,
  "includeCategoryRatings": true,
  "currency": "USD",
  "locale": "en_US",
  "maxItems": 20,
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  },
  "maxNotifyListings": 50
}
```

# Actor output Schema

## `results` (type: `string`):

Records matching the selected mode

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "search",
    "destination": "Paris",
    "destinationId": "2734",
    "startUrls": [
        {
            "url": "https://www.expedia.com/Paris-Hotels-Hotel-Trianon-Rive-Gauche.h891081.Hotel-Information"
        }
    ],
    "checkIn": "1 day",
    "checkOut": "2 days",
    "maxItems": 20,
    "incrementalMode": false,
    "emitUnchanged": false,
    "emitExpired": false,
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("abotapi/expedia-universal-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "search",
    "destination": "Paris",
    "destinationId": "2734",
    "startUrls": [{ "url": "https://www.expedia.com/Paris-Hotels-Hotel-Trianon-Rive-Gauche.h891081.Hotel-Information" }],
    "checkIn": "1 day",
    "checkOut": "2 days",
    "maxItems": 20,
    "incrementalMode": False,
    "emitUnchanged": False,
    "emitExpired": False,
    "proxy": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("abotapi/expedia-universal-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "search",
  "destination": "Paris",
  "destinationId": "2734",
  "startUrls": [
    {
      "url": "https://www.expedia.com/Paris-Hotels-Hotel-Trianon-Rive-Gauche.h891081.Hotel-Information"
    }
  ],
  "checkIn": "1 day",
  "checkOut": "2 days",
  "maxItems": 20,
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call abotapi/expedia-universal-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,abotapi/expedia-universal-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/cXyLXbDpgkeiKAhUp/builds/g9jxHYTDZsde9ybjK/openapi.json