{ "openapi": "3.0.1", "info": { "title": "Airbnb Reviews Scraper: Text, Ratings, Host Replies", "description": "Scrape Airbnb guest reviews from listing URLs or IDs: text, original language and English translation, date, stars, stay type and host response. Filter by date and language, sort by rating. $0.50 per 1,000 reviews.", "version": "0.1", "x-build-id": "xXTxm8fwLnNsDYIdS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thelastscraper~airbnb-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thelastscraper-airbnb-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/thelastscraper~airbnb-reviews/runs": { "post": { "operationId": "runs-sync-thelastscraper-airbnb-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/thelastscraper~airbnb-reviews/run-sync": { "post": { "operationId": "run-sync-thelastscraper-airbnb-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": { "actorVariant": { "title": "Actor variant", "type": "string", "description": "Internal: which Store Actor this is (do not change).", "default": "reviews" }, "where": { "title": "Listings: Airbnb listing URLs or IDs", "type": "array", "description": "One per line: a listing URL (https://www.airbnb.com/rooms/123, any Airbnb domain) or a listing ID.", "items": { "type": "string" } }, "maxReviewsPerListing": { "title": "Max reviews per listing", "minimum": 0, "type": "integer", "description": "0 = all reviews. Each review is charged, so a cap keeps the cost of listings with hundreds of reviews predictable.", "default": 100 }, "sort": { "title": "Order", "enum": [ "most_recent", "highest_rated", "lowest_rated" ], "type": "string", "description": "Most recent first is how Airbnb serves reviews. Highest or lowest rated reads all of a listing's reviews (or all since the date below) and sorts them, so it takes longer on listings with many reviews.", "default": "most_recent" }, "sinceDate": { "title": "Only reviews since", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "YYYY-MM-DD. Only reviews written on or after this date; the Actor stops reading older pages, so it is faster and cheaper. Empty = no date limit." }, "reviewLanguages": { "title": "Only these languages", "type": "array", "description": "2-letter codes of the review's original language, e.g. en, es, fr, ar. Empty = all languages. Every review keeps its original text and, when Airbnb provides it, the English translation.", "items": { "type": "string" } }, "omitPersonalData": { "title": "Omit personal data", "type": "boolean", "description": "Set reviewer names, photos and profile links to null (GDPR-friendly). What stays: the numeric reviewer id, the reviewer's location label, date, rating, language, and the review and host-response text as written (free text can still contain names).", "default": false }, "maxListings": { "title": "Max listings", "minimum": 0, "type": "integer", "description": "Stop after this many listings. 0 = all the listings you gave.", "default": 0 }, "proxyStrategy": { "title": "Proxy strategy", "enum": [ "auto", "datacenter", "residential" ], "type": "string", "description": "Auto (recommended): starts with Apify datacenter proxies and switches to residential proxies only if Airbnb starts blocking (2 blocks in the last 50 requests: a request blocked on 2 datacenter IPs makes its third attempt through residential); after 300 clean requests on residential it tries datacenter once more. If residential proxies are not available to the run, it slows down instead. Datacenter / Residential: always that kind. Proxy traffic is not billed to you separately: the event prices include it. The log, the status message and the OUTPUT record show requests, blocks and estimated traffic per proxy level.", "default": "auto" }, "proxyCountry": { "title": "Residential proxy country", "pattern": "^([A-Za-z]{2})?$", "type": "string", "description": "Optional 2-letter country code (e.g. US, AE) for residential proxies. Empty = any country." }, "maxConcurrency": { "title": "Parallel listings", "minimum": 20, "maximum": 32, "type": "integer", "description": "Listings scraped at the same time, each through its own Apify Proxy IP with its own pause (a listing's price quote, policies and calendar are requested together with its page, as a browser loads it). 20 to 32; the default, 32, scrapes about 5 listings a second with the default 4 GB of memory. The minimum keeps a run's duration, which the event prices include, bounded. With your own proxy URLs or without a proxy (one IP), the pause is shared and more parallel listings are not faster.", "default": 32 }, "delaySeconds": { "title": "Pause between requests", "minimum": 1, "maximum": 2, "type": "integer", "description": "Minimum seconds between two requests from the same IP (plus up to 1 s of random jitter); a listing's quote, policies and calendar go out with its page. 1 (the default, the fastest) or 2. If Airbnb blocks, the Actor slows down and changes proxies by itself.", "default": 1 }, "maxRequests": { "title": "Max requests to Airbnb", "minimum": 0, "type": "integer", "description": "Hard cap on requests to airbnb.com for the whole run (retries included). 0 = no cap.", "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 } } } } } } } } } }