# TheFork Restaurant Reviews Scraper - Multi-Language (`clearpath/thefork-restaurant-reviews`) Actor Extract all reviews from any TheFork restaurant across 7 languages. Get ratings, review text, meal dates, reviewer details, photos, and restaurant replies. Automatic deduplication. Export as JSON, CSV, or Excel. - **URL**: https://apify.com/clearpath/thefork-restaurant-reviews.md - **Developed by:** [ClearPath](https://apify.com/clearpath) (community) - **Categories:** Automation, Lead generation, Travel - **Features:** Limited permissions - **Stats:** 74 total users, 21 monthly users, 95.9% runs succeeded, 2 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $2.29 / 1,000 reviews 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/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## TheFork Review Scraper | All Reviews, All Languages (2026) [![All TheFork reviews. Every language. 5,000 reviews in under 5 minutes. Photos. Reviewer profiles. Restaurant replies.](https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/thefork-restaurant-reviews-readme-hero-v1.png)](https://console.apify.com/actors/GzM1sRA0QwmfnUjEb/input) From Clearpath, creators of TheFork Restaurant Scraper, Yelp Reviews and Tripadvisor Reviews. Restaurant discovery and review research from the same team. ### Why choose this actor? Get the reviews across languages, with duplicates removed. Collect the available review history from each restaurant, including reviews written in other languages. Every row keeps its language and restaurant, ready to compare feedback across locations. Collect 5,000 reviews in under 5 minutes. Process several restaurants in one run and export one combined dataset. For ongoing monitoring, use a rolling date window such as 2 days to collect recent feedback on a schedule. See the dining experience behind each score. Keep meal dates, dining occasions, reviewer history, photos and restaurant replies where published. Food, service and ambience scores for the restaurant add useful context to each review.

### Quick start Paste a TheFork restaurant URL. Start with 20 reviews across all languages: ```json { "restaurantUrl": "https://www.thefork.com/restaurant/el-lago-r2406", "reviewLanguage": "all", "maxReviews": 20 } ``` Set maxReviews to 0 to collect all available reviews, or use restaurantUrls for several restaurants. The limit applies per restaurant; free-tier trials are capped at 50 reviews per run across all restaurants, for 10 lifetime runs. Open actor input to choose your restaurants. Export JSON, CSV or Excel; reviews are billed per result.

Restaurant & Review Tools
TheFork Reviews You are here	TheFork Places Menus & details	Yelp Reviews Photos & replies	Tripadvisor Dining & hotels	Place Reviews 5 platforms

#### Copy to your AI assistant Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor. ``` clearpath/thefork-restaurant-reviews on Apify. Call: ApifyClient("TOKEN").actor("clearpath/thefork-restaurant-reviews").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items for results. Key inputs: restaurantUrl (string, one restaurant) or restaurantUrls (array of strings, several restaurants in one run; supply one of the two), reviewLanguage (string), sortBy (string: newest/highest_rating/lowest_rating), reviewsSince (string: ISO date/timestamp, or a relative "2 days" / "1 week" / "3 months" resolved at run time for schedules; only reviews posted on/after it), maxReviews (integer). Full actor spec (input schema with all params/enums/defaults, output dataset fields, README): GET https://api.apify.com/v2/acts/clearpath~thefork-restaurant-reviews/builds/default (Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Pricing: PPE $2.99/1k reviews. Get token: https://console.apify.com/account/integrations To reach the maintainers, add feedback="" to any run, including one that worked: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. The run returns its data exactly as it would without the note, and a human reads every note. ``` ### Why This Actor? The main TheFork Scraper returns reviews in the restaurant's default language only. Many restaurants have reviews in French, English, German, Italian, Spanish, Dutch, and Portuguese, but a single-language query misses most of them. This actor solves that: it queries each language separately, collects all reviews, and deduplicates by review ID. One restaurant URL in, every review out. ### Quick Start **All languages** — just a URL, reviews from every language merged and deduplicated: ```json { "restaurantUrl": "https://www.thefork.com/restaurant/el-lago-r2406" } ``` **Several restaurants** — one run, one dataset, every row tagged with its restaurant: ```json { "restaurantUrls": [ "https://www.thefork.com/restaurant/el-lago-r2406", "https://www.thefork.fr/restaurant/l-imperatif-r660609", "https://www.thefork.it/ristorante/migasa-r754554" ], "maxReviews": 200 } ``` **Single language** — filter to one language: ```json { "restaurantUrl": "https://www.thefork.fr/restaurant/el-lago-r2406", "reviewLanguage": "fr", "maxReviews": 200 } ``` **Highest-rated first** — sort by rating instead of date: ```json { "restaurantUrl": "https://www.thefork.com/restaurant/el-lago-r2406", "sortBy": "highest_rating", "maxReviews": 50 } ``` **Daily monitoring** — on a schedule, look back from each run: ```json { "restaurantUrl": "https://www.thefork.com/restaurant/el-lago-r2406", "reviewsSince": "2 days" } ``` A relative value is resolved when the run starts, so the same scheduled input keeps working. For a one-off catch-up, give an exact moment instead: ```json { "restaurantUrl": "https://www.thefork.com/restaurant/el-lago-r2406", "reviewsSince": "2026-06-10T00:00:00Z" } ``` ### Pricing

Apify Plan	Price per 1,000 Reviews
Free	$2.99
Starter	$2.79
Scale	$2.49
Business	$2.29

#### Free Users New users get **10 free runs** with up to **50 reviews per run** to test the actor before subscribing. [Upgrade your plan](https://console.apify.com/billing/subscription) for unlimited results. ### Use Cases

Sentiment Analysis Collect all reviews across languages for NLP analysis. Detect trends in food quality, service, and ambience over time.	Competitor Monitoring Track what guests say about competing restaurants. Compare ratings, complaint patterns, and response rates.

Reputation Management Export all reviews including restaurant replies. Identify unanswered negative reviews and response gaps.	Market Research Analyze review volume and ratings across languages to understand tourist vs. local dining patterns.

New Review Monitoring Schedule recurring runs with `reviewsSince` set to a relative window such as `2 days`, which is resolved fresh on every run. The run stops as soon as it reaches older reviews, so you only collect (and pay for) genuinely new ones. Pipe new low ratings into alerts or a reputation dashboard.

### Parameters

Parameter	Type	Description
`restaurantUrl`	string	TheFork restaurant URL. Country-specific domains and localized paths such as `/ristorante/` and `/restaurante/` are supported.
`restaurantUrls`	array	Several restaurant URLs in one run. Reviews land in a single dataset, each row carrying its own restaurant name, ID and coordinates. `maxReviews` then applies to each restaurant separately.
`reviewLanguage`	string	"All languages" iterates every language and merges. Or pick one: en, fr, de, it, es, nl, pt. Default: `all`
`sortBy`	string	Review order: `newest`, `highest_rating`, or `lowest_rating`. With "All languages", applied within each language. Default: `newest`
`reviewsSince`	string	Only reviews posted on/after this point (UTC). Accepts a relative `2 days`, `1 week`, `3 months`, `1 year`, resolved when the run starts, or an exact `2026-06-10` / `2026-06-10T14:30:00Z`. Stops early, so you only collect new reviews. Forces newest order. Default: empty (all)
`maxReviews`	integer	Max reviews to collect across all languages. `0` = no limit. Default: `0`

### Output Each review is a flat dataset item with 37 fields: **Restaurant details** — name, ID, full address (street, city, zip, country) and exact coordinates, on every row, so each row stands on its own. **Restaurant rating summary** — overall rating (1-10 scale), total review count, and the category scores for food, service, and ambience, plus the restaurant's TripAdvisor rating (1-5 scale) and review count when available. These restaurant-level fields are identical on every row, so a single review gives you the full summary. The summary is also written to the run's key-value store under `OUTPUT`, together with a per-language review breakdown, so it is available even for restaurants that have ratings but no written reviews. **Review data** — rating (1-10 scale), review text, occasion (romantic, business, family, friends), meal date, creation date, status, restaurant reply, photos, likes **Reviewer data** — first name, last name, username, avatar URL, total review count, member-since date #### Output Example ```json { "restaurant_id": "61beac0c-ba99-45d2-b7e5-70e067c86be7", "restaurant_name": "El Lago", "restaurant_city": "Marbella", "restaurant_country": "Spain", "restaurant_address": "Urb. Elviria Hills, Avda. Las Cumbres s/n, 29604, Marbella", "restaurant_street": "Urb. Elviria Hills, Avda. Las Cumbres s/n", "restaurant_zip_code": "29604", "restaurant_latitude": 36.4894, "restaurant_longitude": -4.9066, "restaurant_overall_rating": 9.5, "restaurant_overall_review_count": 367, "restaurant_food_rating": 9.6, "restaurant_service_rating": 9.6, "restaurant_ambience_rating": 9.4, "restaurant_review_count": 172, "restaurant_tripadvisor_rating": null, "restaurant_tripadvisor_review_count": null, "review_id": "ac9a66c7-25b1-11f0-b007-0e8af7bd4d53", "created_at": "2025-04-30T10:55:48.569Z", "updated_at": "2025-04-30T10:55:48.569Z", "rating_value": 10, "meal_date": "2025-04-29T18:00:00.000Z", "status": "PUBLISHED", "occasion": "ROMANTIC", "review_body": "Love this place & the serenity, excellent food & amazing champagne/wine list", "restaurant_reply_body": null, "restaurant_reply_status": null, "reviewer_id": "0be0b618-0202-4c66-ab88-da0067ce7f61", "reviewer_first_name": "Jose", "reviewer_last_name": "T.", "reviewer_username": "Jose T.", "reviewer_avatar_url": null, "reviewer_review_count": 2, "reviewer_member_since": "2019-08-14T09:12:33.104Z", "photos": [ { "id": "a39a94be-7c2e-4c1f-9d33-5f0b9a2e77d1", "title": null, "description": null, "image_url": "https://cdn.thefork.com/tf-lab/image/upload/f_auto,q_auto,w_800,c_limit/customer/61beac0c.../a39a94be.jpg", "preview_url": "https://cdn.thefork.com/tf-lab/image/upload/f_auto,q_auto,g_auto:subject,w_488,h_488,c_fill/customer/61beac0c.../a39a94be.jpg", "created_ts": "2025-04-30T10:57:34.768Z", "likes": 0 } ], "likes": 0, "language": "en" } ``` #### Run Summary The same restaurant-level figures, plus how the reviews split across languages, are written to the key-value store under `OUTPUT`. With several restaurants it holds a `restaurants` list of these same objects, one per restaurant: ```json { "restaurant_id": "61beac0c-ba99-45d2-b7e5-70e067c86be7", "restaurant_name": "El Lago", "restaurant_city": "Marbella", "restaurant_country": "Spain", "restaurant_address": "Urb. Elviria Hills, Avda. Las Cumbres s/n, 29604, Marbella", "restaurant_street": "Urb. Elviria Hills, Avda. Las Cumbres s/n", "restaurant_zip_code": "29604", "restaurant_latitude": 36.4894, "restaurant_longitude": -4.9066, "restaurant_overall_rating": 9.5, "restaurant_overall_review_count": 367, "restaurant_food_rating": 9.6, "restaurant_service_rating": 9.6, "restaurant_ambience_rating": 9.4, "restaurant_review_count": 172, "restaurant_tripadvisor_rating": null, "restaurant_tripadvisor_review_count": null, "reviews_by_language": { "all": 172, "en": 96, "es": 61, "fr": 11, "null": 4 } } ``` ### API Integration #### Python ```python from apify_client import ApifyClient client = ApifyClient("your_token") run = client.actor("clearpath/thefork-restaurant-reviews").call(run_input={ "restaurantUrl": "https://www.thefork.com/restaurant/el-lago-r2406", "reviewLanguage": "all", "maxReviews": 500, }) for review in client.dataset(run["defaultDatasetId"]).iterate_items(): print(f"{review['language']} | {review['rating_value']} | {review['review_body'][:80]}") ``` #### JavaScript ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'your_token' }); const run = await client.actor('clearpath/thefork-restaurant-reviews').call({ restaurantUrl: 'https://www.thefork.com/restaurant/el-lago-r2406', reviewLanguage: 'all', maxReviews: 500, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(`${items.length} reviews collected`); ``` ### More Zen Studio & Clearpath review scrapers **🔗 Review aggregators** -

**Place reviews** - [Place Review Aggregator](https://apify.com/zen-studio/place-review-aggregator) -

**Hotel reviews** - [Hotel Review Aggregator API: Google, Booking, Expedia & More](https://apify.com/clearpath/hotel-review-aggregator) -

**Software reviews** - [All-in-One Review Scraper: G2, Capterra & Trustpilot](https://apify.com/zen-studio/software-review-scraper) **📍 Individual review sources** -

**Google Maps** - [Google Maps Reviews Scraper - Unlimited Reviews Per Place](https://apify.com/zen-studio/google-maps-reviews-scraper) - [Google Maps Scraper - Every Place, Not Just the Top 250](https://apify.com/zen-studio/google-maps-scraper) -

**Swarm / Foursquare** - [Foursquare & Swarm Scraper: Places, Reviews, Busy Hours](https://apify.com/zen-studio/swarm-place-reviews-scraper) -

**Yelp** - [Yelp Reviews Scraper - All Languages & Owner Replies](https://apify.com/clearpath/yelp-reviews-scraper) -

**Tripadvisor** - [Tripadvisor Reviews Scraper - Hotels, Restaurants, Attractions](https://apify.com/clearpath/tripadvisor-reviews-scraper) - [Tripadvisor Scraper - Hotels, Restaurants, Attractions, Emails](https://apify.com/clearpath/tripadvisor-scraper) **📍 Place discovery** -

**Business leads** - [Fast Business Leads Scraper - Up to 1,000 in 30 Seconds](https://apify.com/clearpath/local-business-lead-extractor) **🍽️ Restaurant review tools** -

**TheFork** - [TheFork Scraper - Restaurants, Reviews & Menus](https://apify.com/clearpath/thefork-scraper) ### Supported Languages

EN
English

FR
French

DE
German

IT
Italian

ES
Spanish

NL
Dutch

PT
Portuguese

The actor auto-detects which languages have reviews for each restaurant. Set `reviewLanguage` to `"all"` to iterate all of them, or pick a specific code. ### Data Export

JSON
NLP pipelines, APIs

CSV
Spreadsheets, reporting

Excel
Dashboards, presentations

### FAQ **Can I scrape more than one restaurant per run?** Yes. Put the URLs in `restaurantUrls`, one per line. Every review lands in the same dataset, tagged with its restaurant name, ID and coordinates, so a single export covers the whole set. `maxReviews` applies to each restaurant, so ten URLs with `maxReviews: 100` give you up to 1,000 reviews. **What restaurant information comes with each review?** Whatever identifies and locates the restaurant: ID, name, full address, city, country and coordinates, repeated on every row so a single review is self-contained and rows group straight into a pipeline. Everything else about the restaurant itself, menus and dish prices, photos, features, opening hours, Michelin data, comes from [TheFork Restaurant Scraper](https://apify.com/clearpath/thefork-scraper) and joins onto these rows on `restaurant_id`. **How is this different from the main TheFork Scraper?** The main scraper returns reviews in one language per restaurant (the domain's default). This actor iterates all 7 languages separately, collecting reviews that only appear in non-default language buckets. It also deduplicates automatically. **Are reviews deduplicated?** Yes. The same review can appear in multiple language buckets. The actor tracks review IDs and skips duplicates. **Do I need a TheFork account?** No. All data is publicly available. **How many reviews can I extract?** No limit. Set `maxReviews` to `0` for all reviews. Restaurants typically have between 50 and 5,000 reviews across all languages. **Can I use any TheFork domain?** Yes. URLs from thefork.com, thefork.fr, thefork.de, thefork.it, and thefork.es all work. ### Support

Need help?
Email max@mapa.slmail.me or open an issue in the Issues tab.

### Legal Compliance Extracts publicly available review data from TheFork. Users must comply with applicable data protection regulations (GDPR, CCPA) and TheFork's terms of service. ***

Built by Clearpath

# Actor input Schema ## `restaurantUrl` (type: `string`): Paste one TheFork restaurant page URL. For several restaurants in a single run, use the field below instead.

Accepted formats include:
• https://www.thefork.com/restaurant/name-r12345
• https://www.thefork.it/ristorante/name-r12345
• https://www.thefork.es/restaurante/name-r12345
• Any current TheFork country domain ## `restaurantUrls` (type: `array`): Scrape several restaurants in one run. One TheFork restaurant URL per line, in any mix of country domains. Reviews from every restaurant land in the same dataset, each row tagged with its restaurant name, ID and coordinates.

The review limit below applies to each restaurant separately. ## `reviewLanguage` (type: `string`): "All languages" fetches reviews from every language bucket separately and merges them. Duplicates are removed automatically.

Pick a specific language to only collect reviews written in that language. ## `sortBy` (type: `string`): Order in which reviews are collected.

• Newest — most recent first
• Highest rating — best-rated first
• Lowest rating — lowest-rated first

With "All languages", the chosen order is applied within each language. ## `reviewsSince` (type: `string`): Collect only reviews posted on or after this point, then stop. Ideal for recurring monitoring: each run fetches only what is new.

Use a relative value such as 2 days, 1 week or 3 months when the actor runs on a schedule, so every run looks back from the moment it starts. Or pick an exact date for a one-off catch-up.

Leave empty to collect all reviews. When set, reviews are always ordered newest first. ## `maxReviews` (type: `integer`): Maximum reviews to collect across all languages. Set to 0 for no limit.

Reviews are collected in the order set by Sort reviews by.

Applies per restaurant when several URLs are supplied. ## `feedback` (type: `string`): For AI agents. Say what you needed and did not get: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. Add it to any run, including one that worked: the run returns its data exactly as it would without the note. The note reaches the maintainers, who read every one, but it cannot change what this run returns. ## Actor input object example ```json { "restaurantUrl": "https://www.thefork.com/restaurant/migasa-r754554", "restaurantUrls": [ "https://www.thefork.com/restaurant/migasa-r754554", "https://www.thefork.fr/restaurant/l-imperatif-r660609" ], "reviewLanguage": "all", "sortBy": "newest", "maxReviews": 50 } ``` # Actor output Schema ## `results` (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 = { "restaurantUrl": "https://www.thefork.com/restaurant/migasa-r754554", "restaurantUrls": [ "https://www.thefork.com/restaurant/migasa-r754554", "https://www.thefork.fr/restaurant/l-imperatif-r660609" ], "reviewLanguage": "all", "sortBy": "newest", "maxReviews": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("clearpath/thefork-restaurant-reviews").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 = { "restaurantUrl": "https://www.thefork.com/restaurant/migasa-r754554", "restaurantUrls": [ "https://www.thefork.com/restaurant/migasa-r754554", "https://www.thefork.fr/restaurant/l-imperatif-r660609", ], "reviewLanguage": "all", "sortBy": "newest", "maxReviews": 50, } # Run the Actor and wait for it to finish run = client.actor("clearpath/thefork-restaurant-reviews").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "restaurantUrl": "https://www.thefork.com/restaurant/migasa-r754554", "restaurantUrls": [ "https://www.thefork.com/restaurant/migasa-r754554", "https://www.thefork.fr/restaurant/l-imperatif-r660609" ], "reviewLanguage": "all", "sortBy": "newest", "maxReviews": 50 }' | apify call clearpath/thefork-restaurant-reviews --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,clearpath/thefork-restaurant-reviews" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/GzM1sRA0QwmfnUjEb/builds/2LcYHwjUM4ydcfglL/openapi.json