{
"openapi": "3.0.1",
"info": {
"title": "Google Hotels Scraper – Prices, Providers, Ratings & Amenities",
"description": "Google Hotels scraper for any destination and dates: hotel list with nightly and total prices, price per booking provider (Booking.com, Expedia, hotel website...), star class, guest rating, reviews, amenities, location and photos. No login, no API key.",
"version": "1.0",
"x-build-id": "gW765c49OJJ28Co3u"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/openharvest~google-hotels-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-openharvest-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/openharvest~google-hotels-scraper/runs": {
"post": {
"operationId": "runs-sync-openharvest-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/openharvest~google-hotels-scraper/run-sync": {
"post": {
"operationId": "run-sync-openharvest-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": {
"destinations": {
"title": "Destinations",
"type": "array",
"description": "Cities, areas or free-text hotel searches, exactly as you would type them into Google Hotels. Plain place names get \"hotels in\" added automatically. Examples: Paris, Manhattan, New York, Times Square, New York, resorts in Bali.",
"items": {
"type": "string"
}
},
"checkInDate": {
"title": "Check-in date",
"type": "string",
"description": "Arrival date (YYYY-MM-DD). Leave empty for 14 days from today. Must be in the future."
},
"checkOutDate": {
"title": "Check-out date",
"type": "string",
"description": "Departure date (YYYY-MM-DD). Leave empty for a 2-night stay. Maximum 30 nights."
},
"adults": {
"title": "Adults",
"minimum": 1,
"maximum": 12,
"type": "integer",
"description": "Number of adult guests. Prices are for one room for this many adults.",
"default": 2
},
"maxHotelsPerDestination": {
"title": "Max hotels per destination",
"minimum": 1,
"maximum": 500,
"type": "integer",
"description": "How many hotels to return for each destination (Google shows about 18-20 per page; the Actor pages through the results). You pay per hotel, so this also caps your cost.",
"default": 20
},
"includeProviderPrices": {
"title": "Include prices from every booking provider",
"type": "boolean",
"description": "For each hotel, also return the full price comparison (Booking.com, Expedia, Agoda, Hotels.com, the hotel's own website, ...) with nightly and total price, room types and booking link. Needs one extra request per hotel and is charged as a separate, slightly higher event. Turn off for a faster, cheaper hotel list with Google's lowest price only.",
"default": true
},
"currency": {
"title": "Currency",
"enum": [
"USD",
"EUR",
"GBP",
"CAD",
"AUD",
"JPY",
"CHF",
"INR",
"BRL",
"MXN",
"TRY",
"AED",
"SGD",
"HKD",
"CNY",
"KRW",
"THB",
"SEK",
"NOK",
"DKK",
"PLN",
"ZAR",
"NZD"
],
"type": "string",
"description": "Currency for all prices (3-letter ISO code).",
"default": "USD"
},
"sortBy": {
"title": "Sort by",
"enum": [
"relevance",
"lowest_price",
"highest_rating",
"most_reviewed"
],
"type": "string",
"description": "Order of the results, same as the Google Hotels sort menu.",
"default": "relevance"
},
"hotelClass": {
"title": "Hotel class (stars)",
"type": "array",
"description": "Only hotels with these star ratings. Leave empty for all.",
"items": {
"type": "string",
"enum": [
"2",
"3",
"4",
"5"
],
"enumTitles": [
"2-star",
"3-star",
"4-star",
"5-star"
]
}
},
"minRating": {
"title": "Minimum guest rating",
"enum": [
"any",
"3.5",
"4.0",
"4.5"
],
"type": "string",
"description": "Only hotels with at least this guest rating (out of 5).",
"default": "any"
},
"freeCancellation": {
"title": "Free cancellation only",
"type": "boolean",
"description": "Only hotels that offer a rate with free cancellation.",
"default": false
},
"language": {
"title": "Language",
"type": "string",
"description": "Google interface language code for texts such as descriptions and room names, e.g. en, de, fr, es, ja.",
"default": "en"
},
"country": {
"title": "Country (market)",
"type": "string",
"description": "2-letter country code of the market you search from, e.g. us, gb, de. Booking providers and prices can differ by market.",
"default": "us"
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Usually not needed. Enable Apify Proxy only if you run very large jobs and see repeated HTTP 429 warnings.",
"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
}
}
}
}
}
}
}
}
}
}