{ "openapi": "3.0.1", "info": { "title": "Google Hotels Scraper: Prices, Ratings & Reviews", "description": "Scrape Google Hotels for any city and dates: price per night and total with taxes, star class, rating, reviews, amenities, review topics, nearby places, photos and website. Up to 150 hotels per location, price monitoring for daily alerts. No login. Pay per hotel.", "version": "1.0", "x-build-id": "BRIQS9pWogQyfZcSq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fguiraud~google-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fguiraud-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/fguiraud~google-hotels-scraper/runs": { "post": { "operationId": "runs-sync-fguiraud-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/fguiraud~google-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-fguiraud-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": "Cities, neighborhoods, landmarks or full searches, one per line: 'Panama City, Panama', 'Paris 7th arrondissement', 'hotels near Times Square', 'resorts in Cancun'. Plain place names become 'hotels in '.", "items": { "type": "string" } }, "checkIn": { "title": "Check-in date", "type": "string", "description": "YYYY-MM-DD. Empty = 14 days from today. Google shows prices up to about 11 months ahead." }, "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.", "default": 1 }, "adults": { "title": "Adults", "minimum": 1, "maximum": 12, "type": "integer", "description": "Number of adult guests. Prices change with the number of guests.", "default": 2 }, "childrenAges": { "title": "Children ages", "type": "array", "description": "One age (0-17) per child, e.g. 5 and 9. Empty = no children.", "items": { "type": "string" } }, "currency": { "title": "Currency", "type": "string", "description": "3-letter currency code for prices: USD, EUR, GBP, MXN, BRL, INR...", "default": "USD" }, "maxHotelsPerLocation": { "title": "Max hotels per location", "minimum": 1, "maximum": 150, "type": "integer", "description": "Google shows about 20 hotels per search. Above 20, extra searches by hotel class and sort order are combined (duplicates removed) to reach up to about 100-150 hotels per location.", "default": 20 }, "hotelClass": { "title": "Hotel class (stars)", "type": "array", "description": "Only these star ratings. Empty = all.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] } }, "minRating": { "title": "Minimum guest rating", "enum": [ "any", "3.5", "4.0", "4.5" ], "type": "string", "description": "Only hotels with at least this Google rating.", "default": "any" }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "lowest_price", "highest_rating", "most_reviewed" ], "type": "string", "description": "Order Google uses for the results.", "default": "relevance" }, "monitorPrices": { "title": "Monitor price changes", "type": "boolean", "description": "Remember each hotel's price (in a key-value store named 'google-hotels-price-monitor' in your account) and add previousPricePerNight, priceChange, priceChangePercent and priceStatus (up, down, unchanged, new) compared with the previous run of the same search. Schedule the run daily to track prices.", "default": false }, "onlyPriceChanges": { "title": "Only hotels whose price changed", "type": "boolean", "description": "With price monitoring: return (and charge) only hotels that are new or whose price moved since the previous run.", "default": false }, "language": { "title": "Language", "type": "string", "description": "Google interface language (en, es, de, fr, pt...). Affects texts such as amenities and the hotel type.", "default": "en" }, "country": { "title": "Country (Google edition)", "type": "string", "description": "2-letter country of the Google edition (us, gb, mx, es...). Some prices and taxes depend on it.", "default": "us" }, "maxConcurrency": { "title": "Locations in parallel", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many locations are searched at the same time.", "default": 3 }, "failOnError": { "title": "Fail the run on errors", "type": "boolean", "description": "Mark the run as failed when an item fails or nothing is found. Useful for scheduled monitoring (Apify emails you on failed runs).", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy is used by default.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }