🍽️ TheFork Restaurant Scraper

---

🌟 Features

Comprehensive Data Extraction

• 📊 Restaurant Details: Names, addresses, coordinates, districts
• ⭐ Ratings & Reviews: Scores, review counts, badges (Top Rated, Great Deal)
• 💰 Pricing Information: Price ranges, average prices, currency
• 🍽️ Cuisine Types: Main cuisine, specialties, dietary options
• 🏆 Awards & Recognition: Michelin stars, INSIDER status, Gault & Millau
• 📸 Photos: Main photo, gallery images with alt texts
• 🎯 Booking Information: Availability, special offers, loyalty programs
• 🗺️ Location Data: GPS coordinates, full addresses, districts

Flexible Output Formats

• JSON: Structured data with full details
• CSV: Spreadsheet-compatible format
• XML: Machine-readable structured format
• HTML: Beautiful visual report with statistics

Advanced Features

• 🔄 Automatic Pagination: Fetches multiple pages of results
• 🛡️ Proxy Support: Configure datacenter or residential proxies
• ⚡ Fast & Efficient: Direct API access, no browser needed
• 📈 Statistics Generation: Automatic analysis of scraped data
• 🔁 Retry Logic: Handles network errors gracefully

---

📋 Input Parameters

Parameter	Type	Required	Default	Description
pageUrl	String	✅ Yes	-	TheFork city page URL (e.g., https://www.thefork.com/restaurants/paris-c415144)
maxRestaurants	Integer	❌ No	100	Maximum number of restaurants to scrape (1-1000)
outputFormat	Array	❌ No	["json"]	Output formats: json, csv, xml, html
proxyConfiguration	Object	❌ No	-	Proxy settings for the scraper

Example Input

{
    "pageUrl": "https://www.thefork.com/restaurants/paris-c415144",
    "maxRestaurants": 200,
    "outputFormat": ["json", "csv", "html"],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["DATACENTER"],
        "apifyProxyCountry": "FR"
    }
}

---

📦 Output Schema

Restaurant Object Structure

{
    "id": "e3a4ef96-0b29-46b5-8ac6-66788a4c4435",
    "name": "Restaurant Auguste - Gaël Orieux",
    "slug": "restaurant-auguste-gael-orieux",
    "address": "54, rue de Bourgogne, 75007, Paris, France",
    "addressDetails": {
        "street": "54, rue de Bourgogne",
        "zipCode": "75007",
        "city": "Paris",
        "country": "France",
        "district": "Paris 7th"
    },
    "coordinates": {
        "latitude": 48.85616,
        "longitude": 2.31712
    },
    "rating": {
        "score": 9.4,
        "reviewCount": 3610,
        "badges": ["Top Rated"],
        "badgeTypes": ["TOP_RATED"]
    },
    "awards": {
        "michelin": true,
        "michelinStars": 1,
        "michelinType": "MICHELIN_1_star",
        "insider": true,
        "awardsList": ["1 star MICHELIN", "Gault & Millau 2020"]
    },
    "cuisine": "French",
    "cuisineTypes": ["French", "European"],
    "specialties": ["Lobster", "Oyster", "Truffle"],
    "pricing": {
        "amount": 100,
        "currency": "EUR",
        "priceLevel": 4
    },
    "priceRange": "€€€€",
    "mainPhoto": "https://res.cloudinary.com/...",
    "photos": [...],
    "paymentMethods": ["Credit Card", "Mastercard", "Visa"],
    "features": ["Air-conditioning", "Cellar", "English spoken"],
    "dietary": ["Gluten free", "Peanut allergy"],
    "atmosphere": ["Cosy", "Fine Dining", "Romantic"],
    "isBookable": true,
    "hasSpecialOffer": false,
    "acceptsYums": true,
    "bookingUrl": "https://www.thefork.com/restaurant/..."
}

Statistics Object

The scraper automatically generates statistics including:

• Average rating across all restaurants
• Total reviews count
• Cuisine distribution
• Price range distribution
• Awards count (Michelin, INSIDER)
• Number of bookable restaurants
• Top-rated restaurants list

---

🚀 Quick Start

Using Apify Console

1. Go to the Actor page
2. Enter a TheFork city URL (e.g., https://www.thefork.com/restaurants/paris-c415144)
3. Configure optional parameters
4. Click "Run"
5. Download results in your preferred format

Using Apify API

const { ApifyClient } = require('apify-client');

const client = new ApifyClient({
    token: 'YOUR_API_TOKEN',
});

const input = {
    pageUrl: 'https://www.thefork.com/restaurants/paris-c415144',
    maxRestaurants: 100,
    outputFormat: ['json', 'csv']
};

const run = await client.actor('jdtpnjtp/thefork-scraper').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();

Using Python

from apify_client import ApifyClient

client = ApifyClient('YOUR_API_TOKEN')

input_data = {
    'pageUrl': 'https://www.thefork.com/restaurants/paris-c415144',
    'maxRestaurants': 100,
    'outputFormat': ['json', 'csv']
}

run = client.actor('jdtpnjtp/thefork-scraper').call(run_input=input_data)
items = client.dataset(run['defaultDatasetId']).list_items().items

---

🌍 Supported All possible locations

The scraper works with any valid TheFork city URL. Examples:

• Paris: https://www.thefork.com/restaurants/paris-c415144
• London: https://www.thefork.com/restaurants/london-c72796
• Barcelona: https://www.thefork.com/restaurants/barcelona-c664538
• Rome: https://www.thefork.com/restaurants/rome-c323978
• Amsterdam: https://www.thefork.com/restaurants/amsterdam-c696247

---

💡 Use Cases

🏢 Business Intelligence

• Market analysis and competitor research
• Pricing strategy optimization
• Location planning for new restaurants
• Cuisine trend analysis

📊 Data Analysis

• Restaurant rating patterns
• Price vs. quality correlations
• Geographic distribution studies
• Award-winning restaurant analysis

🎯 Marketing & Sales

• Lead generation for B2B services
• Targeted marketing campaigns
• Partnership opportunities identification
• Event planning and catering services

🔬 Academic Research

• Tourism and hospitality studies
• Urban planning research
• Economic impact analysis
• Consumer behavior studies

---

⚙️ Advanced Configuration

Proxy Configuration

For better performance and to avoid rate limiting:

{
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "FR"
    }
}

Multiple Output Formats

Generate multiple output formats in a single run:

{
    "outputFormat": ["json", "csv", "xml", "html"]
}

Files will be available in the Key-Value store:

• restaurants.csv - CSV export
• restaurants.xml - XML export
• report.html - Visual HTML report

---

📈 Performance

Metric	Value
Average runtime	10-30 seconds per 100 restaurants
Memory usage	~128-256 MB
Success rate	>99%
Max restaurants	1000 per run

---

🔧 Troubleshooting

Common Issues

1. No restaurants found

• Verify the URL format is correct
• Check if the city exists on TheFork
• Ensure the cityId matches the city name

2. Rate limiting

• Enable proxy configuration
• Reduce the number of restaurants
• Add delays between requests

3. Invalid data

• The build ID might be outdated
• Contact support for updates

---

📝 Changelog

Version 2.0.0 (21.08.2025)

• Support for all major TheFork cities
• Multiple output formats
• Comprehensive data extraction
• Proxy support
• Statistics generation
• Fast Data extraction

---

💬 Support

• 📧 Telegram: Contact me

---