# Skyscanner Hotels Scraper 🏨 (`shahidirfan/skyscanner-hotels-scraper`) Actor

Extract Skyscanner hotel data at scale, including hotel names, prices, ratings, reviews, locations, availability, and booking details. Ideal for hotel price comparison, travel market research, competitor tracking, tourism analytics, and hospitality datasets.

- **URL**: https://apify.com/shahidirfan/skyscanner-hotels-scraper.md
- **Developed by:** [Shahid Irfan](https://apify.com/shahidirfan) (community)
- **Categories:** Travel, Developer tools, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.99 / 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.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#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

### What does Skyscanner Hotels Scraper do?

Skyscanner Hotels Scraper collects hotel listings from a public Skyscanner hotel search and saves them as clean, structured dataset items. Each item represents one unique hotel, including the name, star rating, guest rating, image URLs, normalized prices, available partner offers, destination, and public hotel page.

Use it for hotel price research, destination comparisons, travel planning, accommodation directories, competitor monitoring, and scheduled market snapshots. Empty values are removed before saving, so unavailable fields are omitted instead of being stored as nulls.

### Features

- Search from one Skyscanner URL or a destination.
- Accept a full search URL, a numeric destination ID, a Skyscanner destination URL, or a location name.
- Keep URL input as the priority when both URL and location are supplied.
- Set check-in, check-out, travellers, children ages, rooms, market, locale, and currency.
- Sort by best match, price, guest rating, stars, or distance.
- Control the total number of listings and the maximum number of pages.
- Return prices, taxes, discounts, image URLs, ratings, map coordinates, and partner offers when published.
- Deduplicate listings by hotel ID.
- Push page results as they become available for safer long runs.
- Use Apify Proxy or custom proxy URLs for production runs.

### How to use

1. Open the Actor input form.
2. Paste a public Skyscanner hotel search URL, or clear the URL and enter a location.
3. Set dates and traveller details if they are not already present in the URL.
4. Choose a result limit and page limit.
5. Start the run and open the default dataset when it finishes.

When `url` is supplied, it is used first. When it is empty, `location` is resolved and a search is created using the supplied dates and traveller details. A numeric destination ID or a Skyscanner destination URL is the most reliable location format. Free-text locations may need proxy access if the destination service applies a challenge.

### Input parameters

| Field                | Type    | Default           | Description                                                                            |
| -------------------- | ------- | ----------------- | -------------------------------------------------------------------------------------- |
| `url`                | String  | Sample search URL | Public Skyscanner hotel search URL. Takes priority over `location`.                    |
| `location`           | String  | `New York`        | City name, numeric destination ID, or Skyscanner destination URL.                      |
| `checkin`            | String  | `2026-08-27`      | Check-in date in `YYYY-MM-DD` format.                                                  |
| `checkout`           | String  | `2026-08-28`      | Check-out date in `YYYY-MM-DD` format. Must be after check-in.                         |
| `adults`             | Integer | `2`               | Number of adult travellers.                                                            |
| `rooms`              | Integer | `1`               | Number of rooms.                                                                       |
| `market`             | String  | `US`              | Two-letter market used for availability and prices.                                    |
| `locale`             | String  | `en-US`           | Locale for labels and translated content.                                              |
| `currency`           | String  | `USD`             | Three-letter price currency.                                                           |
| `sortBy`             | String  | `best`            | `best`, `price_low`, `price_high`, `rating`, `stars_high`, `stars_low`, or `distance`. |
| `results_wanted`     | Integer | `20`              | Maximum unique hotels saved across the run.                                            |
| `max_pages`          | Integer | `5`               | Maximum listing pages requested. Each page contains up to 35 hotels.                   |
| `proxyConfiguration` | Object  | Apify Proxy       | Proxy settings for reliable production runs.                                           |

### Usage examples

#### Basic search URL

```json
{
    "url": "https://www.skyscanner.com/hotels/search?entity_id=27537542&checkin=2026-08-27&checkout=2026-08-28&adults=2&rooms=1",
    "results_wanted": 20,
    "max_pages": 1
}
```

#### Destination by numeric ID

```json
{
    "location": "27537542",
    "checkin": "2026-08-27",
    "checkout": "2026-08-28",
    "adults": 2,
    "rooms": 1,
    "sortBy": "price_low",
    "results_wanted": 50,
    "max_pages": 2
}
```

#### Destination URL and rating sort

```json
{
    "location": "https://www.skyscanner.com/hotels/search?entity_id=27537542",
    "checkin": "2026-08-27",
    "checkout": "2026-08-28",
    "sortBy": "rating",
    "results_wanted": 35,
    "max_pages": 1
}
```

### Output data

The default dataset contains one item per unique hotel. Common fields include:

| Field                                                  | Description                              |
| ------------------------------------------------------ | ---------------------------------------- |
| `hotelId`                                              | Skyscanner hotel identifier.             |
| `hotelName`                                            | Public hotel name.                       |
| `starRating` and `starLabel`                           | Published star classification.           |
| `detailsPageUrl` and `canonicalHotelUrl`               | Public hotel detail links.               |
| `reviewScore`, `reviewScoreDescription`, `reviewCount` | Guest rating information when available. |
| `imageUrls`                                            | Direct image URLs for the listing.       |
| `pricePerNight` and `pricePerNightWithTaxes`           | Normalized nightly prices.               |
| `totalPrice` and `totalPriceWithTaxes`                 | Normalized stay totals.                  |
| `partnerOffers`                                        | Available booking partner offers.        |
| `latitude`, `longitude`                                | Map coordinates when available.          |
| `entityId`, `location`, `market`, `currency`           | Search context.                          |
| `sourcePage`, `sourceUrl`, `scrapedAt`                 | Collection metadata.                     |

#### Sample output

```json
{
    "hotelId": "204222293",
    "hotelName": "DoubleTree by Hilton New York Downtown",
    "starRating": 4,
    "starLabel": "4 stars",
    "detailsPageUrl": "https://www.skyscanner.com/hotels/.../ht-204222293",
    "reviewScore": 4.2,
    "reviewCount": 1516,
    "imageUrls": ["https://content.skyscnr.com/..."],
    "pricePerNight": "$188",
    "pricePerNightWithTaxes": "$219",
    "entityId": "27537542",
    "location": "New York",
    "currency": "USD",
    "checkin": "2026-08-27",
    "checkout": "2026-08-28",
    "sourcePage": 1,
    "scrapedAt": "2026-08-20T07:15:17.658Z"
}
```

Fields that are not published for a listing are left out of that item.

### Tips for reliable runs

- Start with a URL containing `entity_id`, dates, adults, and rooms.
- Keep `max_pages` modest while testing, then increase it with `results_wanted`.
- Use `price_low` for budget comparisons and `rating` for highly rated properties.
- Keep proxy access enabled for scheduled or higher-volume runs.
- If free-text location lookup is challenged, use the destination URL or numeric ID instead.
- The result limit applies to the complete run, while page limits control how far pagination can continue.

### Integrations and automation

Use the dataset with Google Sheets, Make, Zapier, webhooks, cloud storage, dashboards, or a custom application. Schedule recurring runs for price snapshots, destination monitoring, or hotel directory updates. The dataset can be exported as JSON, CSV, Excel, XML, or RSS.

### Frequently asked questions

#### Can I use both `url` and `location`?

Yes. The URL is intentionally the primary input. Location is used only when URL is empty.

#### Do I need to provide dates?

Yes. Dates can come from the search URL or from `checkin` and `checkout`. Separate input fields override URL query values.

#### Why are fewer hotels returned than requested?

The search may have fewer available listings, the page limit may have been reached, or duplicate hotel IDs may have been removed.

#### Are null values included?

No. Nulls, empty strings, empty arrays, and empty objects are removed recursively before items are saved.

#### Can I scrape several destinations in one run?

This version accepts one search target per run. Create separate scheduled runs for separate destinations so each dataset remains easy to interpret.

### Related Actors

- [Agoda Hotels Scraper](https://apify.com/shahidirfan/agoda-hotels-scraper) for Agoda property, pricing, availability, and review data.
- [Tripadvisor Reviews Scraper](https://apify.com/shahidirfan/tripadvisor-reviews-scraper) for Tripadvisor hotel review collection.
- [Tiket Hotel Reviews Scraper](https://apify.com/shahidirfan/tiket-hotel-reviews-scraper) for structured guest feedback from Tiket hotel pages.

### Legal notice

This Actor collects publicly accessible information. You are responsible for complying with applicable laws, privacy requirements, contractual obligations, and the target website's terms. Use reasonable limits and retain only the information you need.

### Support

If a valid search stops returning expected results, include the run ID, input shape, and a short description when requesting support. Do not share passwords, proxy credentials, tokens, or other secrets.

# Actor input Schema

## `url` (type: `string`):

A public Skyscanner hotel search URL. If both url and location are provided, url takes priority.

## `location` (type: `string`):

A city or destination name, a numeric Skyscanner entity ID, or a Skyscanner destination URL. Used when url is empty.

## `checkin` (type: `string`):

Check-in date in YYYY-MM-DD format. A value here overrides the date in the search URL.

## `checkout` (type: `string`):

Check-out date in YYYY-MM-DD format. A value here overrides the date in the search URL.

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

Number of adult travellers.

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

Number of rooms required.

## `market` (type: `string`):

Two-letter market code used for pricing and availability, for example US or UK.

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

Locale used for labels and translated listing content.

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

Three-letter currency code used for prices.

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

Order in which hotels are returned.

## `results_wanted` (type: `integer`):

Maximum number of unique hotel listings saved across the run.

## `max_pages` (type: `integer`):

Maximum listing pages requested. Each page contains up to 35 hotels.

## `proxyConfiguration` (type: `object`):

Use Apify Proxy or your own proxy URLs for reliable production runs.

## Actor input object example

```json
{
  "url": "https://www.skyscanner.com/hotels/search?entity_id=27537542&checkin=2026-08-27&checkout=2026-08-28&adults=2&rooms=1",
  "location": "New York",
  "checkin": "2026-08-27",
  "checkout": "2026-08-28",
  "adults": 2,
  "rooms": 1,
  "market": "US",
  "locale": "en-US",
  "currency": "USD",
  "sortBy": "best",
  "results_wanted": 20,
  "max_pages": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

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

// Prepare Actor input
const input = {
    "url": "https://www.skyscanner.com/hotels/search?entity_id=27537542&checkin=2026-08-27&checkout=2026-08-28&adults=2&rooms=1",
    "location": "New York",
    "checkin": "2026-08-27",
    "checkout": "2026-08-28",
    "adults": 2,
    "rooms": 1,
    "market": "US",
    "locale": "en-US",
    "currency": "USD",
    "sortBy": "best",
    "results_wanted": 20,
    "max_pages": 5
};

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

# Prepare the Actor input
run_input = {
    "url": "https://www.skyscanner.com/hotels/search?entity_id=27537542&checkin=2026-08-27&checkout=2026-08-28&adults=2&rooms=1",
    "location": "New York",
    "checkin": "2026-08-27",
    "checkout": "2026-08-28",
    "adults": 2,
    "rooms": 1,
    "market": "US",
    "locale": "en-US",
    "currency": "USD",
    "sortBy": "best",
    "results_wanted": 20,
    "max_pages": 5,
}

# Run the Actor and wait for it to finish
run = client.actor("shahidirfan/skyscanner-hotels-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 '{
  "url": "https://www.skyscanner.com/hotels/search?entity_id=27537542&checkin=2026-08-27&checkout=2026-08-28&adults=2&rooms=1",
  "location": "New York",
  "checkin": "2026-08-27",
  "checkout": "2026-08-28",
  "adults": 2,
  "rooms": 1,
  "market": "US",
  "locale": "en-US",
  "currency": "USD",
  "sortBy": "best",
  "results_wanted": 20,
  "max_pages": 5
}' |
apify call shahidirfan/skyscanner-hotels-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,shahidirfan/skyscanner-hotels-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/l39Sck6FqbMdMedaG/builds/hnLFNGVXdxhqErutF/openapi.json