{ "openapi": "3.0.1", "info": { "title": "Google Hotels Scraper", "description": "Google Hotels scraper: hotel prices for any city and dates, prices from every booking site (Booking.com, Expedia, Agoda, official site), rating, reviews, class, amenities, photos. Price calendar for any hotel. Fast HTTP, no browser.", "version": "0.0", "x-build-id": "LVtKM0pAf1qofX6m8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/d_nepoch~google-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-d_nepoch-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/d_nepoch~google-hotels-scraper/runs": { "post": { "operationId": "runs-sync-d_nepoch-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/d_nepoch~google-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-d_nepoch-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", "properties": { "searchQueries": { "title": "Searches", "type": "array", "description": "What you would type into Google Hotels, e.g. 'hotels in Lisbon', 'resorts in Bali', 'hotels near Times Square'. Each search is scraped separately.", "items": { "type": "string" } }, "hotelUrls": { "title": "Hotel URLs (price tracking)", "type": "array", "description": "Google Hotels hotel pages (https://www.google.com/travel/hotels/entity/...). For each hotel and date range you get prices from every booking site. Combine with 'Consecutive check-in dates' for a price calendar.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "checkInDate": { "title": "Check-in date", "type": "string", "description": "YYYY-MM-DD. Default: 7 days from today." }, "checkOutDate": { "title": "Check-out date", "type": "string", "description": "YYYY-MM-DD. Leave empty to use 'Nights'." }, "nights": { "title": "Nights", "minimum": 1, "maximum": 30, "type": "integer", "description": "Length of stay when no check-out date is set.", "default": 1 }, "consecutiveDates": { "title": "Consecutive check-in dates", "minimum": 1, "maximum": 90, "type": "integer", "description": "Repeat everything for this many check-in days in a row (same length of stay). Example: 30 = a 30-day price calendar.", "default": 1 }, "adults": { "title": "Adults", "minimum": 1, "maximum": 12, "type": "integer", "description": "Number of adult guests. Prices are for the whole party.", "default": 2 }, "currency": { "title": "Currency", "type": "string", "description": "Three-letter code: USD, EUR, GBP, JPY, TRY, ...", "default": "USD" }, "country": { "title": "Country (Google market)", "type": "string", "description": "Two-letter code of the Google market (gl), e.g. us, gb, de. Some booking sites and prices depend on it.", "default": "us" }, "language": { "title": "Language", "type": "string", "description": "Language of hotel descriptions and labels (hl), e.g. en, de, fr, es.", "default": "en" }, "maxHotelsPerSearch": { "title": "Max hotels per search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Per search and per date range. Google shows 20 hotels per page.", "default": 50 }, "includeOffers": { "title": "Include prices from every booking site", "type": "boolean", "description": "Open each hotel's page to get all offers (Booking.com, Expedia, Agoda, official site, ...) with room types, free cancellation, address and phone. Charged as 'hotel with prices'.", "default": false }, "minRating": { "title": "Min guest rating", "enum": [ "0", "3.5", "4", "4.5" ], "type": "string", "description": "Filtered hotels are not charged.", "default": "0" }, "minHotelClass": { "title": "Min hotel class (stars)", "minimum": 0, "maximum": 5, "type": "integer", "description": "0 = any. Vacation rentals have no class and are skipped when this is set. Filtered hotels are not charged.", "default": 0 }, "minPricePerNight": { "title": "Min price per night", "minimum": 0, "type": "integer", "description": "In the selected currency. Filtered hotels are not charged." }, "maxPricePerNight": { "title": "Max price per night", "minimum": 0, "type": "integer", "description": "In the selected currency. Filtered hotels are not charged." }, "hotelsOnly": { "title": "Hotels only (no vacation rentals)", "type": "boolean", "description": "Skip apartments and other vacation rentals. Filtered results are not charged.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify datacenter proxy (default) is recommended: the Actor rotates IPs automatically when Google slows down or blocks one.", "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 } } } } } } } } } }