{ "openapi": "3.0.1", "info": { "title": "Google Hotels Scraper - $1.50 / 1000 Hotels", "description": "Scrape Google Hotels as clean JSON: hotel and rental prices per night and total with taxes, rating, reviews, stars, amenities, deals, location and photos for any city and dates, plus every booking site's offer per hotel. No login. $1.50 per 1000 hotels.", "version": "0.1", "x-build-id": "j6hkJgSLstMrdchhn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapeunblocker~google-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapeunblocker-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/scrapeunblocker~google-hotels-scraper/runs": { "post": { "operationId": "runs-sync-scrapeunblocker-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/scrapeunblocker~google-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-scrapeunblocker-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": { "searches": { "title": "Searches", "type": "array", "description": "What to search on Google Hotels, one search per line: a city or area ('hotels in Paris', 'Lisbon'), a landmark ('hotels near Times Square') or a hotel name (that one hotel). Each search returns up to 'Max hotels per search' hotels and vacation rentals.", "items": { "type": "string" } }, "propertyTokens": { "title": "Property tokens", "type": "array", "description": "Optional. The propertyToken of hotels from earlier results: one item per hotel with every booking site's price (official site, Booking.com, Expedia...) and room rates for your dates. Clear the searches above if you only want these hotels.", "items": { "type": "string" } }, "checkIn": { "title": "Check-in date", "type": "string", "description": "YYYY-MM-DD. Set together with the check-out date. Leave both empty for Google's default dates (one night that Google picks)." }, "checkOut": { "title": "Check-out date", "type": "string", "description": "YYYY-MM-DD, after the check-in date. Stays of up to 30 nights, starting within 330 days." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of adults (1-10).", "default": 2 }, "children": { "title": "Children's ages", "pattern": "^[0-9, ]*$", "type": "string", "description": "Ages of the children, comma-separated, e.g. '7,10' (up to 6 children, ages 0-17). Leave empty for none.", "default": "" }, "currency": { "title": "Currency", "pattern": "^[A-Za-z]{3}$", "type": "string", "description": "Price currency as an ISO 4217 code, e.g. USD, EUR, GBP, JPY.", "default": "USD" }, "language": { "title": "Language", "pattern": "^[A-Za-z]{2,3}([-_][A-Za-z0-9]{2,4})?$", "type": "string", "description": "Language of names, amenities and price texts, e.g. 'en', 'de', 'fr', 'ja'.", "default": "en" }, "country": { "title": "Market", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "Market as an ISO-2 country code, e.g. 'us', 'gb', 'de'. Google lists the booking sites of this market.", "default": "us" }, "maxResultsPerSearch": { "title": "Max hotels per search", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many hotels to collect for each search (1-100). Google shows about 20 per results page; more are read page by page.", "default": 20 }, "includeOffers": { "title": "Add booking-site prices to each hotel", "type": "boolean", "description": "For every hotel found by a search, also fetch its booking options: the price on every booking site Google lists (official site, Booking.com, Expedia...) and the room rates. One extra call per hotel, charged as the hotel-offers event.", "default": false }, "concurrency": { "title": "Parallel calls", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many calls to run at the same time (1-5).", "default": 3 } } }, "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 } } } } } } } } } }