{
"openapi": "3.0.1",
"info": {
"title": "Booking Reviews Scraper",
"description": "[$1/1K reviews] Scrape Booking.com guest reviews for any hotel: score, title, liked and disliked text, stay date, guest country and traveller type, room, nights, hotel reply and photos. Up to 5,000 reviews per property, hundreds of hotels per run. No fee per run, no browser, no login.",
"version": "0.1",
"x-build-id": "u7Oikp81eapxvd4xl"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/lergassy~booking-reviews-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-lergassy-booking-reviews-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/lergassy~booking-reviews-scraper/runs": {
"post": {
"operationId": "runs-sync-lergassy-booking-reviews-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/lergassy~booking-reviews-scraper/run-sync": {
"post": {
"operationId": "run-sync-lergassy-booking-reviews-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": {
"hotelUrls": {
"title": "🏨 Booking.com hotel URLs or ids",
"type": "array",
"description": "One property per line: the hotel page as you see it on Booking.com, e.g. https://www.booking.com/hotel/id/the-magani-amp-spa.html, or the numeric hotel id. Hundreds of hotels in one run are fine — each is billed only for the reviews it returns.",
"items": {
"type": "string"
}
},
"maxReviewsPerHotel": {
"title": "💯 Reviews per hotel",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "How many reviews to take from each property, in the order chosen below. Booking.com serves 25 per page; up to 5,000 per hotel per run.",
"default": 25
},
"reviewsSortBy": {
"title": "↕️ Reviews order",
"enum": [
"most_relevant",
"newest",
"oldest",
"highest_score",
"lowest_score"
],
"type": "string",
"description": "Newest first is the right choice for monitoring; Lowest scores first surfaces complaints.",
"default": "newest"
},
"reviewsGuestType": {
"title": "👤 Reviewer type",
"enum": [
"ALL",
"FAMILIES",
"COUPLES",
"GROUP_OF_FRIENDS",
"SOLO_TRAVELLERS",
"BUSINESS_TRAVELLERS"
],
"type": "string",
"description": "Keep only reviews written by this kind of guest, as Booking.com's own filter does.",
"default": "ALL"
},
"reviewsLanguage": {
"title": "🌐 Reviews language",
"type": "string",
"description": "Two-letter code to keep only reviews written in that language, e.g. en, de, ru, id. Empty = all languages."
},
"language": {
"title": "Interface language",
"type": "string",
"description": "Booking.com locale for hotel names and labels: en-us, en-gb, de, fr, es, ru, id… Review texts stay in the language they were written in.",
"default": "en-us"
},
"currency": {
"title": "Currency",
"type": "string",
"description": "ISO code used when the hotel is looked up on Booking.com. Reviews carry no prices, so this rarely matters.",
"default": "USD"
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Apify datacenter proxies by default. If runs end with bot-check error rows, switch to Residential — a page of 25 reviews transfers about 30 KB.",
"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
}
}
}
}
}
}
}
}
}
}