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

{
    "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

{
    "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

{
    "_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
3. 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