Expedia Hotel Rate & Guest Rating Finder: MCP config, n8n workflow and API

{
  "mode": "search",
  "destination": "New York",
  "adults": 2,
  "rooms": 1,
  "maxItems": 1,
  "sortBy": "recommended",
  "minGuestRating": "any",
  "propertyType": "any",
  "freeCancellationOnly": false,
  "availableOnly": false,
  "includePropertyDetails": false,
  "includeRoomRates": false
}

---
name: expedia-hotel-rate-and-guest-rating-finder
description: "Expedia hotel records with live nightly and total rates, exact star class, guest rating and review count, address and coordinates, amenities, images, and optional room rates and cancellation policies. Runs the Apify Actor dataspryva/expedia-hotel-rate-and-guest-rating-finder. Use when the user needs Expedia data with fields such as type, hotelId, name, url, price, totalPrice and an Apify token is available."
compatibility: "Needs network access, curl, and an APIFY_TOKEN environment variable. Runs are billed to the token owner's Apify account."
metadata:
  actor: "dataspryva/expedia-hotel-rate-and-guest-rating-finder"
  store-url: "https://apify.com/dataspryva/expedia-hotel-rate-and-guest-rating-finder"
---

# Expedia Hotel Rate & Guest Rating Finder

Use this skill to fetch Expedia data with the Apify Actor `dataspryva/expedia-hotel-rate-and-guest-rating-finder` and work with the returned rows.

## Before running

1. Check that `APIFY_TOKEN` is set in the environment. Never print it or write it to a file.
2. Build `input.json` from the user's request using the fields below. Keep limits small for a first run.
3. Confirm the search terms or URLs with the user if the request is ambiguous.

## Input fields

| Field | Type | Meaning |
| --- | --- | --- |
| `mode` | one of `search`, `urls`, required | Search by destination, or scrape Expedia hotel and search URLs/IDs. |
| `destination` | string | City, area, landmark, airport, or hotel name to search (mode=search). Examples: New York, London, Tokyo, Times Square. |
| `startUrls` | array | Expedia hotel pages, Hotel-Search links, share links, or bare hotel IDs such as h17117062 or 17117062 (mode=urls). |
| `checkIn` | string | YYYY-MM-DD. Leave empty to use 30 days from today. |
| `checkOut` | string | YYYY-MM-DD. Leave empty to use 2 nights after check-in. |
| `adults` | integer | Adult guests per room (1-14). |
| `childrenAges` | array | One age (0-17) per child. Leave empty for no children. |
| `rooms` | integer | Number of rooms (1-8). |
| `maxItems` | integer | Hard cap on hotel records (1-1000). Expedia returns up to 500 per request; larger caps use nextSubSet pagination. |
| `sortBy` | one of `recommended`, `priceLowToHigh`, `priceHighToLow`, `distance`, `guestRating`, `starRating` | Order of the hotel search results. |
| `starRatings` | array | Only these star classes (1-5). Leave empty for all stars. |
| `minGuestRating` | one of `any`, `7+`, `8+`, `9+` | Minimum guest review score on Expedia's 10-point scale. |
| `propertyType` | string | Restrict results to a type of place. |
| `amenities` | array | Only hotels with all selected amenities. Leave empty for no amenity filter. |

Example `input.json` (the Actor's published prefill):

```json
{
  "mode": "search",
  "destination": "New York",
  "adults": 2,
  "rooms": 1,
  "maxItems": 1,
  "sortBy": "recommended",
  "minGuestRating": "any",
  "propertyType": "any",
  "freeCancellationOnly": false,
  "availableOnly": false,
  "includePropertyDetails": false,
  "includeRoomRates": false
}
```

## Run

```bash
curl -sS -X POST "https://api.apify.com/v2/acts/dataspryva~expedia-hotel-rate-and-guest-rating-finder/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d @input.json > results.json
```

The call waits for the run to finish and returns the dataset items as a JSON array. If the run needs more than 300 seconds the API answers with HTTP 408; then start the run with `POST /v2/acts/dataspryva~expedia-hotel-rate-and-guest-rating-finder/runs`, poll `GET /v2/actor-runs/{runId}` until `SUCCEEDED`, and read `GET /v2/datasets/{defaultDatasetId}/items`.

## Output

Each item is one record. Published fields include: `type`, `hotelId`, `name`, `url`, `price`, `totalPrice`, `pricePerNight`, `priceTotal`, `priceStrikethrough`, `priceCurrency`, `rating`, `guestRating`, `ratingText`, `reviewCount`, `guestReviewCount`, `starRating`, `neighborhood`, `address`, `latitude`, `longitude`.

Summarise what was found, cite the record URLs when present, and say how many items came back. Do not invent values for empty fields.