# TheFork Scraper (`mscraper/thefork-scraper`) Actor TheFork Scraper is a simple and powerful tool that allows you to extract restaurants from TheFork. It returns data such as restaurant name, photo, URL, cuisine, price, rating, reviews, offers, and more. Download data in various structured formats. - **URL**: https://apify.com/mscraper/thefork-scraper.md - **Developed by:** [mscraper](https://apify.com/mscraper) (community) - **Categories:** Travel - **Stats:** 34 total users, 1 monthly users, 0.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing $30.00/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 ## TheFork Scraper ### What does TheFork Scraper do? TheFork Scraper is simple and powerful tool that allows you to extract restaurants from [TheFork](https://thefork.com/). It returns data such as restaurant name, photo, url, cuisine, price, rating, reviews, offers, and more. Download data in various structured formats. ### Why scrape TheFork? Scraping TheFork can offer several benefits: ➡️ **Discover New Restaurants**: With the sheer amount of restaurant recommendations available on TheFork, it's hard to manually keep track of them all. This scraper helps you discover new restaurants that you might have otherwise missed. ➡️ **Special Offers and Discounts**: Keeping an eye on the best special offers and discounts can save you a significant amount of money. The scraper allows you to access these offers conveniently. ➡️ **Data Analysis**: If you're a data analyst or researcher, this data can be invaluable for studying trends in the restaurant industry, understanding consumer preferences, or identifying popular cuisines in different parts of the world. ### How much will it cost to scrape TheFork? Apify gives you $5 free usage credits every month on the [Apify Free plan](https://apify.com/pricing). You can get up to 10,000 results per month from TheFork Scraper for that, so those 10,000 results will be completely free But if you need to get more data regularly from TheFork, you should grab an Apify subscription. We recommend our [$49/month Starter plan](https://apify.com/pricing) - you can get up to 100,000 every month with the $49 monthly plan! Or get 1,000,000 results for $499 with the [Scale plan](https://apify.com/pricing) - wow! ### Input TheFork Scraper has the following input options. Click on the [input tab](https://apify.com/mscraper/thefork-scraper/input-schema) for more information. You can search restaurants by: #### Coordinates You can find the longitude and longitude of cities [here](https://www.latlong.net/category/cities-235-15.html) #### Location Type location like in search. The scraper will pick the first auto-complete suggestion. Types of locations: - City: `Paris, France` - Area: `British Museum` If the system doesn't find the city or area, it sets the radius to the default 0.5, for example, for a street like `Great Russell Street`. ### Results ![Apify - TheFork Scraper output](https://imgur.com/fW6fV9S.png) ```json { "uuid": "465b440f-9ba6-420d-8d2c-ce124c98fb2c", "name": "Cal Robert", "photo": "https://res.cloudinary.com/tf-lab/image/upload/restaurant/465b440f-9ba6-420d-8d2c-ce124c98fb2c/b41b9c61-a602-4b23-bd1d-11b64b5ec945.jpg", "url": "https://www.thefork.com/restaurant/cal-robert-r427429", "cuisine": "Mediterranean", "averagePrice": 22, "currency": "EUR", "ratingValue": 9.6, "reviewCount": 879, "offer": "30% off the 'a la carte' menu", "tags": ["Mediterranean", "Welcome"], "address": "Carrer de Requesens, 7,08001,Barcelona", "phone": "+34934414047", "description": null, "openingHours": "Monday 13:30 - 15:30\r\nTuesday 13:30 - 15:30\r\nWednesday 13:30 - 15:30, 20:30 - 22:30\r\nThursday 13:30 - 15:30, 20:30 - 22:30\r\nFriday 13:30 - 15:30, 20:30 - 22:30\r\nSaturday 13:30 - 15:30, 20:30 - 22:30\r\nSunday -\r\n", "paymentAccepted": [ "American Express", "Credit Card", "Mastercard", "Visa" ], "style": "Café", "chefName": null, "maxPartySize": 20, "isBookable": true, "photos": [ "https://res.cloudinary.com/tf-lab/image/upload/f_auto,q_auto,w_664,h_374/restaurant/465b440f-9ba6-420d-8d2c-ce124c98fb2c/b41b9c61-a602-4b23-bd1d-11b64b5ec945.jpg", "https://res.cloudinary.com/tf-lab/image/upload/f_auto,q_auto,w_664,h_374/restaurant/465b440f-9ba6-420d-8d2c-ce124c98fb2c/rejected/08fab167-9b44-4f5e-a455-b0be2a71a940.jpg", "https://res.cloudinary.com/tf-lab/image/upload/f_auto,q_auto,w_664,h_374/restaurant/465b440f-9ba6-420d-8d2c-ce124c98fb2c/0d234306-a499-417d-871c-1ad929971b30.jpg" ], "customerPhotos": [ "https://res.cloudinary.com/tf-lab/image/upload/f_auto,q_auto,w_800,c_limit/customer/465b440f-9ba6-420d-8d2c-ce124c98fb2c/5ad7db87-364b-4814-9751-5b7bf02553d8.jpg", "https://res.cloudinary.com/tf-lab/image/upload/f_auto,q_auto,w_800,c_limit/customer/465b440f-9ba6-420d-8d2c-ce124c98fb2c/cb4d3488-e14b-4eff-b187-626deda92c78.jpg", "https://res.cloudinary.com/tf-lab/image/upload/f_auto,q_auto,w_800,c_limit/customer/465b440f-9ba6-420d-8d2c-ce124c98fb2c/ec58303a-07b0-4be7-9c83-2f618b3dee3e.jpg" ], "hasLoyaltyProgram": false, "reviewList": [ { "ratingValue": 10, "foodRatingValue": 10, "serviceRatingValue": 10, "ambienceRatingValue": 10, "date": "2023-05-10T19:30:00.000Z", "review": "First meal in Catalunya after visiting Madrid & Andalusia and our best meal this trip! Robert came to our table and explained the daily specials, service was fantastic, and food was delicious. I highly recommend!", "reviewerName": "Jared C." } ] } ```` ### Is it legal to scrape TheFork? Note that personal data is protected by GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. We also recommend that you read our blog post: [is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/) ### Contact Please feel free to browse through the diverse array of web scrapers available on [my Apify profile](https://apify.com/mscraper). If a custom solution or extra options are what you're seeking, don't hesitate to get in touch with me directly at . # Actor input Schema ## `location` (type: `string`): City, Area or Address ## `latitude` (type: `string`): No description ## `longitude` (type: `string`): No description ## `radius` (type: `string`): No description ## `includeExtendedInfo` (type: `boolean`): Including extended restaurant information. This will increase the resource consumption proportional to number of restaurants. ## `includeReviews` (type: `boolean`): Including reviews of restaurants. This will increase the resource consumption proportional to number of restaurants. ## `proxy` (type: `object`): Select proxies to be used by your crawler. ## Actor input object example ```json { "location": "British Museum", "latitude": "53.400002", "longitude": "-2.983333", "radius": "0.5", "includeExtendedInfo": false, "includeReviews": false, "proxy": { "useApifyProxy": true, "groups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # 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 = { "location": "British Museum", "proxy": { "useApifyProxy": true, "groups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("mscraper/thefork-scraper").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 = { "location": "British Museum", "proxy": { "useApifyProxy": True, "groups": ["RESIDENTIAL"], "apifyProxyCountry": "US", }, } # Run the Actor and wait for it to finish run = client.actor("mscraper/thefork-scraper").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 '{ "location": "British Museum", "proxy": { "useApifyProxy": true, "groups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }' | apify call mscraper/thefork-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=mscraper/thefork-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TheFork Scraper", "description": "TheFork Scraper is a simple and powerful tool that allows you to extract restaurants from TheFork. It returns data such as restaurant name, photo, URL, cuisine, price, rating, reviews, offers, and more. Download data in various structured formats.", "version": "0.0", "x-build-id": "nw1E6WpCjcRBQJyDr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mscraper~thefork-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mscraper-thefork-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/mscraper~thefork-scraper/runs": { "post": { "operationId": "runs-sync-mscraper-thefork-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/mscraper~thefork-scraper/run-sync": { "post": { "operationId": "run-sync-mscraper-thefork-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": [ "proxy" ], "properties": { "location": { "title": "Location", "type": "string", "description": "City, Area or Address" }, "latitude": { "title": "Latitude", "type": "string", "description": "", "default": "53.400002" }, "longitude": { "title": "Longitude", "type": "string", "description": "", "default": "-2.983333" }, "radius": { "title": "Radius distance", "type": "string", "description": "", "default": "0.5" }, "includeExtendedInfo": { "title": "Include extended information", "type": "boolean", "description": "Including extended restaurant information. This will increase the resource consumption proportional to number of restaurants.", "default": false }, "includeReviews": { "title": "Include reviews (20)", "type": "boolean", "description": "Including reviews of restaurants. This will increase the resource consumption proportional to number of restaurants.", "default": false }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used by your crawler." } } }, "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 } } }, "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 } } } } } } } } } } ```