{ "openapi": "3.0.1", "info": { "title": "Google Hotels Price Scraper", "description": "Reliable Google Hotels price scraper for price monitoring. Get nightly and total prices, booking-site prices (Booking.com, Expedia, official site...), ratings, reviews, hotel class, amenities and location for any city and dates.", "version": "1.0", "x-build-id": "D36DbheSuDNT79OaS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/symphonic_mullite~google-hotels-prices/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-symphonic_mullite-google-hotels-prices", "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/symphonic_mullite~google-hotels-prices/runs": { "post": { "operationId": "runs-sync-symphonic_mullite-google-hotels-prices", "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/symphonic_mullite~google-hotels-prices/run-sync": { "post": { "operationId": "run-sync-symphonic_mullite-google-hotels-prices", "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": [ "destinations" ], "properties": { "destinations": { "title": "Destinations", "minItems": 1, "maxItems": 500, "type": "array", "description": "Cities, areas or landmarks (for example \"Paris\", \"Shibuya, Tokyo\", \"hotels near Times Square\"), or Google Hotels URLs: a search URL (google.com/travel/search?...), a city page (google.com/travel/hotels/Paris) or a single hotel (google.com/travel/hotels/entity/...). Dates, guests, currency and filters inside a pasted URL are used for that URL.", "items": { "type": "string" } }, "checkInDate": { "title": "Check-in date", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(day|week|month|year)s?$", "type": "string", "description": "A date (YYYY-MM-DD) or a relative value counted from the run day, such as \"14 days\", \"2 weeks\" or \"1 month\". Relative values keep scheduled price-monitoring runs pointing at future dates. Default: 14 days from today." }, "nights": { "title": "Nights", "minimum": 1, "maximum": 30, "type": "integer", "description": "Length of stay in nights. Ignored when a check-out date is set.", "default": 1 }, "checkOutDate": { "title": "Check-out date (optional)", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(day|week|month|year)s?$", "type": "string", "description": "Optional. A date (YYYY-MM-DD) or relative value (\"16 days\"). When set, it overrides Nights." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 12, "type": "integer", "description": "Number of adult guests.", "default": 2 }, "children": { "title": "Children", "minimum": 0, "maximum": 8, "type": "integer", "description": "Number of children. Google Hotels prices the stay for adults and children together; it has no separate room count.", "default": 0 }, "childrenAges": { "title": "Children's ages", "type": "array", "description": "Optional ages (0-17), one per child, e.g. [5, 9]. Missing ages default to 8." }, "maxHotelsPerDestination": { "title": "Max hotels per destination", "minimum": 1, "maximum": 2000, "type": "integer", "description": "How many hotels to save for each destination. Google returns 20 per page; the Actor pages through results until this number is reached or Google has no more.", "default": 20 }, "currency": { "title": "Currency", "enum": [ "USD", "EUR", "GBP", "AED", "ALL", "AMD", "ARS", "AUD", "AWG", "AZN", "BAM", "BGN", "BHD", "BMD", "BRL", "BSD", "BYN", "CAD", "CHF", "CLP", "CNY", "COP", "CRC", "CUP", "CZK", "DKK", "DOP", "DZD", "EGP", "GEL", "HKD", "HRK", "HUF", "IDR", "ILS", "INR", "IRR", "ISK", "JMD", "JOD", "JPY", "KRW", "KWD", "KZT", "LBP", "MAD", "MDL", "MKD", "MXN", "MYR", "NOK", "NZD", "OMR", "PAB", "PEN", "PHP", "PKR", "PLN", "QAR", "RON", "RSD", "RUB", "SAR", "SEK", "SGD", "THB", "TRY", "TWD", "UAH", "VND", "XPF", "ZAR" ], "type": "string", "description": "Currency for all prices.", "default": "USD" }, "language": { "title": "Language (hl)", "type": "string", "description": "Google interface language code, e.g. \"en\", \"en-GB\", \"de\", \"fr\", \"ja\". Affects hotel descriptions and labels.", "default": "en" }, "country": { "title": "Country (gl)", "type": "string", "description": "2-letter country code of the visitor Google should assume, e.g. \"us\", \"gb\", \"de\". Prices can differ by country. With Apify residential proxy, the proxy country follows this value unless you set one.", "default": "us" }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "lowest_price", "highest_rating", "most_reviewed" ], "type": "string", "description": "Order of results, as on Google Hotels.", "default": "relevance" }, "minRating": { "title": "Minimum guest rating", "enum": [ "any", "3.5", "4.0", "4.5" ], "type": "string", "description": "Only hotels with at least this Google guest rating.", "default": "any" }, "hotelClass": { "title": "Hotel class (stars)", "type": "array", "description": "Only hotels of these star classes. Leave empty for any.", "items": { "type": "string", "enum": [ "2", "3", "4", "5" ], "enumTitles": [ "2-star", "3-star", "4-star", "5-star" ] } }, "minPrice": { "title": "Minimum price per night", "minimum": 0, "type": "integer", "description": "In the selected currency. Leave empty for no minimum." }, "maxPrice": { "title": "Maximum price per night", "minimum": 1, "type": "integer", "description": "In the selected currency. Leave empty for no maximum." }, "freeCancellationOnly": { "title": "Free cancellation only", "type": "boolean", "description": "Only hotels that offer a free-cancellation rate.", "default": false }, "includeBookingPrices": { "title": "Include booking-site prices", "type": "boolean", "description": "Also fetch each hotel's prices from every booking site Google lists (Booking.com, Expedia, Hotels.com, Agoda, the official site and more) with direct links and free-cancellation flags, plus the full address and phone number. Makes one extra request per hotel, so runs take longer. Same price per hotel.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Google blocks datacenter IPs quickly, so Apify residential proxies are the default and recommended.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum parallel requests. Pages of one destination are fetched in order; parallelism comes from several destinations and booking-site lookups.", "default": 10 } } }, "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 } } } } } } } } } }