TheFork Restaurant & Reviews Scraper 🍽️ Professional-grade Apify Actor for extracting comprehensive restaurant and review data from TheFork.com platform. This scraper provides rich, structured data perfect for market analysis, competitive intelligence, and business insights. ## 🌟 Key Features ### Comprehensive Data Extraction - Restaurant Discovery: Extract detailed restaurant information from city pages - Review Mining: Collect in-depth customer reviews and ratings - Multi-URL Support: Process up to 5 URLs in a single run - Smart Pagination: Automatically handles multiple pages of results - Proxy Rotation: Built-in proxy support with automatic rotation for reliable scraping - Auto BUILD_ID Management: Automatic detection and updating of Next.js build IDs ### Rich Data Points #### Restaurant Data Includes: - Identity: Name, ID, URLs, location details - Ratings: TheFork ratings, TripAdvisor ratings, review counts - Cuisine: Primary cuisine, specialties, dietary options (vegan, gluten-free, etc.) - Pricing: Average price, price level, currency - Features: WiFi, parking, terrace, wheelchair access, payment methods - Awards: Michelin stars, Bib Gourmand, certifications - Marketing: Special offers, promotions, discounts - Media: Photos, photo counts, main image - Atmosphere: Ambiance type, suitable occasions (romantic, business, family) - Operational: Booking availability, opening status #### Review Data Includes: - Rating: Overall rating value (0-10 scale) - Content: Review text, photo count and URLs - Visit Date: Date and time of the meal experience - Reviewer: First name, last name, avatar URL, total review count - Restaurant Reply: Reply text and status if restaurant responded - Engagement: Number of likes received - Metadata: Scraping timestamp, source URL, restaurant information ## 🚀 Quick Start ### Input Configuration json { "urls": [ "https://www.thefork.com/restaurants/lisbon-c522301", "https://www.thefork.com/restaurant/la-petite-maison-r324851" ], "mode": "restaurants", "maxRestaurantsPerCity": 100, "includeReviews": false, "maxReviewsPerRestaurant": 50, "reviewsForLastNDays": 30, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "FR" } } ### Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | urls | Array | Yes | - | TheFork URLs to scrape (max 5) | | mode | String | No | "restaurants" | Scraping mode: "restaurants" or "reviews" | | maxRestaurantsPerCity | Number | No | 100 | Maximum restaurants to extract per city URL (restaurants mode) | | reviewsForLastNDays | Number | No | 0 | Extract reviews from last N days. 0 = all reviews (reviews mode) | | includeReviews | Boolean | No | false | Include reviews when scraping restaurants | | maxReviewsPerRestaurant | Number | No | 100 | Max reviews per restaurant | | proxyConfiguration | Object | No | - | Proxy settings for Apify proxy | | debugMode | Boolean | No | false | Enable detailed logging for debugging | ## 📊 Output Format ### Restaurant Object json { "id": "324851", "uuid": "abc-123-def-456", "name": "La Petite Maison", "slug": "la-petite-maison", "address": { "street": "15 Rue Saint-Benoît", "zipCode": "75006", "locality": "Paris", "country": "France" }, "geolocation": { "latitude": 48.8534, "longitude": 2.3335 }, "rating": { "score": 9.2, "reviewCount": 1523 }, "cuisine": "Mediterranean", "priceLevel": 3, "avgPrice": { "value": 6500, "currency": "EUR", "formatted": "65.00 EUR" }, "isBookable": true, "isStartPackage": false, "badges": [ { "type": "MICHELIN", "label": "Michelin 1 Star" } ], "highlightedTags": [ { "id": "tag-1", "text": "Romantic", "type": "ATMOSPHERE" } ], "tags": { "payment": ["Visa", "Mastercard", "Amex"], "features": ["WiFi", "Terrace"], "cuisine": ["Mediterranean", "French"], "atmosphere": ["Romantic", "Business Lunch"], "dietary": ["Vegetarian Options", "Gluten-Free Options"] }, "mainPhoto": { "url": "https://example.com/photo.jpg", "alt": "Restaurant interior" }, "photos": 45, "hasOffer": true, "offer": { "label": "-30% on the menu", "title": "Special Lunch Offer", "type": "DISCOUNT", "discount": 30 }, "canBurnYums": true, "timeslots": [ { "time": "19:00", "hasAvailability": true, "canBurnYums": false } ], "reviewsSummary": "Excellent food and service", "reviewSnippets": ["Amazing experience", "Will come back"], "topChart": "Top 10 in Paris", "_type": "restaurant", "_source": "TheFork Search API", "_scrapedAt": "2025-09-10T10:30:00Z" } ### Review Object json { "_type": "review", "id": "b20cf8b1-2245-4ffc-8380-9db89cefe2b5", "restaurantId": "6459fd08-35f0-49f0-bc87-0e9abe542d80", "restaurantName": "La reine du kashmir", "ratingValue": 10, "reviewText": "Je recommande vivement en plat le BIRYANI MAISON...", "hasReview": true, "mealDate": "2025-09-09T17:30:00.000Z", "reviewerId": "a6207cf0-d363-4d4a-9fdd-68874c03865e", "reviewerFirstName": "Patricia", "reviewerLastName": "B.", "reviewerName": "Patricia B.", "reviewerAvatarUrl": "", "reviewerReviewCount": 64, "hasReply": false, "restaurantReply": "", "restaurantReplyStatus": "", "hasPhotos": false, "photoCount": 0, "photoUrls": "", "likes": 0, "keywordsPosition": "", "_source": "TheFork", "_scrapedAt": "2025-08-08T23:16:29.011Z", "_restaurantName": "La reine du kashmir", "_sourceUrl": "https://www.thefork.com/restaurant/la-reine-du-kashmir-r807560" } ## 🎯 Use Cases ### Market Research - Analyze restaurant competition in specific cities - Track pricing trends across different cuisines - Monitor customer sentiment and satisfaction ### Business Intelligence - Identify top-performing restaurants by ratings - Analyze review patterns and customer preferences - Track special offers and promotions ### Investment Analysis - Evaluate restaurant performance metrics - Identify emerging food trends - Assess market saturation in different areas ### Customer Insights - Understand dining preferences by location - Analyze review sentiment and feedback - Track seasonal dining patterns ## 🛠️ Advanced Features ### Review Date Filtering - Time-based extraction: Get reviews from the last N days - Flexible configuration: Set to 0 to extract all available reviews - Date metadata: Returns information about the covered date range ### Data Quality Indicators Each record includes quality metrics: - Data Quality Score: Excellent/Good/Fair/Poor - Completeness Percentage: 0-100% - Review Quality Assessment: Based on length, photos, reviewer credibility ### Smart Data Enrichment - Automatic sentiment analysis for reviews - Price category classification - Michelin star detection from tags - Dietary option extraction - Atmosphere and occasion suitability analysis ## 📈 Performance - Speed: ~500-1000 restaurants per minute - Reviews: ~400-1000 reviews per minute - Memory: Optimized for 256-512 MB usage - Reliability: 99%+ success rate with proxies ### Supported URL Formats #### City Pages (Restaurant Mode) https://www.thefork.com/restaurants/{city}-c{cityId} https://www.thefork.com/restaurants/lisbon-c522301 #### Restaurant Pages (Review Mode) https://www.thefork.com/restaurant/{name}-r{id} https://www.thefork.com/restaurant/{name}/{uuid} ## 🚨 Important Notes 1. Proxy Usage: For production use, enable proxy configuration to avoid rate limiting 2. URL Limits: Maximum 5 URLs per run to ensure optimal performance 4. Rate Limiting: Built-in delays between requests to respect server resources ## 📝 Changelog ### Version 2.1.0 (September 2025) - Added review date filtering with reviewsForLastNDays parameter - Added proxy pool management for improved reliability - Enhanced error handling and logging - Improved data output formatting for Apify Console ### Version 2.0.0 - Multi-URL support - Dual-mode operation (restaurants/reviews) - Pagination support - Review fetching for restaurants - Enhanced data structure with comprehensive fields - Added data quality indicators ## 🤝 Support For issues, questions, or feature requests, please contact the developer or create an issue in the Apify console. ## 📄 License This Actor is provided under the Apache 2.0 License. Use it responsibly and in accordance with TheFork's Terms of Service. --- Built with ❤️ for the Apify community