{ "openapi": "3.0.1", "info": { "title": "Priceline hotel scraper: prices, ratings, deals", "description": "Extract hotel prices, ratings, amenities, star levels and deals from Priceline.com. Search any destination with date, room and guest filters, sort by price, rating or stars, and return up to 500 results per search. Export data, run via API, schedule runs, or integrate with other tools. By MrBridge", "version": "0.4", "x-build-id": "KMixVRtohbw4H2ek4" }, "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. Leave all six date fields empty to search a stay starting 30 days from today, for 3 nights. A check-in in the past is refused before any paid request, and nothing is charged." }, "checkInMonth": { "title": "Month", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12" ], "type": "string", "description": "Check-in month. Leave all six date fields empty for a stay 30 days from today." }, "checkInYear": { "title": "Year", "enum": [ "2026", "2027", "2028", "2029", "2030", "2031", "2032", "2033", "2034", "2035" ], "type": "string", "description": "Check-in year. Leave all six date fields empty for a stay 30 days from today." }, "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. Leave the check-out empty to stay 3 nights after the check-in." }, "checkOutMonth": { "title": "Month", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12" ], "type": "string", "description": "Check-out month. Leave the check-out empty to stay 3 nights after the check-in." }, "checkOutYear": { "title": "Year", "enum": [ "2026", "2027", "2028", "2029", "2030", "2031", "2032", "2033", "2034", "2035" ], "type": "string", "description": "Check-out year. Leave the check-out empty to stay 3 nights after the check-in." }, "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 every price to this currency. Leave empty to keep the currency Priceline returns, normally USD because every request goes through a US connection. If you pick a currency and no exchange rate can be fetched, the run fails before delivering anything.", "default": "" }, "sortBy": { "title": "Sort By", "enum": [ "recommended", "price_low", "price_high", "rating", "star_rating" ], "type": "string", "description": "Sort order for hotel results. Sorting is applied to the hotels Priceline returns for your search (around 30 per run), so it decides which ones you receive when maxResults is lower than that. It does not reach hotels Priceline did not list.", "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }