{ "openapi": "3.0.1", "info": { "title": "Google Hotels Scraper - Prices, Reviews & Hotel Leads", "description": "Scrape Google Hotels for prices, per-OTA price comparison, ratings, reviews, amenities, geo, deals and hotel contacts. Search or paste URLs, track prices with monitor mode. No browser, no API key. Independent tool, not affiliated with Google.", "version": "0.1", "x-build-id": "0ThuDNkEt9znTzUpb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~google-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-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/scrapesage~google-hotels-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-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/scrapesage~google-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Free-text Google Hotels searches — e.g. \"hotels in Austin\", \"5-star hotels Paris\", \"beachfront resorts Cancun\", \"Marriott Times Square New York\", \"pet friendly hotels Denver\". Each query returns the first page (~20 properties). For broad coverage, add several narrower queries (by neighborhood, brand, or star level).", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (optional)", "type": "array", "description": "Paste Google Hotels URLs directly — either a search results page (…/travel/search?q=…) or a single property page (…/travel/hotels/entity/…). Property URLs are always enriched with full details.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "checkInDate": { "title": "Check-in date", "type": "string", "description": "Check-in date in YYYY-MM-DD format. Leave both dates empty and the actor uses an upcoming 2-night stay (~3 weeks out) so the search price and the per-OTA detail prices line up. If you set one date, set the other too." }, "checkOutDate": { "title": "Check-out date", "type": "string", "description": "Check-out date in YYYY-MM-DD format." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 20, "type": "integer", "description": "Number of adult guests.", "default": 2 }, "children": { "title": "Children", "minimum": 0, "maximum": 20, "type": "integer", "description": "Number of children.", "default": 0 }, "maxResults": { "title": "Max hotels", "minimum": 0, "type": "integer", "description": "Maximum number of hotels to return across all queries (after de-duplication, filtering and sorting). Set 0 for no limit. Keep the default for fast, low-cost runs.", "default": 50 }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "lowest_price", "highest_rating", "most_reviewed" ], "type": "string", "description": "How to order the collected hotels before applying the Max hotels cap.", "default": "relevance" }, "includeDetails": { "title": "Include full details + price comparison", "type": "boolean", "description": "For each hotel, open its property page to add street address, phone, check-in/out times, coordinates, description, the full amenity list, the featured booking rates (official site + a top partner, each with nightly & taxes-included total) and Google's lowest 'from' price. One extra request per hotel.", "default": false }, "includeReviews": { "title": "Include guest reviews", "type": "boolean", "description": "Attach guest reviews (source, star rating, reviewer, date, text) to each hotel. One extra request per hotel.", "default": false }, "maxReviewsPerHotel": { "title": "Max reviews per hotel", "minimum": 0, "maximum": 50, "type": "integer", "description": "Cap the number of reviews attached to each hotel when \"Include guest reviews\" is on.", "default": 10 }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only keep hotels with a guest rating at or above this value (0–5)." }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Only keep hotels whose starting price is at or above this amount (in the selected currency)." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Only keep hotels whose starting price is at or below this amount (in the selected currency)." }, "hotelClasses": { "title": "Hotel classes (stars)", "type": "array", "description": "Only keep hotels of these star classes. Leave empty for all. (Vacation rentals have no star class and are excluded when this is set.)", "items": { "type": "string", "enum": [ "2", "3", "4", "5" ], "enumTitles": [ "2-star", "3-star", "4-star", "5-star" ] }, "default": [] }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Keep only these property types. Leave empty for all.", "items": { "type": "string", "enum": [ "hotel", "vacation_rental" ], "enumTitles": [ "Hotels", "Vacation rentals" ] }, "default": [] }, "currency": { "title": "Currency", "type": "string", "description": "3-letter currency code for prices (e.g. USD, EUR, GBP, CAD, AUD, SGD).", "default": "USD" }, "countryCode": { "title": "Country (market)", "type": "string", "description": "2-letter country code for the Google market (gl). Also pins the proxy to that country so prices come back in the local market's currency.", "default": "us" }, "languageCode": { "title": "Language", "type": "string", "description": "2-letter UI language code (hl), e.g. en, es, fr, de.", "default": "en" }, "monitorMode": { "title": "Monitor mode (only new & price-changed)", "type": "boolean", "description": "Remember hotels and prices between runs (keyed by Monitor key) and output only NEW hotels and ones whose price changed since the last run — ideal for price-drop alerts. Pair with Apify Schedules to run daily/hourly.", "default": false }, "monitorKey": { "title": "Monitor key", "type": "string", "description": "Names the saved state for monitor mode. Use a distinct key per saved search (e.g. \"austin-4star\") so different searches track independently.", "default": "default" }, "maxRetries": { "title": "Max retries per page", "minimum": 2, "maximum": 6, "type": "integer", "description": "How many times to retry a page on a fresh proxy IP when Google returns a temporary block or an empty \"loading\" shell.", "default": 4 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. The default uses Apify Proxy pinned to the selected country. For heavy or high-frequency use, switch to RESIDENTIAL for the best reliability.", "default": { "useApifyProxy": true } }, "urlsFromFile": { "title": "Import URLs from a file", "type": "string", "description": "Paste a list of URLs (one per line), OR one link to a .txt/.csv file, Google Sheet or Google Drive file containing them. Lets you import many Start URLs at once instead of typing each. Google Sheet/Drive share links are handled automatically." } } }, "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 } } }, "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 } } } } } } } } } }