{
"openapi": "3.0.1",
"info": {
"title": "Tripadvisor Reviews Scraper",
"description": "[$4/1K reviews, 20% below the leader, paid plans down to $0.72/1K] Scrape Tripadvisor reviews of hotels, restaurants and attractions: rating, title, text, review date, visit month, reviewer, photos, owner response with date. Filter by stars, traveller type, month. Only-new mode. No start fee.",
"version": "0.1",
"x-build-id": "E0mNV58dkJjzIMwAR"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/blueskyscraper~tripadvisor-reviews-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-blueskyscraper-tripadvisor-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/blueskyscraper~tripadvisor-reviews-scraper/runs": {
"post": {
"operationId": "runs-sync-blueskyscraper-tripadvisor-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/blueskyscraper~tripadvisor-reviews-scraper/run-sync": {
"post": {
"operationId": "run-sync-blueskyscraper-tripadvisor-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": {
"startUrls": {
"title": "🔗 Tripadvisor place URLs",
"type": "array",
"description": "Paste links to hotel, restaurant or attraction pages on Tripadvisor — open the place and copy the address from your browser. Any Tripadvisor domain works (.com, .co.uk, .de …). Example: https://www.tripadvisor.com/Hotel_Review-g297701-d610805-Reviews-The_Ubud_Village_Resort_Spa-Ubud_Gianyar_Regency_Bali.html",
"default": [
"https://www.tripadvisor.com/Hotel_Review-g297701-d610805-Reviews-The_Ubud_Village_Resort_Spa-Ubud_Gianyar_Regency_Bali.html"
],
"items": {
"type": "string"
}
},
"searchQueries": {
"title": "🔍 Place names to search",
"type": "array",
"description": "No link? Type the place name — Ayana Resort, Eiffel Tower, pizza restaurant — and set Search location below, or write it as Name, City (Ayana Resort, Bali). The Actor finds the place on Tripadvisor and collects its reviews. Sponsored listings are skipped.",
"items": {
"type": "string"
}
},
"searchLocation": {
"title": "📍 Search location",
"type": "string",
"description": "City, region or country to search the place names in: Bali, Ubud, Paris, France, New York City. Add the country after a comma when the city name exists in several countries."
},
"maxPlacesPerSearch": {
"title": "Places per search",
"minimum": 1,
"maximum": 30,
"type": "integer",
"description": "How many top Tripadvisor results to take for each place name. Keep 1 for a specific hotel or restaurant; raise it (up to 30) for a category search such as sushi restaurant.",
"default": 1
},
"maxReviewsPerPlace": {
"title": "💯 Max reviews per place",
"minimum": 1,
"maximum": 4490,
"type": "integer",
"description": "How many reviews to collect from each place (up to 4,490 — Tripadvisor's own limit through this source). With traveller types selected, the limit applies to each traveller type separately.",
"default": 20
},
"sortBy": {
"title": "Sort reviews by",
"enum": [
"most_recent",
"detailed_reviews",
"tripadvisor_default"
],
"type": "string",
"description": "Most recent returns the newest reviews first (needed for the minimum date and for monitoring). Detailed reviews puts the longest, most informative reviews first. Tripadvisor default keeps the site's own order.",
"default": "most_recent"
},
"minReviewDate": {
"title": "📅 Only reviews written on or after",
"type": "string",
"description": "Skip older reviews. Use a date 2026-01-01 or a relative period: 30 days, 6 months, 1 year. With Most recent order the Actor stops fetching once it reaches older reviews."
},
"ratings": {
"title": "⭐ Star ratings",
"type": "array",
"description": "Keep only reviews with these star ratings (5 = Excellent … 1 = Terrible). Leave empty for all ratings.",
"items": {
"type": "string",
"enum": [
"5",
"4",
"3",
"2",
"1"
],
"enumTitles": [
"5 — Excellent",
"4 — Very good",
"3 — Average",
"2 — Poor",
"1 — Terrible"
]
}
},
"travelerTypes": {
"title": "🧳 Traveller types",
"type": "array",
"description": "Keep only reviews from these trip types. Each review row then carries its travelerType. Leave empty for all travellers.",
"items": {
"type": "string",
"enum": [
"families",
"couples",
"solo",
"business",
"friends"
],
"enumTitles": [
"Families",
"Couples",
"Solo",
"Business",
"Friends"
]
}
},
"visitMonths": {
"title": "🗓️ Months of visit",
"type": "array",
"description": "Keep only reviews of visits in these months (any year) — for example the high season. Leave empty for all months.",
"items": {
"type": "string",
"enum": [
"january",
"february",
"march",
"april",
"may",
"june",
"july",
"august",
"september",
"october",
"november",
"december"
],
"enumTitles": [
"January",
"February",
"March",
"April",
"May",
"June",
"July",
"August",
"September",
"October",
"November",
"December"
]
}
},
"translateReviews": {
"title": "Translate reviews",
"type": "boolean",
"description": "Off: every review comes in the language it was written in (language column). On: reviews written in other languages come as Tripadvisor's machine translation into English; isTranslated marks them and language keeps the original language. A few reviews have no English version on Tripadvisor: they stay in their own language with translationMissing = true.",
"default": false
},
"includePlaceSummary": {
"title": "🏨 Add a place summary row ($)",
"type": "boolean",
"description": "Also write one place row per place: name, type, address, overall rating, total reviews and how many 5, 4, 3, 2 and 1-star reviews it has. Charged as a separate place event. Off by default, so the table holds reviews only.",
"default": false
},
"onlyNewRowsStore": {
"title": "🔁 Only new reviews — memory name",
"pattern": "^[A-Za-z0-9-]{0,63}$",
"type": "string",
"description": "Give this monitoring a name — my-hotel-reviews — and the Actor remembers every review it delivered under that name. Every later run with the same name writes and charges only reviews you have not received before. Schedule the Actor daily to get a feed of new Tripadvisor reviews. Leave empty to get everything found, every time."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}