{ "openapi": "3.0.1", "info": { "title": "Google Hotels Scraper: Prices, Ratings & Reviews", "description": "Scrape Google Hotels for any city and dates: nightly and total prices with taxes, deal insights, star class, ratings, review topics, nearby places and photos. Fast, reliable, verified dates, any currency.", "version": "0.1", "x-build-id": "XG6nxJgHiODd8pPyE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/senshiesr~google-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-senshiesr-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/senshiesr~google-hotels-scraper/runs": { "post": { "operationId": "runs-sync-senshiesr-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/senshiesr~google-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-senshiesr-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", "required": [ "locations" ], "properties": { "locations": { "title": "Locations", "type": "array", "description": "Cities, areas or landmarks, one per line, e.g. \"Paris\", \"Shibuya, Tokyo\", \"hotels near Eiffel Tower\". Be specific for ambiguous names (\"Springfield, Illinois\").", "items": { "type": "string" } }, "checkInDate": { "title": "Check-in date", "type": "string", "description": "YYYY-MM-DD. Defaults to 14 days from today." }, "checkOutDate": { "title": "Check-out date", "type": "string", "description": "YYYY-MM-DD. Defaults to the day after check-in. Stays of up to 30 nights." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 12, "type": "integer", "description": "Number of adult guests (prices are for this many guests).", "default": 2 }, "childrenAges": { "title": "Children (ages)", "type": "array", "description": "One age (0-17) per child, e.g. 5 and 12. Prices then include the children. Up to 6 children.", "items": { "type": "string" } }, "currency": { "title": "Currency", "enum": [ "USD", "EUR", "GBP", "CAD", "AUD", "JPY", "CNY", "INR", "AED", "SAR", "EGP", "TRY", "BRL", "MXN", "CHF", "SGD", "THB", "KRW", "ZAR" ], "type": "string", "description": "Currency for all prices.", "default": "USD" }, "maxHotelsPerLocation": { "title": "Max hotels per location", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Google shows hotels in the order it ranks them; about 15-20 per page.", "default": 100 }, "includeOffers": { "title": "Include prices from each booking site", "type": "boolean", "description": "Adds every booking site Google lists for the hotel (Booking.com, Expedia, Agoda, the hotel's own website...) with its price, perks like free cancellation, booking link and individual room offers. Loads one extra page per hotel, so it costs a bit more per hotel.", "default": false }, "minRating": { "title": "Minimum guest rating", "minimum": 1, "maximum": 5, "type": "number", "description": "Only output hotels rated at least this (1-5), e.g. 4." }, "hotelClasses": { "title": "Hotel star classes", "type": "array", "description": "Only output these star classes, e.g. 4 and 5. Leave empty for all.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] } }, "maxPricePerNight": { "title": "Max price per night", "minimum": 1, "type": "number", "description": "In the chosen currency, including taxes." }, "onlyHotels": { "title": "Hotels only", "type": "boolean", "description": "Skip hostels, B&Bs, apartments and other property types.", "default": false }, "onlyAvailable": { "title": "Only hotels with a price", "type": "boolean", "description": "Skip hotels that are sold out or have no price for your dates.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Usually not needed. If Google starts blocking runs, enable Apify Proxy.", "default": { "useApifyProxy": 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 } } } } } } } } } }