{ "openapi": "3.0.1", "info": { "title": "Google Hotels Scraper – Prices, Ratings & Deals by Date", "description": "Scrape Google Hotels for any city and dates: nightly and total prices in your currency, prices per booking site (Booking.com, Expedia, official site…), a 90-day price calendar, deals, star class, rating, reviews and location. No login. $0.003 per hotel.", "version": "1.0", "x-build-id": "LNit6ragaXjil6Spm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tubetext~google-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tubetext-google-hotels-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/tubetext~google-hotels-scraper/runs": { "post": { "operationId": "runs-sync-tubetext-google-hotels-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/tubetext~google-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-tubetext-google-hotels-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": { "locations": { "title": "Destinations", "type": "array", "description": "Cities, areas or free-text searches, one per line: 'Austin, TX', 'Paris', 'hotels near Times Square', 'resorts in Cancun'. Plain place names are searched as 'hotels in '.", "items": { "type": "string" } }, "checkInDate": { "title": "Check-in date", "type": "string", "description": "YYYY-MM-DD. Empty = 14 days from today." }, "checkOutDate": { "title": "Check-out date", "type": "string", "description": "YYYY-MM-DD. Empty = 2 nights after check-in." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 12, "type": "integer", "description": "Number of adult guests.", "default": 2 }, "currency": { "title": "Currency", "enum": [ "USD", "EUR", "GBP", "CAD", "AUD", "JPY", "CNY", "INR", "BRL", "MXN", "CHF", "SEK", "NOK", "DKK", "PLN", "TRY", "AED", "SGD", "HKD", "KRW", "THB", "IDR", "ZAR", "NZD" ], "type": "string", "description": "Prices are returned in this currency.", "default": "USD" }, "maxHotelsPerLocation": { "title": "Max hotels per destination", "minimum": 1, "maximum": 500, "type": "integer", "description": "Google shows 20 hotels per page in its default ranking.", "default": 40 }, "maxConcurrency": { "title": "Destinations in parallel", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many destinations are searched at the same time.", "default": 3 }, "includeBookingOffers": { "title": "Include prices per booking site", "type": "boolean", "description": "For each hotel with a price, also open its Google hotel page and list every booking site's price (Booking.com, Expedia, Agoda, the hotel's own site…), cheapest first, with room types and whether the listing is an ad. Slower; billed as an extra 'booking-offers' event per hotel that has offers.", "default": false }, "calendarHotelUrls": { "title": "Price calendar: hotel page links", "type": "array", "description": "Optional. Google hotel page links (the 'googleHotelsUrl' field of a search result, google.com/travel/hotels/entity/…). For each, prices are checked for every check-in date from 'Check-in date' over 'Calendar days' - one row per date with the lowest price and every booking site's price.", "items": { "type": "string" } }, "calendarDays": { "title": "Calendar days", "minimum": 1, "maximum": 90, "type": "integer", "description": "How many consecutive check-in dates to check for each calendar hotel (starting at 'Check-in date').", "default": 14 }, "calendarNights": { "title": "Calendar stay length (nights)", "minimum": 1, "maximum": 30, "type": "integer", "description": "Length of each calendar stay.", "default": 1 } } }, "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 } } } } } } } } } }