{ "openapi": "3.0.1", "info": { "title": "Google Hotels Reviews Scraper", "description": "Scrape Google Hotels reviews from every source Google shows, including the hotel's own site. Just add hotel names, URLs or ids and get rating, Rooms, Service and Location scores, trip type, text, author and date. Sort, filter Google reviews by topic, or get only new ones. $1.60 per 1,000 reviews.", "version": "1.0", "x-build-id": "qzhCCAaQwIZ1g60Tm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/boncross~google-hotels-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-boncross-google-hotels-reviews", "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/boncross~google-hotels-reviews/runs": { "post": { "operationId": "runs-sync-boncross-google-hotels-reviews", "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/boncross~google-hotels-reviews/run-sync": { "post": { "operationId": "run-sync-boncross-google-hotels-reviews", "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": { "hotels": { "title": "Hotels", "type": "array", "description": "One hotel per entry: a Google Hotels URL (https://www.google.com/travel/hotels/entity/Ch…), a bare entity id (Ch…, as returned by the Google Hotels Search Scraper actor), or a hotel name with city (\"Four Seasons Hotel New York Downtown\", \"Raffles Singapore\").", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (bulk upload)", "type": "array", "description": "Google Hotels page addresses, with the option to load them in bulk from a file, a Google Sheet or a remote list. Use this when you have more links than you want to paste. Combined with anything in the list above.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxReviewsPerHotel": { "title": "Max reviews per hotel", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many reviews per hotel (100 per request; thousands are available for big hotels). With a rating, source or dedup filter the scan also stops after five requests in a row that keep no review, and at three times the requests the limit needs (at least 20).", "default": 100 }, "maxItems": { "title": "Maximum results for the whole run", "minimum": 0, "type": "integer", "description": "A run-wide ceiling across every target. The per-target limit above applies to each one separately, so ten targets at 50 each returns 500; set this to cap the total. Zero means no run-wide limit. Rows that report an input the actor could not resolve are not counted here and are never charged for.", "default": 0 }, "source": { "title": "Review source", "enum": [ "hotels", "maps" ], "type": "string", "description": "hotels returns every source Google Hotels shows (Google, Tripadvisor, Trip.com, Priceline, the hotel's site) with relative dates, topic and text filters and 100 reviews per request. maps returns Google reviews only, with exact timestamps, an edited flag, the owner's reply and the reviewer's photos.", "default": "hotels" }, "sort": { "title": "Sort", "enum": [ "helpful", "newest", "highest", "lowest" ], "type": "string", "description": "Google's own orderings. \"newest\" returns Google reviews only, as on the site.", "default": "helpful" }, "topic": { "title": "Topic filter", "type": "string", "description": "Only reviews Google tags with this topic, in any letter case, e.g. Service, Location, Breakfast, Cleanliness, Pool, Sleep, Family friendly, Bar or lounge. The available topics for a hotel are in the Price Panel actor's sentiment section.", "default": "" }, "search": { "title": "Search within reviews", "type": "string", "description": "Free-text search, as in the \"Search reviews\" box on Google Hotels.", "default": "" }, "sources": { "title": "Only these sources", "type": "array", "description": "Case-insensitive substrings, e.g. [\"Google\"], [\"Tripadvisor\", \"Trip.com\"]. Empty = all. Applied after fetching; you are not charged for filtered reviews.", "default": [], "items": { "type": "string" } }, "minRating": { "title": "Minimum rating", "minimum": 0, "type": "number", "description": "Drop reviews below this rating (on the review's own scale, usually 5). 0 = off.", "default": 0 }, "maxRating": { "title": "Maximum rating", "minimum": 0, "type": "number", "description": "Drop reviews above this rating. 0 = off. Use minRating/maxRating together with sort=lowest to pull complaints only.", "default": 0 }, "includeHotelInfo": { "title": "Include hotel summary on every review", "type": "boolean", "description": "Fetch the property page once per hotel and add hotelName, hotelRating, hotelReviewCount, hotelStars, hotelAddress, the star histogram and the sentiment-by-topic breakdown to each review. No extra charge.", "default": true }, "language": { "title": "Language", "type": "string", "description": "Google interface language code, e.g. en, ja, de. Google translates reviews into it (\"Translated by Google\" prefix) where it can.", "default": "en" }, "country": { "title": "Country", "type": "string", "description": "Google market code, e.g. us, jp, gb.", "default": "us" }, "dedupStoreName": { "title": "Only-new store", "type": "string", "description": "Name of a key-value store. When set, reviews already returned in earlier runs are skipped and not charged, so a scheduled run with sort newest gives you only what is new: with sort newest, a hotel's list stops at the first review an earlier run returned.", "default": "" }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 32, "type": "integer", "description": "How many requests run at once across the whole run. The default is the fastest level measured clean; lower it only if a run reports refusals or errors.", "default": 32 }, "delayMs": { "title": "Delay between requests (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Optional pause before each call, in milliseconds. 0 (the default) runs as fast as the parallel limit allows.", "default": 0 } } }, "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 } } } } } } } } } }