{ "openapi": "3.0.1", "info": { "title": "Google Hotels Price Tracker — Hotel Prices by City & Dates", "description": "Hotel prices from Google Hotels for any city, dates and number of guests: price per night and total, stars, rating, reviews, amenities, the cheapest booking site and its price on other sites. Run it again or on a schedule to get the price change since the last run. Currency of your choice. No login.", "version": "0.1", "x-build-id": "GWs9Li5n7Lv5WxdJh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/northbell~google-hotels-price-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-northbell-google-hotels-price-tracker", "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/northbell~google-hotels-price-tracker/runs": { "post": { "operationId": "runs-sync-northbell-google-hotels-price-tracker", "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/northbell~google-hotels-price-tracker/run-sync": { "post": { "operationId": "run-sync-northbell-google-hotels-price-tracker", "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": [ "searches" ], "properties": { "searches": { "title": "Searches", "type": "array", "description": "One search per entry. A plain city name (\"Paris\") is priced for a stay that starts 30 days from the run and lasts 2 nights, for the number of adults below. For fixed dates use an object: {\"city\": \"Lisbon\", \"checkIn\": \"2026-11-10\", \"checkOut\": \"2026-11-12\", \"adults\": 2}. Use fixed dates to track one stay over time. You can also write \"nights\" instead of checkOut, or a phrase such as \"boutique hotels in Kyoto\". Put all your searches in one run: the run-start fee is charged once. Up to 50 per run." }, "currency": { "title": "Currency", "enum": [ "AED", "ALL", "AMD", "ARS", "AUD", "AWG", "AZN", "BAM", "BGN", "BHD", "BMD", "BRL", "BSD", "BYN", "CAD", "CHF", "CLP", "CNY", "COP", "CRC", "CUP", "CZK", "DKK", "DOP", "DZD", "EGP", "EUR", "GBP", "GEL", "HKD", "HRK", "HUF", "IDR", "ILS", "INR", "IRR", "ISK", "JMD", "JOD", "JPY", "KRW", "KWD", "KZT", "LBP", "MAD", "MDL", "MKD", "MXN", "MYR", "NOK", "NZD", "OMR", "PAB", "PEN", "PHP", "PKR", "PLN", "QAR", "RON", "RSD", "RUB", "SAR", "SEK", "SGD", "THB", "TRY", "TWD", "UAH", "USD", "VND", "XPF", "ZAR" ], "type": "string", "description": "The currency prices are shown in. Google converts at its own rate. Every row carries the currency Google actually answered in; if it ever differs from this setting the summary row says so.", "default": "USD" }, "adults": { "title": "Adults (default)", "minimum": 1, "maximum": 10, "type": "integer", "description": "Guests per room for every search that does not set its own \"adults\". Google prices one room for this many adults, so from about 5 adults up only hotels with a room that sleeps everyone come back with a price (far fewer rows). For a big group, search 2 or 3 adults at a time.", "default": 2 }, "maxHotelsPerSearch": { "title": "Hotels per search", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many hotels with a price to return for each search. Each page of Google results holds about 20, and the Actor reads page after page until it has this many, Google runs out, or three pages in a row bring no new priced hotel. You pay per hotel returned.", "default": 50 }, "includeVacationRentals": { "title": "Include vacation rentals", "type": "boolean", "description": "Google mixes apartments and vacation rentals into its hotel lists. Off: hotels, hostels, guest houses and inns only. On: rentals too (their propertyType is \"vacation rental\").", "default": false }, "includePriceSources": { "title": "Read booking sites and address", "type": "boolean", "description": "On: one extra request per hotel adds the cheapest booking site (lowestPriceSite), the price on up to 10 sites (priceBySite) and the street address. Roughly 1.5 seconds per hotel. Off: much faster, and those three fields stay empty.", "default": 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 } } } } } } } } } }