{
"openapi": "3.0.1",
"info": {
"title": "Google Hotels Scraper – Prices, Booking Sites, Reviews",
"description": "Scrape Google Hotels: price per night with and without taxes, every booking site's price and link (Booking.com, Expedia, official site), stars, ratings, reviews, amenities, photos and vacation rentals. All filters, any currency, dates relative to today so scheduled runs never break.",
"version": "1.0",
"x-build-id": "svmG5gUd1PnnkfwB7"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/brii3343~google-hotels-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-brii3343-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/brii3343~google-hotels-scraper/runs": {
"post": {
"operationId": "runs-sync-brii3343-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/brii3343~google-hotels-scraper/run-sync": {
"post": {
"operationId": "run-sync-brii3343-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",
"required": [
"locations"
],
"properties": {
"locations": {
"title": "Locations",
"type": "array",
"description": "Where to search, one per line: a city, an area, a landmark or any Google Hotels search, for example Rome, Manhattan, New York, hotels near Eiffel Tower, beach resorts in Cancun.",
"items": {
"type": "string"
}
},
"checkInDate": {
"title": "Check-in date",
"type": "string",
"description": "YYYY-MM-DD, or a number of days from today (for example 30), so scheduled runs never use a date in the past. Leave empty for 14 days from today.",
"default": ""
},
"checkOutDate": {
"title": "Check-out date",
"type": "string",
"description": "YYYY-MM-DD or a number of days from today. Leave empty to use the number of nights below.",
"default": ""
},
"nights": {
"title": "Nights",
"minimum": 1,
"maximum": 30,
"type": "integer",
"description": "Length of the stay when the check-out date is empty (1 to 30).",
"default": 2
},
"adults": {
"title": "Adults",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "Prices are for this many guests in one room or rental.",
"default": 2
},
"childrenAges": {
"title": "Children ages",
"type": "array",
"description": "One age (0 to 17) per child, for example 8 and 12 for two children.",
"default": [],
"items": {
"type": "string"
}
},
"currency": {
"title": "Currency",
"type": "string",
"description": "Three-letter currency code for all prices: USD, EUR, GBP, JPY...",
"default": "USD"
},
"maxHotelsPerLocation": {
"title": "Max results per location",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "How many hotels (or rentals) to return for each location, in Google's order. Google shows 20 per page; duplicates between pages are removed.",
"default": 50
},
"includeVendorPrices": {
"title": "Include prices from every booking site",
"type": "boolean",
"description": "For each hotel, also get the price offered by every booking site Google lists (Booking.com, Expedia, Hotels.com, Agoda, the official site...) with links, free-cancellation deadlines, the cheapest site, address, phone and Google Place ID. One extra request per hotel, charged as a separate event.",
"default": false
},
"propertyType": {
"title": "Property type",
"enum": [
"hotels",
"hotels_only",
"vacation_rentals"
],
"type": "string",
"description": "Hotels as Google shows them (Google mixes in some vacation rentals, marked vacation_rental), hotels only, or vacation rentals (apartments, houses, villas) with guests, bedrooms, bathrooms and cleaning fees.",
"default": "hotels"
},
"sortBy": {
"title": "Sort by",
"enum": [
"relevance",
"lowest_price",
"highest_rating",
"most_reviewed"
],
"type": "string",
"description": "Order of the results. Relevance is the order Google shows by default.",
"default": "relevance"
},
"minPrice": {
"title": "Min price per night",
"minimum": 0,
"type": "integer",
"description": "In the chosen currency."
},
"maxPrice": {
"title": "Max price per night",
"minimum": 0,
"type": "integer",
"description": "In the chosen currency."
},
"hotelClass": {
"title": "Hotel class (stars)",
"type": "array",
"description": "Only hotels with these star ratings. Empty = all.",
"items": {
"type": "string",
"enum": [
"2",
"3",
"4",
"5"
],
"enumTitles": [
"2 stars",
"3 stars",
"4 stars",
"5 stars"
]
},
"default": []
},
"minRating": {
"title": "Guest rating",
"enum": [
"any",
"3.5",
"4.0",
"4.5"
],
"type": "string",
"description": "Only properties with at least this average guest rating.",
"default": "any"
},
"amenities": {
"title": "Amenities",
"type": "array",
"description": "Only properties that have all of these.",
"items": {
"type": "string",
"enum": [
"free_wifi",
"free_breakfast",
"free_parking",
"parking",
"pool",
"indoor_pool",
"outdoor_pool",
"spa",
"fitness_center",
"restaurant",
"bar",
"room_service",
"kid_friendly",
"pet_friendly",
"air_conditioned",
"wheelchair_accessible",
"beach_access",
"all_inclusive",
"ev_charger"
],
"enumTitles": [
"Free Wi-Fi",
"Free breakfast",
"Free parking",
"Parking",
"Pool",
"Indoor pool",
"Outdoor pool",
"Spa",
"Fitness center",
"Restaurant",
"Bar",
"Room service",
"Kid-friendly",
"Pet-friendly",
"Air-conditioned",
"Wheelchair accessible",
"Beach access",
"All-inclusive available",
"EV charger"
]
},
"default": []
},
"freeCancellation": {
"title": "Free cancellation only",
"type": "boolean",
"description": "Only hotels that offer free cancellation for these dates.",
"default": false
},
"specialOffers": {
"title": "Special offers only",
"type": "boolean",
"description": "Only hotels with a special offer or deal for these dates.",
"default": false
},
"ecoCertified": {
"title": "Eco-certified only",
"type": "boolean",
"description": "Only hotels with an eco certification.",
"default": false
},
"language": {
"title": "Language",
"type": "string",
"description": "Google interface language code (en, es, de...). Changes descriptions and review topics; amenity names stay in English.",
"default": "en"
},
"country": {
"title": "Country",
"type": "string",
"description": "Two-letter country code of the user Google should assume (us, gb, de...). Booking sites and prices can change by country.",
"default": "us"
}
}
},
"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
}
}
}
}
}
}
}
}
}
}