Kayak Flight, Hotel & Cheap Destination Finder: MCP config, n8n workflow and API

{
  "mode": "searchFlights",
  "site": "kayak.com",
  "origin": "NYC",
  "destination": "LON",
  "tripType": "round-trip",
  "cabinClass": "economy",
  "adults": 1,
  "children": 0,
  "maxStops": "any",
  "redeyeOnly": false,
  "alliance": "any",
  "wifiOnly": false,
  "sortBy": "price",
  "rooms": 1,
  "minRating": "any",
  "freeCancellation": false,
  "freeBreakfast": false,
  "freeInternet": false,
  "freeParking": false,
  "payLater": false,
  "propertyType": "any",
  "dealsOnly": false,
  "hotelSortBy": "recommended",
  "minTripDays": 1,
  "maxTripDays": 30,
  "maxItems": 3
}

---
name: kayak-flight-hotel-and-cheap-destination-finder
description: "Flight itineraries, hotel rates and cheap-destination deals from Kayak. Every record is normalised and includes recordType (kayakFlight / kayakHotel / kayakExplore), accessMethod (live / flight-routes / wayback), and scrapedAt so archived or snapshot prices can be distinguished from live search results. Runs the Apify Actor vexaloom-labs/kayak-flight-hotel-and-cheap-destination-finder. Use when the user needs Kayak data with fields such as recordType, flightId, hotelName, origin, destination, destinationCountry 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: "vexaloom-labs/kayak-flight-hotel-and-cheap-destination-finder"
  store-url: "https://apify.com/vexaloom-labs/kayak-flight-hotel-and-cheap-destination-finder"
---

# Kayak Flight, Hotel & Cheap Destination Finder

Use this skill to fetch Kayak data with the Apify Actor `vexaloom-labs/kayak-flight-hotel-and-cheap-destination-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 `searchFlights`, `searchHotels`, `exploreDeals`, `byUrls` | Search live flights, search live hotel rates, discover cheap destinations from an airport, or scrape specific Kayak URLs. |
| `site` | string | Country site used for the search. It determines the currency and point of sale (for example kayak.co.uk returns GBP). |
| `origin` | string | Airport or city code to fly from, for example NYC, JFK or New York. Used by flights and cheap-destination modes. |
| `destination` | string | Airport or city code to fly to, for example LON, LHR or London. In hotels mode this is the city or area to stay in. |
| `tripType` | one of `one-way`, `round-trip` | One-way or round-trip flight. |
| `cabinClass` | one of `economy`, `premium-economy`, `business`, `first` | Cabin class for the flight search. |
| `adults` | integer | Number of adult travellers (1-9). |
| `children` | integer | Number of children aged 2-17. Kayak is searched with child ages 8, 10, 12 and 14 for 1-4 children. |
| `maxStops` | one of `any`, `0`, `1`, `2`, `3` | Limit the number of connections. Applies to flights and cheap-destination searches. |
| `redeyeOnly` | boolean | Return only overnight (red-eye) itineraries. |
| `alliance` | one of `any`, `STAR_ALLIANCE`, `ONEWORLD`, `SKYTEAM` | Restrict results to one airline alliance. |
| `wifiOnly` | boolean | Return only flights that advertise in-flight Wi-Fi. |
| `sortBy` | one of `price`, `duration`, `departure`, `arrival`, `best` | Order of flight results. |
| `rooms` | integer | Number of hotel rooms (1-8). |

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

```json
{
  "mode": "searchFlights",
  "site": "kayak.com",
  "origin": "NYC",
  "destination": "LON",
  "tripType": "round-trip",
  "cabinClass": "economy",
  "adults": 1,
  "children": 0,
  "maxStops": "any",
  "redeyeOnly": false,
  "alliance": "any",
  "wifiOnly": false,
  "sortBy": "price",
  "rooms": 1,
  "minRating": "any",
  "freeCancellation": false,
  "freeBreakfast": false,
  "freeInternet": false,
  "freeParking": false,
  "payLater": false,
  "propertyType": "any",
  "dealsOnly": false,
  "hotelSortBy": "recommended",
  "minTripDays": 1,
  "maxTripDays": 30,
  "maxItems": 3
}
```

## Run

```bash
curl -sS -X POST "https://api.apify.com/v2/acts/vexaloom-labs~kayak-flight-hotel-and-cheap-destination-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/vexaloom-labs~kayak-flight-hotel-and-cheap-destination-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: `recordType`, `flightId`, `hotelName`, `origin`, `destination`, `destinationCountry`, `departDate`, `returnDate`, `price`, `currency`, `airline`, `stars`, `rating`, `stops`, `duration`, `providerName`, `deepLink`, `accessMethod`, `scrapedAt`.

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