{ "openapi": "3.0.1", "info": { "title": "Airbnb Reviews Scraper: Host Replies, Only New, $3.50/1,000", "description": "Get every review of any Airbnb listing: stars, text, date, reviewer, the host's reply and translations. Sort by newest, most relevant, highest or lowest rating. Turn on \"only new reviews\" to get just the reviews posted since your last run. No login.", "version": "0.1", "x-build-id": "i2HnnUvkVC1Axl7kM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/trueline-data~airbnb-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-trueline-data-airbnb-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/trueline-data~airbnb-reviews-scraper/runs": { "post": { "operationId": "runs-sync-trueline-data-airbnb-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/trueline-data~airbnb-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-trueline-data-airbnb-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", "required": [ "listings" ], "properties": { "listings": { "title": "Listings", "type": "array", "description": "Airbnb listing URLs (airbnb.com/rooms/…, any country's Airbnb site) or listing numbers.", "items": { "type": "string" } }, "maxReviews": { "title": "Max reviews per listing", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many reviews for each listing.", "default": 100 }, "sortBy": { "title": "Sort", "enum": [ "newest", "relevant", "highest", "lowest" ], "type": "string", "description": "The order Airbnb gives the reviews in.", "default": "newest" }, "newerThan": { "title": "Only reviews since", "type": "string", "description": "Optional. Keep only reviews posted on or after this date, such as 2026-01-31." }, "includeListingDetails": { "title": "Include listing details", "type": "boolean", "description": "One free row per listing: name, location, rating, review count, room type, guests, superhost and the review topics guests mention most.", "default": true }, "language": { "title": "Language", "type": "string", "description": "Language code such as en, es, de, fr. Reviews written in another language also come with Airbnb's translation into this one.", "default": "en" }, "onlyNew": { "title": "Only new reviews", "type": "boolean", "description": "Skip every review an earlier run of yours already returned (not charged). Use it with a schedule to get only fresh reviews.", "default": false }, "historyName": { "title": "History name", "type": "string", "description": "Where \"Only new reviews\" keeps the reviews it has seen (a key-value store in your account). Use a different name for each separate feed.", "default": "airbnb-reviews-seen" }, "maxConcurrency": { "title": "Listings at the same time", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many listings to work on in parallel.", "default": 5 }, "queryId": { "title": "Airbnb query id (advanced)", "type": "string", "description": "Leave empty. Only if the run says Airbnb changed its review feed: paste the new 64-character StaysPdpReviewsQuery id here." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave as it is: the tool uses residential IPs for the review pages on its own, at no extra cost to you. Set a proxy here only to use your own.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }