{
"openapi": "3.0.1",
"info": {
"title": "Google Hotels Scraper - Prices, Booking Sites & Reviews",
"description": "Google Hotels API alternative: hotels in any city with live prices, every booking site's rate (Booking.com, Expedia, Agoda, official site) across a date range, room rates, free-cancellation deadlines and guest reviews. Rate parity and hotel price monitoring. From $1.50 per 1,000.",
"version": "0.1",
"x-build-id": "vr0fQUFnBDblvM14N"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/alom~google-hotels-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-alom-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/alom~google-hotels-scraper/runs": {
"post": {
"operationId": "runs-sync-alom-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/alom~google-hotels-scraper/run-sync": {
"post": {
"operationId": "run-sync-alom-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": {
"mode": {
"title": "What to scrape",
"enum": [
"search",
"hotelPrices",
"reviews"
],
"type": "string",
"description": "Search: one row per hotel for a destination. Hotel prices: one row per hotel x check-in date x booking site (Booking.com, Expedia, the official site...). Reviews: one row per guest review of the hotels you list (Google reviews plus Tripadvisor / TrustYou reviews shown on Google).",
"default": "search"
},
"searchQueries": {
"title": "Search queries",
"type": "array",
"description": "For search mode. Anything you would type into Google Hotels: hotels in Paris, Lisbon, resorts in Cancun, hotels near Times Square.",
"items": {
"type": "string"
}
},
"maxResults": {
"title": "Max hotels per query",
"minimum": 1,
"maximum": 2000,
"type": "integer",
"description": "Stop after this many hotels per search query. Google's list for a big city runs into the hundreds.",
"default": 100
},
"sortBy": {
"title": "Sort by",
"enum": [
"relevance",
"lowest_price",
"highest_rating",
"most_reviewed"
],
"type": "string",
"description": "Order of search results.",
"default": "relevance"
},
"minPrice": {
"title": "Min price per night",
"minimum": 0,
"type": "integer",
"description": "In the chosen currency. Hotels without a price are left out when a price filter is set."
},
"maxPrice": {
"title": "Max price per night",
"minimum": 0,
"type": "integer",
"description": "In the chosen currency."
},
"minRating": {
"title": "Min guest rating",
"enum": [
"3.5",
"4",
"4.5"
],
"type": "string",
"description": "Only hotels rated at least this (1-5)."
},
"hotelClass": {
"title": "Hotel class (stars)",
"type": "array",
"description": "Only hotels with these star ratings.",
"items": {
"type": "string",
"enum": [
"1",
"2",
"3",
"4",
"5"
],
"enumTitles": [
"1 star",
"2 stars",
"3 stars",
"4 stars",
"5 stars"
]
}
},
"amenities": {
"title": "Amenities",
"type": "array",
"description": "Only hotels with all of these (filtered by Google).",
"items": {
"type": "string",
"enum": [
"free_wifi",
"free_breakfast",
"free_parking",
"pool",
"indoor_pool",
"outdoor_pool",
"fitness_center",
"spa",
"restaurant",
"bar",
"room_service",
"kid_friendly",
"pet_friendly",
"beach_access",
"air_conditioned",
"wheelchair_accessible",
"all_inclusive",
"ev_charger"
],
"enumTitles": [
"Free Wi-Fi",
"Free breakfast",
"Free parking",
"Pool",
"Indoor pool",
"Outdoor pool",
"Fitness center",
"Spa",
"Restaurant",
"Bar",
"Room service",
"Kid-friendly",
"Pet-friendly",
"Beach access",
"Air conditioning",
"Wheelchair accessible",
"All-inclusive",
"EV charger"
]
}
},
"freeCancellation": {
"title": "Free cancellation only",
"type": "boolean",
"description": "Only hotels with a free-cancellation offer.",
"default": false
},
"includeVacationRentals": {
"title": "Include vacation rentals",
"type": "boolean",
"description": "Google mixes apartments and holiday homes into hotel results. Turn off for hotels only.",
"default": true
},
"onlyDeals": {
"title": "Only hotels with a deal",
"type": "boolean",
"description": "Google's Special offers filter: only hotels with a deal for your dates (e.g. \"22% less than usual\", in dealLabel).",
"default": false
},
"maxImages": {
"title": "Photos per hotel",
"minimum": 0,
"maximum": 100,
"type": "integer",
"description": "Photo URLs per hotel (1024 px). Search cards carry ~9; with booking-site prices or in hotel-prices mode the full gallery (hotel, guest and booking-site photos, often 20+) is available.",
"default": 5
},
"includeProviderPrices": {
"title": "Add every booking site's price to each hotel",
"type": "boolean",
"description": "Adds offers to each hotel row: price per booking site (Booking.com, Expedia, official site...) with booking links. One extra request per hotel; still billed as one result.",
"default": false
},
"hotels": {
"title": "Hotels",
"type": "array",
"description": "For hotel prices and reviews modes. Google Hotels links (google.com/travel/hotels/entity/...), entity tokens (ChcI..., from the entityToken field of a search), or hotel names with the city (Hilton Paris Opera). Names are only accepted when Google finds a confident match.",
"items": {
"type": "string"
}
},
"lastCheckInDate": {
"title": "Last check-in date (price calendar)",
"pattern": "^(\\d{4}-\\d{2}-\\d{2}|today|tomorrow|\\+\\d{1,3})$",
"type": "string",
"description": "Price every check-in date from Check-in date to this one (inclusive), e.g. 30 days of prices. Same formats as Check-in date."
},
"checkInDates": {
"title": "Specific check-in dates",
"type": "array",
"description": "Alternative to a range: a list of check-in dates (2026-12-24, +30). Past dates are skipped with a warning, so a scheduled run keeps working.",
"items": {
"type": "string"
}
},
"providers": {
"title": "Only these booking sites",
"type": "array",
"description": "Optional. Keep only offers whose site name contains one of these (booking.com, expedia). official = the hotel's own website.",
"items": {
"type": "string"
}
},
"includeRoomRates": {
"title": "Room types & rates",
"type": "boolean",
"description": "Adds roomRates to the offers of Google's featured booking sites (usually 3-5 per hotel, e.g. Booking.com, Expedia): every room type x rate with price, free cancellation (+ deadline), breakfast included and max guests. No extra requests; rows get larger. Every offer always carries freeCancellation as Google states it.",
"default": false
},
"includeReviews": {
"title": "Include guest reviews",
"type": "boolean",
"description": "Also fetch guest reviews for every hotel delivered (search and hotel-prices modes; mode Reviews always does). Each review is its own row (type: review): text, rating, date, source (Google, Tripadvisor...), trip type / travel group, room/service/location sub-ratings and the hotel's response. Charged per review.",
"default": false
},
"maxReviews": {
"title": "Max reviews per hotel",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Stop after this many reviews per hotel (100 per request).",
"default": 50
},
"reviewsSort": {
"title": "Review order",
"enum": [
"newest",
"relevance",
"highest",
"lowest"
],
"type": "string",
"description": "Which reviews come first (and are kept when capped by Max reviews).",
"default": "newest"
},
"checkInDate": {
"title": "Check-in date",
"pattern": "^(\\d{4}-\\d{2}-\\d{2}|today|tomorrow|\\+\\d{1,3})$",
"type": "string",
"description": "2026-11-10, or relative: +14 (14 days from today), today, tomorrow. Relative dates keep scheduled runs valid. Default: 7 days from today."
},
"checkOutDate": {
"title": "Check-out date",
"pattern": "^(\\d{4}-\\d{2}-\\d{2}|today|tomorrow|\\+\\d{1,3})$",
"type": "string",
"description": "Optional; otherwise check-in + Nights. Google allows stays of up to 30 nights."
},
"nights": {
"title": "Nights",
"minimum": 1,
"maximum": 30,
"type": "integer",
"description": "Length of stay when no check-out date is given (also for every date of a price calendar).",
"default": 1
},
"adults": {
"title": "Adults",
"minimum": 1,
"maximum": 12,
"type": "integer",
"description": "Adult guests.",
"default": 2
},
"childrenAges": {
"title": "Children's ages",
"type": "array",
"description": "One age (0-17) per child, e.g. [7, 12]. Fewer sites sell rooms for families, so expect fewer offers."
},
"rooms": {
"title": "Rooms",
"minimum": 1,
"maximum": 9,
"type": "integer",
"description": "Number of rooms.",
"default": 1
},
"currency": {
"title": "Currency",
"type": "string",
"description": "3-letter code: USD, EUR, GBP, JPY, INR, AUD...",
"default": "USD"
},
"country": {
"title": "Market (country of the visitor)",
"type": "string",
"description": "Google shows prices as seen from this country (e.g. US prices exclude taxes and add a with-taxes figure; EU prices include taxes; some sites only sell in some countries). US is fastest. Other countries use residential IPs there.",
"default": "US"
},
"deltaMode": {
"title": "Only changed prices (monitoring)",
"type": "boolean",
"description": "For scheduled runs: deliver only hotels / offers that are new or whose price changed since the previous run with the same monitor name, with the previous price. Unchanged prices are skipped and not charged.",
"default": false
},
"monitorName": {
"title": "Monitor name",
"type": "string",
"description": "Separate memory per monitor, e.g. paris-weekly. Default: default."
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "Parallel queries / hotels.",
"default": 4
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Leave the default: US datacenter proxies, or residential proxies in the chosen market's country. Explicit settings here are used as given.",
"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
}
}
}
}
}
}
}
}
}
}