TheFork Restaurant Intelligence API
TheFork Restaurant Intelligence API - Your complete solution for European restaurant data extraction. What You Can Do Restaurant Data Extraction Full restaurant listings - Names, ratings, prices, cuisines, addresses, coordinates Multi-country support - France, Italy, Spain, Belgium, Netherlands, Portugal, Switzerland, Germany, Austria, UK Bulk extraction - Up to 500 restaurants per request Fresh…
5 subscribers
19 endpoints
The in-depth APIMemo review for this API hasn't been published yet —
the data below comes straight from the public marketplace listing.
TheFork Restaurant Intelligence API endpoints
| Method | Endpoint | Description |
|---|---|---|
| Data Extraction | ||
| POST |
scrapeRestaurants /restaurants |
Extract restaurant listings from TheFork city pages. ## What You Get For each restaurant, you receive: - **Basic Info**: Name, ID, URL, slug - **Ratings**: Overall score (0-10),… |
| POST |
scrapeMenu /menu |
Extract full menu data and photos from TheFork restaurant pages. ## What You Get **Menu Data:** - **À La Carte**: Individual dishes with names, descriptions, and prices - **Set… |
| POST |
scrapeReviews /reviews |
Extract customer reviews from TheFork restaurant pages. ## What You Get For each review, you receive: - **Ratings**: Overall score (0-10), food rating, service rating, ambiance… |
| Data Export | ||
| POST |
exportReviews /export/reviews |
Export customer reviews in your preferred format. Supports the same formats and options as restaurant export. ## Use Cases - **Sentiment Analysis**: Export to CSV for analysis in… |
| GET |
getExportFormats /export/formats |
Returns the export formats available for your subscription plan. | Plan | Available Formats | |------|-------------------| | Basic (Free) | JSON | | Pro ($39/mo) | JSON, CSV | |… |
| POST |
exportRestaurants /export/restaurants |
Export restaurant data in your preferred format. ## Supported Formats - **JSON**: Structured data, best for programmatic processing - **CSV**: Spreadsheet-compatible, flattened… |
| Monitoring | ||
| POST |
createRestaurantMonitor /monitoring/restaurants |
Set up automated monitoring for a specific restaurant. **Requires Pro plan ($39/mo) or higher.** ## What You Can Track - **Rating Changes**: Get notified when the restaurant's… |
| POST |
createCityMonitor /monitoring/cities |
Monitor a city for new restaurant openings on TheFork. **Requires Pro plan ($39/mo) or higher.** ## What You Can Track - **New Restaurants**: Get notified when new restaurants… |
| DELETE |
deleteMonitor /monitoring/{monitor_id} |
Remove a monitor and stop all future checks. Historical alerts are preserved for 30 days. **Requires Pro plan ($39/mo) or higher.** |
| GET |
getMonitoringAlerts /monitoring/alerts |
Retrieve alerts triggered by your monitors when changes are detected. **Requires Pro plan ($39/mo) or higher.** ## Alert Types - `rating_change`: Restaurant rating changed -… |
| GET |
getMonitorLimits /monitoring/limits |
Check how many monitors you can create based on your plan. **Requires Pro plan ($39/mo) or higher.** |
| GET |
listMonitors /monitoring/list |
Get a list of all your active and paused monitoring alerts. **Requires Pro plan ($39/mo) or higher.** |
| Webhooks | ||
| GET |
getWebhookLogs /webhooks/logs |
View the delivery history for your webhooks, including success/failure status. **Requires Pro plan ($39/mo) or higher.** |
| POST |
setupWebhook /webhooks/setup |
Set up a webhook to receive real-time POST notifications when data changes. **Requires Pro plan ($39/mo) or higher.** ## How Webhooks Work 1. You provide a `callback_url` on your… |
| GET |
listWebhooks /webhooks/list |
Get a list of all your registered webhooks. **Requires Pro plan ($39/mo) or higher.** |
| DELETE |
deleteWebhook /webhooks/{webhook_id} |
Remove a webhook and stop all future notifications. **Requires Pro plan ($39/mo) or higher.** |
| Utility | ||
| GET |
healthCheck /health |
Simple health check endpoint to verify the API is operational. Returns `200 OK` if the API is healthy. No authentication required. |
| GET |
getApiInfo /info |
Returns information about your current subscription plan, rate limits, and supported countries. Use this endpoint to: - Check your current plan - See your rate limits - Verify… |
| GET |
listCities /cities |
Get a list of cities available for scraping, with their TheFork URLs. Use the URLs from this endpoint as input for the `/restaurants` endpoint. You can filter by country code to… |
TheFork Restaurant Intelligence API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 1 / second |
|
| PRO | $29 / month | 5 / second |
|
| ULTRA Recommended | $49 / month | 10 / second |
|
| MEGA | $149 / month | 10 / second |
|
