{ "openapi": "3.0.1", "info": { "title": "Google Travel Hotel Rate Tracker - OTA Prices for Every Night", "description": "Track Google Travel hotel prices for many stay dates: give hotel URLs or names and check-in dates, get every booking site's offer per date with nightly price, stay total, cheapest-offer flag and gap vs the hotel's own site for rate shopping and parity checks. $1 per 1,000 offers; errors are free.", "version": "1.0", "x-build-id": "2nbkfyPcdp2sJtUSv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tenfoldfleet~google-travel-hotel-rate-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tenfoldfleet-google-travel-hotel-rate-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/tenfoldfleet~google-travel-hotel-rate-tracker/runs": { "post": { "operationId": "runs-sync-tenfoldfleet-google-travel-hotel-rate-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/tenfoldfleet~google-travel-hotel-rate-tracker/run-sync": { "post": { "operationId": "run-sync-tenfoldfleet-google-travel-hotel-rate-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": [ "hotels" ], "properties": { "hotels": { "title": "Hotels", "type": "array", "description": "One or more hotels. Best: the hotel's Google Travel URL (open the hotel on google.com/travel, copy the address bar: https://www.google.com/travel/hotels/entity/...) or its bare entity id starting with 'Ch'. The same hotel given twice is priced once. A hotel name such as 'Park Hyatt Tokyo' also works; it is checked against the hotel Google picks, and a weak match (a city, a chain or an unknown name) returns a free error row instead of the wrong hotel's prices.", "items": { "type": "string" } }, "startDate": { "title": "First check-in date", "type": "string", "description": "First check-in date as YYYY-MM-DD. Empty = tomorrow (UTC). Ignored when 'Exact check-in dates' is filled in." }, "days": { "title": "Number of check-in dates", "minimum": 1, "maximum": 180, "type": "integer", "description": "How many consecutive check-in dates to price, starting at the first check-in date (14 = two weeks of stays). Google prices stays up to about 11 months ahead.", "default": 14 }, "dates": { "title": "Exact check-in dates (optional)", "type": "array", "description": "A list of check-in dates as YYYY-MM-DD, e.g. every Friday or the nights of an event. When filled in, it replaces 'First check-in date' and 'Number of check-in dates'.", "items": { "type": "string" } }, "nights": { "title": "Nights per stay", "minimum": 1, "maximum": 30, "type": "integer", "description": "Length of each stay. Check-out = check-in + this many nights. Prices are for 2 adults (Google's default occupancy).", "default": 1 }, "currency": { "title": "Currency", "type": "string", "description": "3-letter currency code for all prices, e.g. USD, EUR, GBP, JPY, AUD.", "default": "USD" }, "maxOffersPerDate": { "title": "Max offers per date", "minimum": 0, "maximum": 100, "type": "integer", "description": "Keep only the N cheapest booking-site offers per hotel and date (0 = all offers, usually 15-30). Each kept offer is one charged row, so this caps the cost. On the Apify free plan, the $5 monthly credit covers about 4,900 offers (roughly 250 hotel-dates with all offers).", "default": 0 }, "maxConcurrency": { "title": "Max parallel requests", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many Google pages to load at once.", "default": 10 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Not needed: the Actor goes direct and falls back to Apify's datacenter proxy by itself. Google shows the booking sites of the country the request comes from (the USA by default), so pick a proxy country here to see another market's offers.", "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 } } } } } } } } } }