TheFork Scraper
Pricing
from $1.20 / 1,000 restaurants
TheFork Scraper
Scrape TheFork restaurants from city listings or restaurant URLs, with optional details, reviews, and availability calendar in one row per restaurant.
Pricing
from $1.20 / 1,000 restaurants
Rating
0.0
(0)
Developer
Data Scrapers
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
22 days ago
Last modified
Categories
Features
Share
TheFork Scraper creates a structured dataset of restaurants collected from TheFork. Each dataset item is one restaurant and can include the restaurant id, name, cuisine, rating, review count, average price, address, bookable flag, and, when requested, details, reviews, and availability dates. Query the source with a city listing URL or a restaurant URL, or with a search phrase. Control the result limit with maxItems. Retrieve records through the Apify Dataset API or export them as JSON, CSV, Excel, XML, or another supported format.
Dataset at a glance
| Property | Value |
|---|---|
| Source | thefork.com and country sites such as thefork.de |
| Record unit | One restaurant |
| Input methods | startUrls or searchQueries |
| Main identifiers | restaurantId, url |
| Delivery | Apify Dataset and API |
| Export formats | JSON, CSV, Excel, XML |
| Update model | Fresh records per Actor run |
| Pricing | $1.50 per 1,000 events on the Free plan for restaurants, details, reviews, and calendar dates. Platform usage is not billed separately. |
Coverage and available records
startUrls accepts TheFork city listing URLs and restaurant URLs. searchQueries are search phrases used when you are not passing URLs. maxItems of 0 does not add a restaurant cap. scrapeRestaurantDetails defaults to true and charges restaurant-details when the detail payload is saved. scrapeReviews charges one reviews event per saved review, up to maxReviews. maxReviews of 0 does not add a per-restaurant review cap. scrapeCalendar charges one calendar event per saved availability date, up to maxCalendarDates, for partySize.
The dataset stays one row per restaurant. Reviews and dates are nested on that row. A restaurant that is not bookable can still be saved with isBookable false.
Data dictionary
| Field | Type | Nullable | Description | Example |
|---|---|---|---|---|
| restaurantId | string | no | TheFork restaurant id. Deduplication key. | 845110 |
| name | string | yes | Restaurant name | Annam 2 (Barmbek) |
| url | string | yes | Restaurant page | https://www.thefork.de/restaurant/annam-2-barmbek-r845110 |
| listingUrl | string | yes | City or search page that produced the row | https://www.thefork.de/restaurants/hamburg-c205324 |
| cuisine | string | yes | Cuisine label | Asiatisch |
| rating | number | yes | TheFork rating | 9.2 |
| reviewCount | number | yes | Review count | 322 |
| averagePrice | object | yes | amount and currency | {"amount": 28.0, "currency": "EUR"} |
| address | object | yes | Street, city, and postal code | {"street": "Weidestraße 129", "city": "Hamburg", "zipCode": "22083"} |
| isBookable | boolean | yes | Booking flag | true |
| sourceQuery | string | yes | URL or query that produced the row | https://www.thefork.de/restaurants/hamburg-c205324 |
| details | object | yes | Detail payload when details are enabled | present |
| reviews | array | yes | Review objects when reviews are enabled | present |
| calendar | array | yes | Availability dates when the calendar is enabled | present |
Example dataset record
{"restaurantId": "845110","name": "Annam 2 (Barmbek)","url": "https://www.thefork.de/restaurant/annam-2-barmbek-r845110","listingUrl": "https://www.thefork.de/restaurants/hamburg-c205324","cuisine": "Asiatisch","rating": 9.2,"reviewCount": 322,"averagePrice": {"amount": 28.0, "currency": "EUR", "rawValue": 2800},"address": {"street": "Weidestraße 129","city": "Hamburg","zipCode": "22083","country": "Deutschland"},"isBookable": true,"sourceQuery": "https://www.thefork.de/restaurants/hamburg-c205324"}
This row came from the Hamburg city listing https://www.thefork.de/restaurants/hamburg-c205324. Review text and calendar dates are nested on the same row when those inputs are enabled. They are omitted here so the example stays a single restaurant record.
Query and input reference
| Input | Type | Required | Default | Accepted values | Description |
|---|---|---|---|---|---|
| searchQueries | array | no | empty | Phrases | Search text. |
| startUrls | array | no | empty | City or restaurant URLs | Direct TheFork URLs. |
| maxItems | integer | no | 0 | Integer | Maximum restaurants. 0 does not add a cap. |
| scrapeRestaurantDetails | boolean | no | true | true, false | Fetch details. Charges restaurant-details. |
| scrapeReviews | boolean | no | true | true, false | Fetch reviews. Charges reviews. |
| maxReviews | integer | no | 0 | Integer | Reviews per restaurant. 0 does not add a cap. |
| scrapeCalendar | boolean | no | true | true, false | Fetch availability. Charges calendar. |
| maxCalendarDates | integer | no | 0 | Integer | Dates per restaurant. 0 does not add a cap. |
| partySize | integer | no | 2 | Integer | Party size for the calendar. |
| maxConcurrency | integer | no | 5 | Integer | Parallel restaurant fetches. |
| proxyConfiguration | object | no | Apify residential | Apify proxy input | Proxy used for TheFork requests. |
Minimal request:
{"startUrls": [{ "url": "https://www.thefork.de/restaurants/hamburg-c205324" }],"maxItems": 5,"scrapeReviews": false,"scrapeCalendar": false}
Retrieve the data through the API
Start the Actor with JSON input, wait for the run, then read the default dataset. Other languages are on the Actor API tab.
from apify_client import ApifyClientclient = ApifyClient("<YOUR_API_TOKEN>")run = client.actor("datascrapers/thefork-scraper").call(run_input={"startUrls": [{"url": "https://www.thefork.de/restaurants/hamburg-c205324"}],"maxItems": 5,"scrapeReviews": False,"scrapeCalendar": False,})for item in client.dataset(run["defaultDatasetId"]).iterate_items():print(item["restaurantId"], item.get("name"))
Data quality and record handling
Use restaurantId as the deduplication key. averagePrice.amount is the major currency unit and rawValue is the source integer, 2800 for 28.00 EUR on the example row. Ratings are numbers. One dataset row holds one restaurant even when reviews and dates are nested. A detail request that fails can still leave the listing fields on the row. The example uses a restaurant name, not a person name.
Pricing and cost examples
| Event | Free | Bronze | Silver | Gold |
|---|---|---|---|---|
| restaurant | $1.50 | $1.40 | $1.30 | $1.20 |
| restaurant-details | $1.50 | $1.40 | $1.30 | $1.20 |
| reviews | $1.50 | $1.40 | $1.30 | $1.20 |
| calendar | $1.50 | $1.40 | $1.30 | $1.20 |
Prices are per 1,000 events. Platinum and Diamond use the Gold price. Platform usage is not billed on top of these events. A Free-plan run that saves 1,000 restaurants with details costs $3.00 before reviews and calendar dates. Each saved review and each saved date is its own event.
Limitations and responsible data use
TheFork can change city pages, require a proxy, or return an empty calendar for a party size. Availability is the response for that request, not a reservation. Use the data under TheFork's terms and applicable privacy rules. Do not treat a missing calendar as proof that the restaurant is closed.
Dataset questions
Why is the default run larger than the restaurant count?
scrapeRestaurantDetails, scrapeReviews, and scrapeCalendar default to true. Turn the ones you do not need to false, and set maxReviews and maxCalendarDates.
Are reviews separate dataset rows?
No. Reviews stay on the restaurant row. Each saved review is still a reviews charge event.
Which field should I store as the key?
Store restaurantId. It is the id in the restaurant URL.
Related datasets from Data Scrapers
- Subito.it Scraper for Italian classified ads.
- MediaMarkt Germany Product Scraper for German electronics products.
- Company Services Finder for company service labels.
- Chargefinder Scraper for public charging stations.
- Daft.ie Property Scraper for Irish property listings.
Data Scrapers support
Questions about this dataset: stardustspotlight@gmail.com
