{ "openapi": "3.0.1", "info": { "title": "Google Hotels Scraper — Hotel Prices & OTA Rates API | $0.90/1k", "description": "Scrape Google Hotels for any destination and dates: hotel name, star class, rating, review count, price per night and total with taxes, deals, amenities, lat/lng and Google hotel link. Optional price from every booking site (OTA rates). Filter by class and property type. CSV, JSON, Excel.", "version": "0.1", "x-build-id": "qjOUdy7FQFCiWgllT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/glasswing~google-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-glasswing-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/glasswing~google-hotels-scraper/runs": { "post": { "operationId": "runs-sync-glasswing-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/glasswing~google-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-glasswing-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", "uniqueItems": true, "type": "array", "description": "Cities, areas or landmarks as you would type them into Google Hotels, one per line (for example `Lisbon`, `hotels near Times Square`, `Kyoto ryokan`). Each destination is one search; Maximum results is split evenly across them.", "default": [ "Lisbon" ], "items": { "type": "string" } }, "checkInDate": { "title": "Check-in date", "type": "string", "description": "YYYY-MM-DD. Leave empty for 14 days from today." }, "checkOutDate": { "title": "Check-out date", "type": "string", "description": "YYYY-MM-DD, after check-in, at most 30 nights later. Leave empty for check-in + 2 nights." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 12, "type": "integer", "description": "Number of adult guests (1-12).", "default": 2 }, "childrenAges": { "title": "Children's ages", "type": "array", "description": "One age (0-17) per child, for example `[8, 12]`. Leave empty for no children.", "default": [] }, "currency": { "title": "Currency", "type": "string", "description": "Three-letter currency code for all prices (USD, EUR, GBP, JPY ...).", "default": "USD" }, "country": { "title": "Country (Google market)", "type": "string", "description": "Two-letter country code of the Google market you search from (us, gb, de, in ...). It affects which booking sites and prices Google shows.", "default": "us" }, "propertyType": { "title": "Property type", "enum": [ "all", "hotels", "vacationRentals" ], "type": "string", "description": "Google Hotels mixes hotels and vacation rentals. Keep both, or only one kind.", "default": "all" }, "minHotelClass": { "title": "Minimum hotel class", "minimum": 0, "maximum": 5, "type": "integer", "description": "Only keep hotels with at least this many stars (2-5). 0 keeps everything, including unrated properties.", "default": 0 }, "includeProviderPrices": { "title": "Include every booking site's price", "type": "boolean", "description": "Also open each property's prices page and add the nightly and total price from every booking site (Booking.com, Expedia, the hotel's own site ...) plus the cheapest one. One extra page per property, so runs take longer; the price per result stays the same.", "default": false }, "startUrls": { "title": "Google Hotels URLs", "uniqueItems": true, "type": "array", "description": "Optional: Google Hotels search URLs copied from your browser (google.com/travel/search?...). The URL's own dates and guests are used when it has them. The prefilled example only runs when Destinations is empty.", "default": [ "https://www.google.com/travel/search?q=hotels%20in%20Barcelona" ], "items": { "type": "string" } }, "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Stop after this many properties have been saved. Each saved property with status `ok` is one billable result.", "default": 20 } } }, "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 } } } } } } } } } }