{ "openapi": "3.0.1", "info": { "title": "Google Travel Hotels Scraper: Hotel Rates & Prices by Date", "description": "Scrape hotel prices from Google Hotels (Google Travel hotels) for any city or hotel and your dates: nightly and total hotel rates, provider offers (Booking.com, Expedia, direct), stars, rating, reviews, amenities. Date-range mode works as a hotel price tracker. A Google Hotels API.", "version": "0.1", "x-build-id": "xm8gn5XncrfynNQAp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data-done-right~google-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data-done-right-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/data-done-right~google-hotels-scraper/runs": { "post": { "operationId": "runs-sync-data-done-right-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/data-done-right~google-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-data-done-right-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": { "destinations": { "title": "Destinations", "type": "array", "description": "Cities, areas or full searches, e.g. 'Lisbon', 'Paris 11th arrondissement', 'hotels near Times Square'. 'hotels in' is added when the text doesn't mention hotels. Each destination returns up to 20 properties (Google's first results page).", "items": { "type": "string" } }, "hotelNames": { "title": "Hotel names", "type": "array", "description": "Specific hotels, ideally with the city, e.g. 'Avenida Palace Lisbon'. Each returns the best matching hotel with all provider offers (Booking.com, Expedia, hotel direct...).", "items": { "type": "string" } }, "checkIn": { "title": "Check-in date", "type": "string", "description": "YYYY-MM-DD. Empty = 30 days from today." }, "checkOut": { "title": "Check-out date", "type": "string", "description": "YYYY-MM-DD. Empty = check-in plus 'Nights'." }, "nights": { "title": "Nights", "minimum": 1, "maximum": 30, "type": "integer", "description": "Length of stay when no check-out date is given (also used by the date-range mode).", "default": 1 }, "dateRangeEnd": { "title": "Date range: last check-in date", "type": "string", "description": "Price-calendar mode. When set, the same searches run for every check-in date from 'Check-in date' to this date (step below, max 31 dates). Each date is a separate Google page." }, "dateStepDays": { "title": "Date range: step (days)", "minimum": 1, "maximum": 30, "type": "integer", "description": "Days between check-in dates in the date range (1 = every day, 7 = same weekday each week).", "default": 1 }, "adults": { "title": "Adults", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of adult guests (one room).", "default": 2 }, "currency": { "title": "Currency", "type": "string", "description": "ISO currency code for prices, e.g. USD, EUR, GBP, JPY.", "default": "USD" }, "language": { "title": "Language", "type": "string", "description": "Google interface language (hl), e.g. en, de, fr, es. Affects names, descriptions and deal labels.", "default": "en" }, "country": { "title": "Country", "type": "string", "description": "Google country (gl), e.g. us, gb, de. Prices and providers can differ by country.", "default": "us" }, "maxHotelsPerSearch": { "title": "Max hotels per destination", "minimum": 1, "maximum": 20, "type": "integer", "description": "Up to 20 (Google's first results page) per destination and date.", "default": 20 }, "offersForTopHotels": { "title": "Provider offers for top N hotels", "minimum": 0, "maximum": 20, "type": "integer", "description": "For destination searches: also open the hotel page of the first N hotels to get every provider offer (Booking.com, Expedia, hotel direct...). One extra page per hotel, charged as 'hotel-offers'. 0 = lowest price only. Hotel-name lookups always include offers.", "default": 0 }, "includeVacationRentals": { "title": "Include vacation rentals", "type": "boolean", "description": "Keep apartments and houses Google mixes into some results (they have no star class or hotel amenity codes).", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Residential proxy is recommended for Google (default). On a block the actor switches to a new IP automatically.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }, "debugSaveHtml": { "title": "Debug: save raw HTML", "type": "boolean", "description": "Save the first 10 Google pages to the key-value store (HTML-0, HTML-1, ...) for troubleshooting.", "default": false } } }, "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 } } } } } } } } } }