# Priceline Hotel Scraper (`mrbridge/priceline-hotel-scraper`) Actor Extract hotel prices, guest ratings, amenities, star levels, deals and availability from Priceline.com. Search any destination with date, room and guest filters. Sort by price, rating or stars. Returns up to 500 structured results per search, ready for analysis or integration. - **URL**: https://apify.com/mrbridge/priceline-hotel-scraper.md - **Developed by:** [MrBridge](https://apify.com/mrbridge) (community) - **Categories:** Travel - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.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/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 ## Priceline Hotel Scraper Scrape hotel listings from [Priceline.com](https://www.priceline.com) and extract structured data including prices, guest ratings, amenities, star levels, and deals. No login or API key required from Priceline — just provide a destination and travel dates. ### What does this scraper do? Priceline Hotel Scraper searches Priceline.com like a regular user and extracts all visible hotel information from the search results page. It returns clean, structured JSON data ready for analysis, price monitoring, or integration into your travel workflow. Use it to: - **Compare hotel prices** across destinations and date ranges - **Monitor price drops** by scheduling periodic runs - **Build travel datasets** for research or analytics - **Power booking tools** with real-time Priceline data - **Track competitor pricing** for hospitality businesses ### What data can you extract? Each hotel listing includes the following fields: | Field | Description | Example | |-------|-------------|---------| | `name` | Hotel name | "The Plaza Hotel" | | `url` | Direct Priceline link | `https://www.priceline.com/relax/at/700012345` | | `neighborhood` | Area or district | "Midtown West" | | `starLevel` | Star rating (1-5) | `4` | | `guestRating` | Guest score (0-10) | `8.8` | | `reviewCount` | Number of reviews | `2451` | | `ratingCategory` | Rating label | "Excellent" | | `pricePerNight` | Nightly rate | `189` | | `originalPrice` | Price before discount | `245` | | `totalPrice` | Total stay cost | `567` | | `currency` | Price currency (converted if selected) | "EUR" | | `originalCurrency` | Currency before conversion | "USD" | | `exchangeRate` | Exchange rate used | `0.92` | | `discount` | Savings amount | "$56 Off" | | `amenities` | Hotel amenities | ["Free Internet Access", "Restaurant", ...] | | `highlights` | Booking perks | ["Free Cancellation", "Pay Later Available"] | | `tags` | Priceline badges | ["Top Booked", "Luxury"] | | `imageUrl` | Hotel photo URL | `https://...` | | `checkIn` / `checkOut` | Search dates | "2026-05-15" | ### How to scrape Priceline hotels 1. Go to the [Priceline Hotel Scraper](https://apify.com/mrbridge/priceline-hotel-scraper?fpr=mrbridge) page on Apify Store. 2. Click **Try for free**. 3. Enter your **destination** (e.g. "New York, NY", "Paris, France"). 4. Select your **check-in** and **check-out** dates using the day, month, and year dropdowns. 5. Optionally adjust **rooms**, **adults**, **filters** (star level, guest rating, price range) and **sort order**. 6. Click **Start**. 7. When the run finishes, download your results as **JSON**, **CSV**, or **Excel** from the Dataset tab. ### Input configuration | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `destination` | string | — | City or area name (required) | | `checkInDay` | select | 15 | Check-in day (1-31) | | `checkInMonth` | select | May | Check-in month (January-December) | | `checkInYear` | select | 2026 | Check-in year (2026-2035) | | `checkOutDay` | select | 18 | Check-out day (1-31) | | `checkOutMonth` | select | May | Check-out month (January-December) | | `checkOutYear` | select | 2026 | Check-out year (2026-2035) | | `rooms` | integer | 1 | Number of rooms (1-9) | | `adults` | integer | 2 | Adults per room (1-9) | | `hotelStarLevel` | select | Any | Minimum star rating (2+, 3+, 4+, 5) | | `guestRating` | select | Any | Minimum guest rating (6+, 7+, 8+, 9+) | | `priceMin` | integer | — | Minimum price per night (in selected currency) | | `priceMax` | integer | — | Maximum price per night (in selected currency) | | `currency` | select | As Scraped | Target currency for prices (USD, EUR, GBP, CAD, CHF, AUD, JPY, CNY, INR, BRL, MXN, SEK, NOK, DKK) | | `sortBy` | select | Recommended | Sort order (Price Low/High, Guest Rating, Star Rating) | | `maxResults` | integer | 50 | Maximum hotels to return (1-500) | #### Input example ```json { "destination": "New York, NY", "checkInDay": "20", "checkInMonth": "6", "checkInYear": "2026", "checkOutDay": "23", "checkOutMonth": "6", "checkOutYear": "2026", "rooms": 1, "adults": 2, "hotelStarLevel": "4", "sortBy": "price_low", "maxResults": 30 } ```` ### Output example ```json { "name": "The Westin New York at Times Square", "url": "https://www.priceline.com/relax/at/700012345", "neighborhood": "Midtown West", "address": "", "starLevel": 4, "propertyType": "", "tags": ["Top Booked"], "guestRating": 8.2, "reviewCount": 3120, "ratingCategory": "Excellent", "pricePerNight": 199, "originalPrice": 259, "totalPrice": 597, "currency": "USD", "originalCurrency": "USD", "exchangeRate": null, "discount": "$60 Off", "priceIncludesFees": true, "amenities": ["Free Internet Access", "Restaurant", "Fitness Center"], "highlights": ["Free Cancellation", "Pay Later Available"], "isExpressDeal": false, "imageUrl": "https://images.priceline.com/...", "imageCount": 25, "scrapedAt": "2026-04-08T22:04:36.000Z", "searchDestination": "New York, NY", "checkIn": "2026-06-20", "checkOut": "2026-06-23" } ``` ### How much does it cost? Priceline Hotel Scraper uses a **pay-per-result** pricing model at **$0.005 per hotel result**. You only pay for the hotel listings actually returned — there is no charge if the search fails or returns no results. | Results | Cost | |---------|------| | 10 | $0.05 | | 50 | $0.25 | | 100 | $0.50 | | 500 | $2.50 | Apify platform usage costs are included — no separate compute charges. **Free tier**: Apify gives new users $5 of free monthly credits, enough for ~1,000 hotel results. ### Performance - **Speed**: Results returned in 15-25 seconds per search - **Reliability**: Automatic retries with exponential backoff on transient errors - **Memory**: 512 MB default — no configuration needed ### Tips - **Schedule runs** to track price changes over time — Priceline prices fluctuate daily. - **Use filters** to narrow results and get more relevant listings (e.g. 4+ stars under $200/night). - **Sort by price** (`price_low`) to find the best deals quickly. - **Increase `maxResults`** up to 500 if you need comprehensive coverage of a destination. - **Convert prices** to your local currency (EUR, GBP, etc.) using the `currency` option — price filters are applied after conversion. - **Export as CSV** for easy import into Google Sheets or Excel. ### Is it legal to scrape Priceline? Web scraping of publicly available data is generally considered legal, as confirmed by the [2022 US Ninth Circuit ruling in hiQ Labs v. LinkedIn](https://en.wikipedia.org/wiki/HiQ_Labs_v._LinkedIn). This scraper only accesses publicly visible hotel search results — the same information any visitor can see on Priceline.com without logging in. No personal data is collected. Always review Priceline's Terms of Service and ensure your use case complies with applicable laws in your jurisdiction. ### Support & feedback - **Issues?** Open a ticket on [Apify Console](https://console.apify.com) or contact the author. - **Feature requests?** Suggestions are welcome — reach out via the Apify platform. - **Updates**: This actor is actively maintained and updated to handle Priceline site changes. # Actor input Schema ## `destination` (type: `string`): City or area name (e.g. 'New York, NY', 'Paris, France'). ## `checkInDay` (type: `string`): Check-in day of the month. ## `checkInMonth` (type: `string`): Check-in month. ## `checkInYear` (type: `string`): Check-in year. ## `checkOutDay` (type: `string`): Check-out day of the month. ## `checkOutMonth` (type: `string`): Check-out month. ## `checkOutYear` (type: `string`): Check-out year. ## `rooms` (type: `integer`): Number of hotel rooms. ## `adults` (type: `integer`): Number of adult guests per room. ## `hotelStarLevel` (type: `string`): Minimum hotel star rating. ## `guestRating` (type: `string`): Minimum guest rating threshold. ## `priceMin` (type: `integer`): Minimum price per night. Applied in the selected currency (or scraped currency if none selected). ## `priceMax` (type: `integer`): Maximum price per night. Applied in the selected currency (or scraped currency if none selected). ## `currency` (type: `string`): Convert prices to a specific currency. Leave empty to keep the original scraped currency (usually USD). ## `sortBy` (type: `string`): Sort order for hotel results. ## `maxResults` (type: `integer`): Maximum number of hotels to return. ## Actor input object example ```json { "destination": "New York, NY", "checkInDay": "15", "checkInMonth": "5", "checkInYear": "2026", "checkOutDay": "18", "checkOutMonth": "5", "checkOutYear": "2026", "rooms": 1, "adults": 2, "hotelStarLevel": "", "guestRating": "", "currency": "", "sortBy": "recommended", "maxResults": 50 } ``` # Actor output Schema ## `hotelResults` (type: `string`): Structured hotel listings with prices, ratings, amenities and booking details. ## `rawHtml` (type: `string`): Raw Priceline HTML response saved for debugging and parser development. ## `runError` (type: `string`): Structured error data when the scraping run fails (error message, type, input, timestamp). # 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 = { "destination": "New York, NY" }; // Run the Actor and wait for it to finish const run = await client.actor("mrbridge/priceline-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 = { "destination": "New York, NY" } # Run the Actor and wait for it to finish run = client.actor("mrbridge/priceline-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 '{ "destination": "New York, NY" }' | apify call mrbridge/priceline-hotel-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=mrbridge/priceline-hotel-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Priceline Hotel Scraper", "description": "Extract hotel prices, guest ratings, amenities, star levels, deals and availability from Priceline.com. Search any destination with date, room and guest filters. Sort by price, rating or stars. Returns up to 500 structured results per search, ready for analysis or integration.", "version": "0.1", "x-build-id": "m1NjOQMK4qU4eTuHX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mrbridge~priceline-hotel-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mrbridge-priceline-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/mrbridge~priceline-hotel-scraper/runs": { "post": { "operationId": "runs-sync-mrbridge-priceline-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/mrbridge~priceline-hotel-scraper/run-sync": { "post": { "operationId": "run-sync-mrbridge-priceline-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", "required": [ "destination" ], "properties": { "destination": { "title": "Destination", "type": "string", "description": "City or area name (e.g. 'New York, NY', 'Paris, France')." }, "checkInDay": { "title": "Day", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31" ], "type": "string", "description": "Check-in day of the month.", "default": "15" }, "checkInMonth": { "title": "Month", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12" ], "type": "string", "description": "Check-in month.", "default": "5" }, "checkInYear": { "title": "Year", "enum": [ "2026", "2027", "2028", "2029", "2030", "2031", "2032", "2033", "2034", "2035" ], "type": "string", "description": "Check-in year.", "default": "2026" }, "checkOutDay": { "title": "Day", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31" ], "type": "string", "description": "Check-out day of the month.", "default": "18" }, "checkOutMonth": { "title": "Month", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12" ], "type": "string", "description": "Check-out month.", "default": "5" }, "checkOutYear": { "title": "Year", "enum": [ "2026", "2027", "2028", "2029", "2030", "2031", "2032", "2033", "2034", "2035" ], "type": "string", "description": "Check-out year.", "default": "2026" }, "rooms": { "title": "Rooms", "minimum": 1, "maximum": 9, "type": "integer", "description": "Number of hotel rooms.", "default": 1 }, "adults": { "title": "Adults per Room", "minimum": 1, "maximum": 9, "type": "integer", "description": "Number of adult guests per room.", "default": 2 }, "hotelStarLevel": { "title": "Min Star Level", "enum": [ "", "2", "3", "4", "5" ], "type": "string", "description": "Minimum hotel star rating.", "default": "" }, "guestRating": { "title": "Min Guest Rating", "enum": [ "", "6+", "7+", "8+", "9+" ], "type": "string", "description": "Minimum guest rating threshold.", "default": "" }, "priceMin": { "title": "Min Price per Night", "minimum": 0, "type": "integer", "description": "Minimum price per night. Applied in the selected currency (or scraped currency if none selected)." }, "priceMax": { "title": "Max Price per Night", "minimum": 0, "type": "integer", "description": "Maximum price per night. Applied in the selected currency (or scraped currency if none selected)." }, "currency": { "title": "Currency", "enum": [ "", "USD", "EUR", "GBP", "CAD", "CHF", "AUD", "JPY", "CNY", "INR", "BRL", "MXN", "SEK", "NOK", "DKK" ], "type": "string", "description": "Convert prices to a specific currency. Leave empty to keep the original scraped currency (usually USD).", "default": "" }, "sortBy": { "title": "Sort By", "enum": [ "recommended", "price_low", "price_high", "rating", "star_rating" ], "type": "string", "description": "Sort order for hotel results.", "default": "recommended" }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 500, "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 } } } } } } } } } } ```