# Trivago Hotel Scraper (`crawlerbros/trivago-hotel-scraper`) Actor Scrape hotel listings, prices, ratings, and deals from Trivago. Search by destination, compare OTA prices, and extract hotel details at scale - **URL**: https://apify.com/crawlerbros/trivago-hotel-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Travel, Automation, Developer tools - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 7 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## 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 ## Trivago Hotel Scraper Extract hotel listings, prices, ratings, and amenities from [Trivago](https://www.trivago.com) — the world's largest hotel price comparison platform. Search by destination, compare prices from 400+ booking sites, and collect rich hotel data at scale. ### What data does this scraper extract? | Field | Description | |-------|-------------| | `hotelId` | Unique hotel identifier | | `name` | Hotel name | | `url` | Trivago hotel page URL | | `imageUrl` | Hotel main image URL | | `destination` | Search destination | | `checkIn` | Check-in date | | `checkOut` | Check-out date | | `price` | Best available price (per night) | | `currency` | Price currency (e.g., USD) | | `rating` | Trivago rating (0–10 scale) | | `reviewCount` | Number of reviews | | `starRating` | Star category (1–5) | | `address` | Hotel address | | `latitude` | Geographical latitude | | `longitude` | Geographical longitude | | `amenities` | List of amenities (WiFi, pool, gym, etc.) | | `providers` | OTA providers with their prices (Booking.com, Hotels.com, etc.) | | `recordType` | Always "trivagoHotel" | | `scrapedAt` | Timestamp of scraping | ### Input Parameters | Parameter | Type | Description | Default | |-----------|------|-------------|---------| | `mode` | Select | Scraping mode: searchHotels, byHotelUrls, topDeals | `searchHotels` | | `destination` | Text | City or region to search (e.g., "New York", "Paris") | `New York` | | `checkIn` | Text | Check-in date YYYY-MM-DD | Tomorrow | | `checkOut` | Text | Check-out date YYYY-MM-DD | Day after check-in | | `adults` | Integer | Number of adult guests (1–20) | `2` | | `rooms` | Integer | Number of rooms (1–10) | `1` | | `sortBy` | Select | Sort: relevance, price, rating, stars | `relevance` | | `starRating` | Select | Minimum star rating: all, 1–5 | `all` | | `startUrls` | List | Hotel URLs for byHotelUrls mode | — | | `maxItems` | Integer | Maximum results (1–1000) | `50` | ### Modes #### `searchHotels` (default) Search hotels by destination with date and guest filters. Returns a list of hotels matching your search criteria with prices from multiple booking providers. #### `byHotelUrls` Enrich specific Trivago hotel URLs. Provide a list of Trivago hotel page URLs and extract detailed information for each. #### `topDeals` Fetch currently featured hotel deals from popular destinations worldwide. Great for monitoring price trends. ### Example Input ```json { "mode": "searchHotels", "destination": "New York", "checkIn": "2026-08-01", "checkOut": "2026-08-05", "adults": 2, "rooms": 1, "sortBy": "price", "starRating": "4", "maxItems": 50 } ```` ### Example Output ```json { "hotelId": "the-times-square-edition", "name": "The EDITION Times Square", "url": "https://www.trivago.com/en-US/odr/the-times-square-edition", "imageUrl": "https://cdn.trivago.com/hotels/times-square-edition.jpg", "destination": "New York", "checkIn": "2026-08-01", "checkOut": "2026-08-05", "price": 389.00, "currency": "USD", "rating": 9.1, "reviewCount": 4821, "starRating": 5, "address": "701 7th Avenue, New York, United States", "latitude": 40.7590, "longitude": -73.9845, "amenities": ["Free WiFi", "Pool", "Spa", "Gym", "Restaurant"], "providers": [ {"name": "Booking.com", "price": 389.00}, {"name": "Hotels.com", "price": 395.00}, {"name": "Expedia", "price": 402.00} ], "recordType": "trivagoHotel", "scrapedAt": "2026-05-15T10:30:00+00:00" } ``` ### Frequently Asked Questions **Q: Why am I getting 0 results for some destinations?** A: Trivago uses Akamai bot protection on its search results API. For best results, configure a residential proxy in the `proxyConfiguration` input. Datacenter IPs may return empty results on the search API. **Q: Which hotel booking sites does Trivago compare?** A: Trivago compares prices from 400+ booking sites including Booking.com, Hotels.com, Expedia, Agoda, Priceline, and many more. The `providers` field in the output lists which OTAs offer the hotel and at what price. **Q: How are prices represented?** A: Prices are the best available rate found across all providers at the time of scraping. The `price` field shows the lowest price. The `providers` list shows all available prices per OTA. **Q: Can I scrape multiple destinations in one run?** A: For `topDeals` mode, the scraper automatically searches multiple popular destinations. For `searchHotels`, run the actor multiple times with different destination values. **Q: What does the Trivago rating mean?** A: Trivago's rating is on a 0–10 scale, aggregated from multiple review sources. Scores above 8.0 are considered "Good", above 9.0 "Superb". **Q: Does this scraper support all countries?** A: Yes, Trivago covers hotels worldwide. Use the destination field with any city or region name. **Q: Can I filter by amenities?** A: The scraper extracts amenity data as listed on Trivago. Use the `amenities` field in your downstream data pipeline to filter by specific amenities. ### Legal Notice This scraper is intended for legitimate data collection purposes such as price monitoring, market research, and travel planning. Please comply with Trivago's Terms of Service and robots.txt when using this tool. # Actor input Schema ## `mode` (type: `string`): Scraping mode: search hotels, scrape specific hotel URLs, or fetch top deals. ## `destination` (type: `string`): City or region to search for hotels (e.g. 'New York', 'Paris', 'London'). ## `checkIn` (type: `string`): Check-in date in YYYY-MM-DD format. Defaults to tomorrow. ## `checkOut` (type: `string`): Check-out date in YYYY-MM-DD format. Defaults to 2 days after check-in. ## `adults` (type: `integer`): Number of adult guests. ## `rooms` (type: `integer`): Number of rooms to book. ## `sortBy` (type: `string`): How to sort the hotel results. ## `starRating` (type: `string`): Filter hotels by minimum star rating. 'all' returns all hotels. ## `startUrls` (type: `array`): List of Trivago hotel URLs to scrape (used in byHotelUrls mode). ## `maxItems` (type: `integer`): Maximum number of hotels to return. ## Actor input object example ```json { "mode": "searchHotels", "destination": "New York", "adults": 2, "rooms": 1, "sortBy": "relevance", "starRating": "all", "maxItems": 50 } ``` # 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 = { "mode": "searchHotels", "destination": "New York", "adults": 2, "rooms": 1, "maxItems": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/trivago-hotel-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 = { "mode": "searchHotels", "destination": "New York", "adults": 2, "rooms": 1, "maxItems": 50, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/trivago-hotel-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 '{ "mode": "searchHotels", "destination": "New York", "adults": 2, "rooms": 1, "maxItems": 50 }' | apify call crawlerbros/trivago-hotel-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/trivago-hotel-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Trivago Hotel Scraper", "description": "Scrape hotel listings, prices, ratings, and deals from Trivago. Search by destination, compare OTA prices, and extract hotel details at scale", "version": "0.1", "x-build-id": "rpKmrC9VfDOIrGxdC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~trivago-hotel-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-trivago-hotel-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/crawlerbros~trivago-hotel-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-trivago-hotel-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/crawlerbros~trivago-hotel-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-trivago-hotel-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": { "mode": { "title": "Mode", "enum": [ "searchHotels", "byHotelUrls", "topDeals" ], "type": "string", "description": "Scraping mode: search hotels, scrape specific hotel URLs, or fetch top deals.", "default": "searchHotels" }, "destination": { "title": "Destination", "type": "string", "description": "City or region to search for hotels (e.g. 'New York', 'Paris', 'London')." }, "checkIn": { "title": "Check-In Date", "type": "string", "description": "Check-in date in YYYY-MM-DD format. Defaults to tomorrow." }, "checkOut": { "title": "Check-Out Date", "type": "string", "description": "Check-out date in YYYY-MM-DD format. Defaults to 2 days after check-in." }, "adults": { "title": "Number of Adults", "minimum": 1, "maximum": 20, "type": "integer", "description": "Number of adult guests.", "default": 2 }, "rooms": { "title": "Number of Rooms", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of rooms to book.", "default": 1 }, "sortBy": { "title": "Sort By", "enum": [ "relevance", "price", "rating", "stars" ], "type": "string", "description": "How to sort the hotel results.", "default": "relevance" }, "starRating": { "title": "Minimum Star Rating", "enum": [ "all", "1", "2", "3", "4", "5" ], "type": "string", "description": "Filter hotels by minimum star rating. 'all' returns all hotels.", "default": "all" }, "startUrls": { "title": "Start URLs", "type": "array", "description": "List of Trivago hotel URLs to scrape (used in byHotelUrls mode).", "items": { "type": "string" } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of hotels to return.", "default": 50 } } }, "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 } } } } } } } } } } ```