{ "openapi": "3.0.1", "info": { "title": "Google Hotels Prices: Rates, Stars & Ratings by Date", "description": "Google Hotels prices in bulk: many destinations and check-in dates in one run. Each hotel has price, stars, rating, reviews and location, so you can compare cities or track rates over time. No scraping, no blocks, and you pay only for rows saved.", "version": "1.0", "x-build-id": "WfbkCWJZ7OnTOPQUE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ensorcelling_melilot~google-hotels/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ensorcelling_melilot-google-hotels", "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/ensorcelling_melilot~google-hotels/runs": { "post": { "operationId": "runs-sync-ensorcelling_melilot-google-hotels", "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/ensorcelling_melilot~google-hotels/run-sync": { "post": { "operationId": "run-sync-ensorcelling_melilot-google-hotels", "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": { "destinations": { "title": "Destinations", "type": "array", "description": "City and country, one per line: Lisbon, Portugal | Paris, France | Austin, Texas, United States. The last part is the country. Each is searched as 'hotels in ...' on Google Hotels. Up to 100 searches (destinations times dates) per run.", "items": { "type": "string" } }, "checkInDates": { "title": "Check-in dates", "type": "array", "description": "One per line, as YYYY-MM-DD (2026-12-20) or +N for N days from today (+30). Every destination is searched for every date, which makes rate tracking easy: run it on a schedule with the same dates. Empty means 30 days from today.", "items": { "type": "string" } }, "nights": { "title": "Nights", "minimum": 1, "maximum": 30, "type": "integer", "description": "Length of the stay in nights, 1 to 30. Google shows its rate for these dates.", "default": 2 }, "adults": { "title": "Adults", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of adult guests, 1 to 10. Rates depend on occupancy.", "default": 2 }, "currency": { "title": "Currency", "type": "string", "description": "Three-letter currency code for the prices, for example USD, EUR, GBP.", "default": "USD" }, "defaultCountry": { "title": "Country for destinations without one", "type": "string", "description": "Only used for a destination typed without a country (for example just Rome). Leave empty and always add the country: Google needs it to pick the right city, and there is a Paris in Texas." }, "languageCode": { "title": "Language code", "type": "string", "description": "Two-letter language of the results, for example en, de, fr, es.", "default": "en" }, "depth": { "title": "Hotels per search", "minimum": 10, "maximum": 100, "type": "integer", "description": "How many hotels to ask Google for per search, 10 to 100. Google returns about 20 at a time, so values above 20 may return fewer than asked. You are charged only for rows saved.", "default": 20 }, "maxResults": { "title": "Maximum hotels", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Stop after this many hotel rows. You are charged per row saved, so this is also your spending limit.", "default": 200 }, "minStars": { "title": "Minimum stars", "type": "string", "description": "Only hotels with at least this many stars, 1 to 5. Hotels without a star class are dropped when this is set. Leave empty for no minimum." }, "minRating": { "title": "Minimum guest rating", "type": "string", "description": "Only hotels rated at least this high by guests, on Google's 5-point scale, for example 4.2. Leave empty for no minimum." }, "maxPrice": { "title": "Maximum price", "type": "string", "description": "Only hotels priced at most this much, in the currency above, as Google shows it for your dates. Leave empty for no maximum." }, "nameContains": { "title": "Name contains", "type": "string", "description": "Only hotels whose name contains this text, for example Hilton or Hostel. Leave empty for all." }, "includeUnpriced": { "title": "Keep hotels with no price on these dates", "type": "boolean", "description": "Google lists some hotels without a rate when they are sold out. They are skipped (and not charged) unless you turn this on.", "default": 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 } } } } } } } } } }