{ "openapi": "3.0.1", "info": { "title": "Google Hotels Scraper - Prices, Price Changes & Rate Monitor", "description": "For travel agencies, revenue managers and price-tracking apps: hotel name, nightly and total price, taxes, rating, reviews, stars, amenities and booking sites from Google Hotels in 72 currencies. 10 of 10 prices matched the Google Hotels page. Monitoring returns only price changes and new hotels.", "version": "0.1", "x-build-id": "albJu91KDDlXv63rN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~google-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-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/neverempty~google-hotels-scraper/runs": { "post": { "operationId": "runs-sync-neverempty-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/neverempty~google-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-neverempty-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": "Locations", "type": "array", "description": "Where to look, written as you would type it into Google Hotels: a city (Paris), a district (Shibuya, Tokyo), a landmark (hotels near Times Square) or a hotel name. Each entry is one search. Every row says which place Google actually searched (resolvedLocation); if Google reads your text as a different place, a free row says so.", "items": { "type": "string" } }, "checkInDate": { "title": "Check-in date", "type": "string", "description": "YYYY-MM-DD (for example 2026-12-03), or +N for N days from today in UTC (+30 = 30 days from today). Dates before yesterday (UTC) and arrivals more than 330 days ahead (Google shows no prices that far out) are refused before anything is requested. Empty = 30 days from today." }, "checkOutDate": { "title": "Check-out date", "type": "string", "description": "YYYY-MM-DD or +N days from today. Must be after check-in; at most 30 nights. Empty = 1 night after the check-in you gave (2 nights when check-in is empty too)." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 12, "type": "integer", "description": "Guests the price is for. Empty = 2. Every row repeats the dates and guests Google priced (stayAsRequested says whether they match what you asked for)." }, "currency": { "title": "Currency", "enum": [ "ALL", "DZD", "ARS", "AMD", "AWG", "AUD", "AZN", "BSD", "BHD", "BYN", "BMD", "BAM", "BRL", "GBP", "BGN", "XPF", "CAD", "CLP", "CNY", "COP", "CRC", "HRK", "CUP", "CZK", "DKK", "DOP", "EGP", "EUR", "GEL", "HKD", "HUF", "ISK", "INR", "IDR", "IRR", "ILS", "JMD", "JPY", "JOD", "KZT", "KWD", "LBP", "MKD", "MYR", "MXN", "MDL", "MAD", "TWD", "NZD", "NOK", "OMR", "PKR", "PAB", "PEN", "PHP", "PLN", "QAR", "RON", "RUB", "SAR", "RSD", "SGD", "ZAR", "KRW", "SEK", "CHF", "THB", "TRY", "USD", "UAH", "AED", "VND" ], "type": "string", "description": "Currency of every price, from the list Google Hotels offers. Empty = USD. Each row carries the currency Google actually used." }, "sortBy": { "title": "Sort by", "enum": [ "lowest-price", "relevance", "highest-rating", "most-reviewed" ], "type": "string", "description": "Order Google lists hotels in. Empty = lowest price. Relevance shows a different mix of hotels on each read, so use a sorted order for monitoring." }, "minPrice": { "title": "Minimum price per night", "minimum": 1, "type": "integer", "description": "Keep hotels at or above this nightly price, in the chosen currency. Applied by Google, as the price slider on the site." }, "maxPrice": { "title": "Maximum price per night", "minimum": 1, "type": "integer", "description": "Keep hotels at or below this nightly price, in the chosen currency. Applied by Google, as the price slider on the site." }, "maxHotels": { "title": "Max hotels per location", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many hotels to read for each location. Google lists about 18-20 per page. Empty = 50. In monitoring mode this is how many hotels are watched." }, "includeBookingSources": { "title": "Include booking sources", "type": "boolean", "description": "Also open each hotel's price page and list every booking site Google shows (Booking.com, Expedia, the hotel's own site...) with its nightly and total price. One extra page per hotel, so runs are slower. Off = no extra pages." }, "monitoringMode": { "title": "Monitoring mode", "type": "boolean", "description": "Return only hotels that are new to this watch or whose nightly price moved since the row last returned for them (price-up, price-down, price-shown). Unchanged hotels are not returned; each hotel compared is charged the small check fee. The first run returns every hotel as new." }, "minPriceChangePercent": { "title": "Smallest price change to report (%)", "minimum": 0, "maximum": 100, "type": "number", "description": "Monitoring only. A price counts as changed when it moved at least this much from the price last returned. Empty = 2. Google's shown price can flip by 1 between reads (151 / 152); 0 reports every flip." }, "resetMonitoringState": { "title": "Reset monitoring state", "type": "boolean", "description": "Forget what this search remembered, so the next monitoring run returns every hotel as new." } } }, "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 } } } } } } } } } }