{ "openapi": "3.0.1", "info": { "title": "Google Hotels Scraper & Price Tracker: Rates & Ratings", "description": "Scrape Google Hotels for any city: hotel prices for your dates (per night, with taxes), star class, rating, reviews, location, photos and links. Hotel price tracker: schedule it with Only price drops for an alert when a hotel gets cheaper. Rating, class and price filters. $1 per 1,000 hotels.", "version": "1.0", "x-build-id": "NPaQp1VmYcmSQW9qJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automationnation~google-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automationnation-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/automationnation~google-hotels-scraper/runs": { "post": { "operationId": "runs-sync-automationnation-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/automationnation~google-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-automationnation-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 or searches", "type": "array", "description": "Cities, areas or full searches, one per line: Paris, Shoreditch London, hotels near Times Square, 4 star hotels in Rome. Each line is one Google Hotels search (up to 20 hotels).", "default": [ "Paris" ], "items": { "type": "string" } }, "checkIn": { "title": "Check-in date", "type": "string", "description": "YYYY-MM-DD. Set check-in and check-out for exact prices; without them Google picks dates and the rows say which." }, "checkOut": { "title": "Check-out date", "type": "string", "description": "YYYY-MM-DD." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 12, "type": "integer", "description": "Guests per room.", "default": 2 }, "maxHotelsPerSearch": { "title": "Max hotels per search", "minimum": 1, "maximum": 20, "type": "integer", "description": "Google shows up to 20 hotels per search; add more specific searches (areas, star ratings) for more.", "default": 20 }, "minRating": { "title": "Minimum rating", "enum": [ "0", "3.5", "4", "4.5" ], "type": "string", "description": "Only hotels rated at least this.", "default": "0" }, "minHotelClass": { "title": "Minimum hotel class", "enum": [ "0", "2", "3", "4", "5" ], "type": "string", "description": "Only hotels with at least this many stars.", "default": "0" }, "maxPricePerNight": { "title": "Max price per night", "minimum": 0, "type": "integer", "description": "Only hotels at or under this nightly price, in the results' currency." }, "country": { "title": "Google country", "type": "string", "description": "Two-letter country code for Google (gl), e.g. us, gb, de. It can change currency and partner prices.", "default": "us" }, "currency": { "title": "Currency", "type": "string", "description": "Optional three-letter currency code (USD, EUR, GBP). Google may still answer in the currency of the search location." }, "onlyPriceDrops": { "title": "Only price drops", "type": "boolean", "description": "For scheduled runs: save a hotel only when its nightly price is lower than the last price seen for it, with that previous price on the row. The first run saves every hotel and records the prices; a run with no drops saves nothing and costs almost nothing.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Optional. Keeps a separate price history under this name, e.g. one per trip or client watching the same city." } } }, "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 } } } } } } } } } }