TheFork Scraper avatar

TheFork Scraper

Pricing

from $1.20 / 1,000 restaurants

Go to Apify Store
TheFork Scraper

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

Data Scrapers

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

22 days ago

Last modified

Categories

Features

Limited permissions

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.

TheFork Scraper — city listing to restaurant rows

Dataset at a glance

PropertyValue
Sourcethefork.com and country sites such as thefork.de
Record unitOne restaurant
Input methodsstartUrls or searchQueries
Main identifiersrestaurantId, url
DeliveryApify Dataset and API
Export formatsJSON, CSV, Excel, XML
Update modelFresh 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

FieldTypeNullableDescriptionExample
restaurantIdstringnoTheFork restaurant id. Deduplication key.845110
namestringyesRestaurant nameAnnam 2 (Barmbek)
urlstringyesRestaurant pagehttps://www.thefork.de/restaurant/annam-2-barmbek-r845110
listingUrlstringyesCity or search page that produced the rowhttps://www.thefork.de/restaurants/hamburg-c205324
cuisinestringyesCuisine labelAsiatisch
ratingnumberyesTheFork rating9.2
reviewCountnumberyesReview count322
averagePriceobjectyesamount and currency{"amount": 28.0, "currency": "EUR"}
addressobjectyesStreet, city, and postal code{"street": "Weidestraße 129", "city": "Hamburg", "zipCode": "22083"}
isBookablebooleanyesBooking flagtrue
sourceQuerystringyesURL or query that produced the rowhttps://www.thefork.de/restaurants/hamburg-c205324
detailsobjectyesDetail payload when details are enabledpresent
reviewsarrayyesReview objects when reviews are enabledpresent
calendararrayyesAvailability dates when the calendar is enabledpresent

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

InputTypeRequiredDefaultAccepted valuesDescription
searchQueriesarraynoemptyPhrasesSearch text.
startUrlsarraynoemptyCity or restaurant URLsDirect TheFork URLs.
maxItemsintegerno0IntegerMaximum restaurants. 0 does not add a cap.
scrapeRestaurantDetailsbooleannotruetrue, falseFetch details. Charges restaurant-details.
scrapeReviewsbooleannotruetrue, falseFetch reviews. Charges reviews.
maxReviewsintegerno0IntegerReviews per restaurant. 0 does not add a cap.
scrapeCalendarbooleannotruetrue, falseFetch availability. Charges calendar.
maxCalendarDatesintegerno0IntegerDates per restaurant. 0 does not add a cap.
partySizeintegerno2IntegerParty size for the calendar.
maxConcurrencyintegerno5IntegerParallel restaurant fetches.
proxyConfigurationobjectnoApify residentialApify proxy inputProxy 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 ApifyClient
client = 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

EventFreeBronzeSilverGold
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.

Data Scrapers support

Questions about this dataset: stardustspotlight@gmail.com