{ "openapi": "3.0.1", "info": { "title": "Google Hotels Scraper: Prices, Rates, Phone & Email by City/ZIP", "description": "Every hotel Google Hotels lists in a city, ZIP code, county or near a landmark, priced for your dates: stars, rating, phone, street address, website and the hotel's own email. Booking-site rates on request.", "version": "0.0", "x-build-id": "zJucyz2JPEiR6r5qT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapebench~google-hotels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapebench-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/scrapebench~google-hotels-scraper/runs": { "post": { "operationId": "runs-sync-scrapebench-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/scrapebench~google-hotels-scraper/run-sync": { "post": { "operationId": "run-sync-scrapebench-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": { "queries": { "title": "Places", "type": "array", "description": "Where to look, one per line: a city (San Francisco, CA), a ZIP code (89501), a county (Washoe County, NV), a region (Lake Tahoe), a landmark (near Moscone Center) or a hotel's name. Each place is searched on its own and a hotel found twice is returned and charged once.", "default": [], "items": { "type": "string" } }, "query": { "title": "Place (single)", "type": "string", "description": "One place, for saved tasks and API calls that send a single value. Use Places above for several." }, "checkIn": { "title": "Check-in date", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "YYYY-MM-DD. Prices are for this stay. Empty means 14 days from today. A date in the past moves to tomorrow (same number of nights) instead of failing the run, and a free row says so." }, "checkOut": { "title": "Check-out date", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "YYYY-MM-DD. Empty means check-in plus the number of nights below." }, "nights": { "title": "Nights", "minimum": 1, "maximum": 30, "type": "integer", "description": "Length of the stay when no check-out date is given (up to 30).", "default": 1 }, "propertyType": { "title": "Property type", "enum": [ "hotels", "vacation_rentals", "all" ], "type": "string", "description": "Google mixes hotels and vacation rentals in its results. Hotels includes motels, inns and resorts.", "default": "hotels" }, "maxResults": { "title": "Maximum properties per place", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap for EACH place. Google lists up to a few hundred per city; a whole state stops around 600, so split a state into counties or cities.", "default": 100 }, "includeDetails": { "title": "Phone and address for every hotel", "type": "boolean", "description": "On by default: reads each hotel's own Google page for its street address and phone. Google's search list carries a phone only for the first ~18 hotels. No extra charge; turn off for a faster run with prices only.", "default": true }, "includeEmails": { "title": "Look up each hotel's email (extra charge)", "type": "boolean", "description": "On by default: visits each hotel's own website and returns the email published there. Charged separately, only for hotels where one is found. Chain brand sites (Marriott, Hilton, Hyatt...) publish no property email and are skipped.", "default": true }, "includeOffers": { "title": "Booking-site rates (extra charge)", "type": "boolean", "description": "Off by default: adds every booking site's price for the stay (Booking.com, Expedia, Hotels.com, the hotel's own site...) with a link, from each hotel's Google page. Charged per hotel that has rates.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Off by default, which is how this actor was tested. If a run comes back with a 'blocked' row, turn on a proxy (residential works). Included in the price.", "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 } } } } } } } } } }