{ "openapi": "3.0.1", "info": { "title": "Hotel Prices by Booking Site (Google Hotels)", "description": "Every hotel in a city with its price on each booking site: Booking.com, Expedia, Hotels.com, Agoda, Trip.com, the hotel's own site and more. Cheapest site, official price, rate parity. Pay per hotel.", "version": "0.0", "x-build-id": "oDPo9Gn9jVeaKbFIx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/b_danielstefan~hotel-prices-by-booking-site/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-b_danielstefan-hotel-prices-by-booking-site", "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/b_danielstefan~hotel-prices-by-booking-site/runs": { "post": { "operationId": "runs-sync-b_danielstefan-hotel-prices-by-booking-site", "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/b_danielstefan~hotel-prices-by-booking-site/run-sync": { "post": { "operationId": "run-sync-b_danielstefan-hotel-prices-by-booking-site", "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": { "queries": { "title": "Destinations", "type": "array", "description": "Cities, districts or free-text hotel searches, one per item, e.g. \"Lisbon\", \"4 star hotels in Rome\", \"hotels near Times Square\". Each hotel found is returned with its price on every booking site. Provide this or \"hotels\".", "items": { "type": "string" } }, "hotels": { "title": "Specific hotels", "type": "array", "description": "Optional. Specific hotels to price, instead of or in addition to destinations: a Google Hotels link (…/travel/hotels/entity/…) or a hotel name with its city, e.g. \"Czar Lisbon Hotel\".", "items": { "type": "string" } }, "checkIn": { "title": "Check-in date", "type": "string", "description": "Check-in date as YYYY-MM-DD. If empty or in the past, 14 days from today is used." }, "checkOut": { "title": "Check-out date", "type": "string", "description": "Check-out date as YYYY-MM-DD, after check-in. If empty, one night after check-in is used." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 12, "type": "integer", "description": "Number of adult guests (1–12). Prices change with occupancy.", "default": 2 }, "currency": { "title": "Currency", "type": "string", "description": "ISO 4217 currency code for all prices, e.g. USD, EUR, GBP.", "default": "USD" }, "maxHotelsPerQuery": { "title": "Max hotels per destination", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many hotels to price per destination (1–200). You are charged per hotel returned. Larger numbers take longer, so use 5–10 for a quick answer.", "default": 5 }, "hotelsOnly": { "title": "Hotels only", "type": "boolean", "description": "Skip vacation rentals, which usually have only one booking site.", "default": true }, "language": { "title": "Language", "type": "string", "description": "Google interface language (hl), e.g. en.", "default": "en" }, "country": { "title": "Country", "type": "string", "description": "Google country code (gl), e.g. us, gb, de. Affects which booking sites and prices are shown.", "default": "us" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Proxy settings. Apify Proxy is used by default; leave as is unless you need a specific proxy.", "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 } } } } } } } } } }