# Tripadvisor Reviews Scraper - No Browser Needed, Full Filters (`mof1re/tripadvisor-reviews-scraper-browserless`) Actor
Extract Tripadvisor reviews without the browser session most scrapers need to get past bot checks. Filter by rating, date range, month, trip type, and keyword all at once. Get owner replies, subratings, and reviewer profiles. Fast and clean.
- **URL**: https://apify.com/mof1re/tripadvisor-reviews-scraper-browserless.md
- **Developed by:** [Vladimir Efimenco](https://apify.com/mof1re) (community)
- **Categories:** Travel, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet
## Pricing
from $0.80 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## Tripadvisor Reviews Scraper | ⚡ Fast Browserless
This Tripadvisor Reviews Scraper is built on the site's internal mobile API, not a headless browser. Returns full review content alongside reviewer details, owner replies, trip type, visit dates, and category subratings, for hotels, restaurants, attractions, and attraction products (tours/activities).
### ⚡ Why this Tripadvisor Reviews Scraper
- **No browser session needed to get past bot checks.** Most Tripadvisor review scrapers have to run a full browser session just to clear Tripadvisor's bot protection before they can call the review data. This one talks to the mobile API directly, so there's no session to maintain and no captcha retries burning through your run.
- **Full dataset, not a summary.** Every review comes with the review text, rating, trip type, visit date, reviewer profile info, and the owner's reply where present.
- **Listing-wide rating breakdown included.** Overall rating distribution and category subratings are attached alongside each review.
- **The most filters of any Tripadvisor reviews scraper on the store.** Rating, date range (relative period or exact date), month, trip type, and keyword search that can run server-side or locally, all in the same input.
- **Batch by design.** Scrape multiple listings in a single run (up to 5 in parallel), with a configurable result cap per listing or unlimited collection.
- **Proxies included.** Proxy pool is built in. You don't need to bring your own.
- **Fast.** No browser, no rendering wait. Pure HTTP calls to the same internal API the Tripadvisor app uses.
### 🎯 Who uses this Tripadvisor Reviews Scraper
- **Hospitality market researchers & analysts** studying guest sentiment, seasonal patterns, or trip-type breakdowns (business vs family vs solo travel) across hotels, restaurants, or attractions.
- **Competitor benchmarking teams** comparing review scores and subratings across properties in the same city or category.
- **Reputation management agencies** tracking new reviews and owner responses across a portfolio of client properties, filtered to a specific time window.
- **Sentiment analysis and NLP teams** feeding review text into topic models or classifiers, filtered by rating or keyword before it ever hits their pipeline.
- **Developers building hospitality dashboards or review aggregators** who need clean structured Tripadvisor data instead of scraping pages by hand.
### 🧾 What you get, per review
- Review content: title, text, rating, published date, visited date, trip type, tip
- Reviewer info: name, profile URL, avatar, hometown, contributions, helpful votes
- Owner reply: reply text and date, if the business responded
- Category subratings: e.g. Service, Value, Location, depending on listing type
- Listing-wide stats: total review count, overall rating, rating distribution
- Keyword match: whether the search query matched this review
### 🔍 How keyword search works
The `search` field is a single query, same as what you'd type into Tripadvisor's own review search box.
- **`searchIsLocalFilter` unchecked (default):** the query is sent to Tripadvisor as a server-side filter. Only matching reviews are returned, and every one of them is marked `keyword_match: true`.
- **`searchIsLocalFilter` checked:** the query is *not* sent to Tripadvisor. Every review is still fetched and returned, but each one is checked locally against the title and text, and gets a `keyword_match` flag showing whether it was found.
Use the checked option when you want the full, unfiltered review set but still want to know which reviews mention your keyword.
### 📅 How the date filter works
- **`sincePeriod`**: a relative window (last 1 month / 3 months / 6 months / 1 year), computed from today's date.
- **`sinceDate`**: an exact calendar date. If set, it overrides `sincePeriod`.
Leave both empty to fetch reviews from any date.
### 🔧 Input options
| Field | Description |
|---|---|
| `listingUrls` | One or more Tripadvisor listing page URLs (hotel, restaurant, attraction, or attraction product) |
| `maxResults` | Max reviews to collect per listing. Leave empty to collect all available |
| `rating` | Filter by star rating (1–5), multi-select |
| `sincePeriod` | Relative date window: last 1/3/6 months or 1 year |
| `sinceDate` | Exact start date, overrides `sincePeriod` if set |
| `months` | Filter reviews written in specific calendar months, multi-select |
| `type` | Filter by trip type: Business, Couples, Family, Friends, Solo |
| `search` | Keyword to search for in reviews |
| `searchIsLocalFilter` | If checked, `search` tags reviews locally instead of filtering them via Tripadvisor |
### 📊 Data Fields
#### 📝 Review Details
| Field | Description |
|---|---|
| `listing_url` | Tripadvisor listing page URL this review belongs to |
| `listing_title` | Title of the listing |
| `review_id` | Unique ID of the review |
| `rating` | Reviewer's overall star rating |
| `title` / `text` | Review title and body text (HTML) |
| `published_date` | Localized date the review was published |
| `visited_date` | Localized date the reviewer visited |
| `trip_type` | Business, Couples, Family, Friends, or Solo |
| `tip` | Reviewer's tip for future visitors, if provided |
| `helpful_votes` | Number of helpful votes the review received |
| `photos` | URLs of photos attached to the review |
| `review_url` | Shareable public URL of the review |
#### 👤 Reviewer
| Field | Description |
|---|---|
| `author` | Name, profile URL, avatar, hometown, contributions, helpful votes count |
#### 🏢 Owner
| Field | Description |
|---|---|
| `owner_response` | Author, published date, report URL, and reply text, if the owner replied |
#### ⭐ Ratings & Matching
| Field | Description |
|---|---|
| `subratings` | Category subratings (e.g. Service, Value, Location), keyed by category label |
| `reviews_stats` | Listing-wide aggregate stats: total reviews, overall rating, rating distribution |
| `keyword_query` | The search keyword provided in actor input, if any |
| `keyword_match` | True if the query matched this review, either verified locally or because Tripadvisor's own filter already applied it |
### 📋 Example output
```json
[
{
"listing_title": "Restaurant Armònia",
"listing_url": "https://www.tripadvisor.com/Restaurant_Review-g187892-d12850867-Reviews-Restaurant_Armonia-Taormina_Province_of_Messina_Sicily.html",
"reviews_stats": {
"reviews_total": 672,
"listing_rating": 4.9,
"listing_rating_text": "Excellent",
"ratings_stats": {
"Excellent": {
"count": 627,
"percentage": 93
},
"Good": {
"count": 23,
"percentage": 3
},
"Average": {
"count": 9,
"percentage": 1
},
"Poor": {
"count": 6,
"percentage": 1
},
"Terrible": {
"count": 7,
"percentage": 1
}
},
"subratings_stats": {
"atmosphere": 4.9,
"food": 4.8,
"service": 4.9,
"value": 4.7
}
},
"review_id": "1067268891",
"rating": 5.0,
"title": "Magnificent!!!",
"text": "We chose the Armonia restaurant at the Mazzarò Sea Palace to celebrate a birthday, and we could not have made a better choice.
From the moment we arrived, we felt welcomed with sincere attention and great professionalism. The staff was impeccable, always present, and knew how to handle all our specific needs with extreme care, making us experience a serene and special evening.
The cuisine was simply excellent: every dish was attended to in the smallest details, with ingredients of the highest quality and refined flavors that highlight the local area without ever being excessive. A gastronomic journey that captivated us from beginning to end.
There are places where you don't go just to eat well, but to live an experience that leaves a fond memory. For us, Armonia was exactly that: the perfect place to celebrate an important moment.
A special thanks to Deborah who accompanied us throughout the evening with attention, sensitivity, and a smile that made this occasion even more special.
We will definitely return!!",
"text_clean": "We chose the Armonia restaurant at the Mazzarò Sea Palace to celebrate a birthday, and we could not have made a better choice.\n\nFrom the moment we arrived, we felt welcomed with sincere attention and great professionalism. The staff was impeccable, always present, and knew how to handle all our specific needs with extreme care, making us experience a serene and special evening.\n\nThe cuisine was simply excellent: every dish was attended to in the smallest details, with ingredients of the highest quality and refined flavors that highlight the local area without ever being excessive. A gastronomic journey that captivated us from beginning to end.\n\nThere are places where you don't go just to eat well, but to live an experience that leaves a fond memory. For us, Armonia was exactly that: the perfect place to celebrate an important moment. \nA special thanks to Deborah who accompanied us throughout the evening with attention, sensitivity, and a smile that made this occasion even more special.\nWe will definitely return!!",
"published_date": "4 days ago",
"visited_date": "Jun 2026",
"trip_type": "Friends",
"tip": null,
"helpful_votes": 0,
"photos": [],
"review_url": "https://www.tripadvisor.com/ShowUserReviews-g187892-d12850867-r1067268891-Restaurant_Armonia-Taormina_Province_of_Messina_Sicily.html",
"report_url": "https://www.tripadvisor.com/SocialIapReporting?objectType=Review&contentId=1067268891&locationId=12850867",
"author": {
"name": "HelenaJFK",
"profile_url": "https://www.tripadvisor.com/Profile/HelenaJFK",
"avatar_url": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/04/33/37/e3/djuza.jpg",
"hometown": "Milan, Italy",
"contributions": 11,
"helpful_votes": 6
},
"owner_response": {
"author": {
"name": "VOIhotels sede centrale",
"profile_url": "https://www.tripadvisor.com/Profile/VOIhotelsITA",
"avatar_url": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/2d/7f/6e/ba/voihotelsita.jpg",
"position": "Marketing at Restaurant Armònia"
},
"published_date": "July 10, 2026",
"report_url": "https://www.tripadvisor.com/SocialIapReporting?objectType=OwnerResponse&contentId=1067797705&locationId=12850867",
"text": "Gentile HelenaJFK,\n\nLa ringraziamo di cuore per aver scelto Armonia per celebrare un'occasione così speciale e per aver condiviso la sua splendida esperienza.\n\nSiamo felici che abbia apprezzato l'accoglienza, l'attenzione del nostro staff e il percorso gastronomico proposto dalla nostra cucina. Sapere di aver contribuito a rendere il vostro compleanno un momento piacevole e memorabile ci gratifica molto.\n\nNon vediamo l'ora di accogliervi nuovamente per regalarvi un'altra esperienza speciale.\n\nDana Muscalu\nRestaurant Manager\n",
"text_clean": "Gentile HelenaJFK,\n\nLa ringraziamo di cuore per aver scelto Armonia per celebrare un'occasione così speciale e per aver condiviso la sua splendida esperienza.\n\nSiamo felici che abbia apprezzato l'accoglienza, l'attenzione del nostro staff e il percorso gastronomico proposto dalla nostra cucina. Sapere di aver contribuito a rendere il vostro compleanno un momento piacevole e memorabile ci gratifica molto.\n\nNon vediamo l'ora di accogliervi nuovamente per regalarvi un'altra esperienza speciale.\n\nDana Muscalu\nRestaurant Manager\n"
},
"subratings": {
"Value": 5,
"Service": 5,
"Food": 5,
"Atmosphere": 5
},
"keyword_query": "amazing",
"keyword_match": false
},
{
"listing_title": "Restaurant Armònia",
"listing_url": "https://www.tripadvisor.com/Restaurant_Review-g187892-d12850867-Reviews-Restaurant_Armonia-Taormina_Province_of_Messina_Sicily.html",
"reviews_stats": {
"reviews_total": 672,
"listing_rating": 4.9,
"listing_rating_text": "Excellent",
"ratings_stats": {
"Excellent": {
"count": 627,
"percentage": 93
},
"Good": {
"count": 23,
"percentage": 3
},
"Average": {
"count": 9,
"percentage": 1
},
"Poor": {
"count": 6,
"percentage": 1
},
"Terrible": {
"count": 7,
"percentage": 1
}
},
"subratings_stats": {
"atmosphere": 4.9,
"food": 4.8,
"service": 4.9,
"value": 4.7
}
},
"review_id": "1066490363",
"rating": 3.0,
"title": "Nice but not memorable.",
"text": "Ambience was very good as was the service. Unfortunately I felt that the portion size of the courses was disappointing. The flavours were nice but for the price it did not make me think that I would wish to repeat going back as in all honesty we did not leave saying wow that was worth it.",
"text_clean": "Ambience was very good as was the service. Unfortunately I felt that the portion size of the courses was disappointing. The flavours were nice but for the price it did not make me think that I would wish to repeat going back as in all honesty we did not leave saying wow that was worth it.",
"published_date": "1 week ago",
"visited_date": "Jun 2026",
"trip_type": "Couples",
"tip": null,
"helpful_votes": 0,
"photos": [],
"review_url": "https://www.tripadvisor.com/ShowUserReviews-g187892-d12850867-r1066490363-Restaurant_Armonia-Taormina_Province_of_Messina_Sicily.html",
"report_url": "https://www.tripadvisor.com/SocialIapReporting?objectType=Review&contentId=1066490363&locationId=12850867",
"author": {
"name": "Bill M",
"profile_url": "https://www.tripadvisor.com/Profile/billmW5230UQ",
"avatar_url": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/1a/f6/e7/7b/default-avatar-2020-56.jpg",
"hometown": "Plymouth, UK",
"contributions": 5,
"helpful_votes": 4
},
"owner_response": {
"author": {
"name": "VOIhotels sede centrale",
"profile_url": "https://www.tripadvisor.com/Profile/VOIhotelsITA",
"avatar_url": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/2d/7f/6e/ba/voihotelsita.jpg",
"position": "Marketing at Restaurant Armònia"
},
"published_date": "July 4, 2026",
"report_url": "https://www.tripadvisor.com/SocialIapReporting?objectType=OwnerResponse&contentId=1066913668&locationId=12850867",
"text": "Dear Bill M,\n\nThank you for taking the time to share your feedback and for your kind words about our ambience, service, and the flavours of our dishes.\nWe are sorry to hear that the portion sizes did not meet your expectations and that, overall, you did not feel the experience represented good value for the price. \nYour comments are truly appreciated and we hope to have the opportunity to welcome you back to Armonia Restaurant in the future. \n\nDana Muscalu \nRestaurant Manager \n",
"text_clean": "Dear Bill M,\n\nThank you for taking the time to share your feedback and for your kind words about our ambience, service, and the flavours of our dishes.\nWe are sorry to hear that the portion sizes did not meet your expectations and that, overall, you did not feel the experience represented good value for the price. \nYour comments are truly appreciated and we hope to have the opportunity to welcome you back to Armonia Restaurant in the future. \n\nDana Muscalu \nRestaurant Manager \n"
},
"subratings": {},
"keyword_query": "amazing",
"keyword_match": false
},
{
"listing_title": "Restaurant Armònia",
"listing_url": "https://www.tripadvisor.com/Restaurant_Review-g187892-d12850867-Reviews-Restaurant_Armonia-Taormina_Province_of_Messina_Sicily.html",
"reviews_stats": {
"reviews_total": 672,
"listing_rating": 4.9,
"listing_rating_text": "Excellent",
"ratings_stats": {
"Excellent": {
"count": 627,
"percentage": 93
},
"Good": {
"count": 23,
"percentage": 3
},
"Average": {
"count": 9,
"percentage": 1
},
"Poor": {
"count": 6,
"percentage": 1
},
"Terrible": {
"count": 7,
"percentage": 1
}
},
"subratings_stats": {
"atmosphere": 4.9,
"food": 4.8,
"service": 4.9,
"value": 4.7
}
},
"review_id": "1065745909",
"rating": 5.0,
"title": "Amazing evening",
"text": "We had an incredible dinner at Armonia. The staff were attentive and helpful. We requested a table close to the sea view which was stunning. The food and wine pairings were amazing as well. We would 100% recommend going if you’re looking for a special evening.",
"text_clean": "We had an incredible dinner at Armonia. The staff were attentive and helpful. We requested a table close to the sea view which was stunning. The food and wine pairings were amazing as well. We would 100% recommend going if you’re looking for a special evening.",
"published_date": "2 weeks ago",
"visited_date": "Jun 2026",
"trip_type": "Couples",
"tip": null,
"helpful_votes": 0,
"photos": [
"https://dynamic-media-cdn.tripadvisor.com/media/photo-o/33/aa/9b/96/caption.jpg"
],
"review_url": "https://www.tripadvisor.com/ShowUserReviews-g187892-d12850867-r1065745909-Restaurant_Armonia-Taormina_Province_of_Messina_Sicily.html",
"report_url": "https://www.tripadvisor.com/SocialIapReporting?objectType=Review&contentId=1065745909&locationId=12850867",
"author": {
"name": "George B",
"profile_url": "https://www.tripadvisor.com/Profile/C241EKgeorgeb",
"avatar_url": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/1a/f6/f1/79/default-avatar-2020-21.jpg",
"hometown": null,
"contributions": 5,
"helpful_votes": 0
},
"owner_response": {
"author": {
"name": "VOIhotels sede centrale",
"profile_url": "https://www.tripadvisor.com/Profile/VOIhotelsITA",
"avatar_url": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/2d/7f/6e/ba/voihotelsita.jpg",
"position": "Marketing at Restaurant Armònia"
},
"published_date": "June 27, 2026",
"report_url": "https://www.tripadvisor.com/SocialIapReporting?objectType=OwnerResponse&contentId=1065973244&locationId=12850867",
"text": "Dear C241EKgeorgeb,\n\nThank you so much for sharing your experience and for choosing Armonia Restaurant!\n\nWe’re delighted to hear that your evening with us was so special and that you enjoyed both the attentive service from our staff and the stunning sea view. \n\nWe truly appreciate your recommendation and look forward to welcoming you back soon for another beautiful dinner by the sea.\n\nDana Muscalu \nRestaurant Manager ",
"text_clean": "Dear C241EKgeorgeb,\n\nThank you so much for sharing your experience and for choosing Armonia Restaurant!\n\nWe’re delighted to hear that your evening with us was so special and that you enjoyed both the attentive service from our staff and the stunning sea view. \n\nWe truly appreciate your recommendation and look forward to welcoming you back soon for another beautiful dinner by the sea.\n\nDana Muscalu \nRestaurant Manager "
},
"subratings": {},
"keyword_query": "amazing",
"keyword_match": true
}
]
```
### 🚀 Running the actor
#### Via Apify Console
Open the actor page, fill in the input form, and click **Start**.
#### Via Apify API: Python
```python
import requests
APIFY_TOKEN = "your_apify_token"
ACTOR_ID = "mof1re~tripadvisor-reviews-scraper"
run_input = {
"listingUrls": [
{"url": "https://www.tripadvisor.com/Hotel_Review-g187497-d232778-Reviews-Hotel_Arc_La_Rambla-Barcelona_Catalonia.html"}
],
"maxResults": 200,
"rating": ["4", "5"],
"sincePeriod": "6_months",
"sinceDate": None,
"months": [],
"type": [],
"search": "",
"searchIsLocalFilter": False
}
response = requests.post(
f"https://api.apify.com/v2/acts/{ACTOR_ID}/run-sync-get-dataset-items",
params={"token": APIFY_TOKEN},
json=run_input,
)
reviews = response.json()
print(f"Fetched {len(reviews)} reviews")
```
#### Via Apify API: Node.js
```javascript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'your_apify_token' });
const input = {
listingUrls: [
{ url: 'https://www.tripadvisor.com/Hotel_Review-g187497-d232778-Reviews-Hotel_Arc_La_Rambla-Barcelona_Catalonia.html' }
],
maxResults: 200,
rating: ['4', '5'],
sincePeriod: '6_months',
sinceDate: null,
months: [],
type: [],
search: '',
searchIsLocalFilter: false,
};
const run = await client.actor('mof1re/tripadvisor-reviews-scraper').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Fetched ${items.length} reviews`);
```
#### Example input JSON
```json
{
"listingUrls": [
{ "url": "https://www.tripadvisor.com/Hotel_Review-g187497-d232778-Reviews-Hotel_Arc_La_Rambla-Barcelona_Catalonia.html" },
{ "url": "https://www.tripadvisor.com/Restaurant_Review-g187892-d12850867-Reviews-Restaurant_Armonia-Taormina_Province_of_Messina_Sicily.html" }
],
"maxResults": 200,
"rating": ["1", "2", "3", "4", "5"],
"sincePeriod": "3_months",
"sinceDate": null,
"months": ["1", "3", "4"],
"type": ["Business", "Couples", "Family", "Friends", "Solo"],
"search": "good",
"searchIsLocalFilter": false
}
```
### ❓ FAQ
**How is this different from other Tripadvisor review scrapers?** Most run a browser to clear Tripadvisor's bot checks before they can pull reviews, and most only filter by one or two fields. This Tripadvisor Reviews Scraper calls the mobile API directly and supports rating, date range, month, trip type, and dual-mode keyword filtering together.
**Does this scraper need an account or API key?** No. It extracts publicly available review data.
**Why not just use Tripadvisor's official API?** Tripadvisor's official review API caps out at a handful of reviews per listing and requires a paid key with daily quotas. This Tripadvisor Reviews Scraper isn't limited by that and returns the full review set available on the listing.
**Can I filter reviews by trip type or visit month?** Yes. Set `type` for business, couples, family, friends, or solo trips, and `months` for specific calendar months, independent of the date range filter.
**Do I need my own proxies?** No. Proxies are built into the actor, nothing to configure.
**Is this legal? Can I scrape publicly available reviews?** This tool extracts publicly available review data. You're responsible for complying with the target site's terms of service and applicable data protection laws for your use case.
### 💳 Pricing
Pay-per-result. You're charged for reviews actually delivered, not for pages fetched or requests made.
### ⚠️ Notes
- Free-tier accounts are capped at a small sample size per run, and to a single listing per run. Upgrade to a paid Apify plan for full volume and batch scraping.
- Data reflects what's publicly listed on tripadvisor.com at the time of the run; the source updates continuously.
### 🔗 See also
Need reviews from another platform? Check out:
- [Booking.com Reviews Scraper](https://apify.com/mof1re/booking-reviews-scraper-browserless)
- [AirBnb Reviews Scraper](https://apify.com/mof1re/airbnb-reviews-scraper-browserless)
- [Trustpilot Reviews Scraper](https://apify.com/mof1re/trustpilot-scraper-fast-browserlessapif)
# Actor input Schema
## `listingUrls` (type: `array`):
Tripadvisor listing URLs to scrape reviews from.
## `maxResults` (type: `integer`):
Maximum number of reviews to scrape per listing. Leave empty to try to get all reviews.
## `rating` (type: `array`):
Filter reviews by star rating. Leave empty to include all ratings.
## `sincePeriod` (type: `string`):
Show reviews from the selected period, relative to today. Ignored if "Reviews since (exact date)" below is set.
## `sinceDate` (type: `string`):
Optional. Pick an exact start date for reviews. Overrides "Reviews since (period)" if set.
## `months` (type: `array`):
Filter reviews written in these months. Leave empty to include all months.
## `type` (type: `array`):
Filter reviews by trip type. Leave empty to include all types.
## `search` (type: `string`):
Filter reviews containing this keyword.
## `searchIsLocalFilter` (type: `boolean`):
If enabled, keyword filtering is applied locally to already-fetched reviews. If disabled, the keyword is sent to Tripadvisor and results returned are treated as already matched.
## Actor input object example
```json
{
"listingUrls": [
{
"url": "https://www.tripadvisor.com/Restaurant_Review-g187892-d12850867-Reviews-Restaurant_Armonia-Taormina_Province_of_Messina_Sicily.html"
}
],
"maxResults": 100,
"rating": [],
"months": [],
"type": [],
"searchIsLocalFilter": false
}
```
# Actor output Schema
## `jobAds` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"listingUrls": [
{
"url": "https://www.tripadvisor.com/Restaurant_Review-g187892-d12850867-Reviews-Restaurant_Armonia-Taormina_Province_of_Messina_Sicily.html"
}
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("mof1re/tripadvisor-reviews-scraper-browserless").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = { "listingUrls": [{ "url": "https://www.tripadvisor.com/Restaurant_Review-g187892-d12850867-Reviews-Restaurant_Armonia-Taormina_Province_of_Messina_Sicily.html" }] }
# Run the Actor and wait for it to finish
run = client.actor("mof1re/tripadvisor-reviews-scraper-browserless").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"listingUrls": [
{
"url": "https://www.tripadvisor.com/Restaurant_Review-g187892-d12850867-Reviews-Restaurant_Armonia-Taormina_Province_of_Messina_Sicily.html"
}
]
}' |
apify call mof1re/tripadvisor-reviews-scraper-browserless --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=mof1re/tripadvisor-reviews-scraper-browserless",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
Download the OpenAPI definition: https://api.apify.com/v2/actors/rJIwgpmBewd4WakR4/builds/icd338ToYfmXrrQdE/openapi.json