# Le Fooding Restaurant Guide Scraper — Avis, Prix, Chefs (`cyrilfaia/lefooding-fr-scraper`) Actor

Extrait le guide Le Fooding (France et Belgique) : restaurants par lieu, département, région, cuisine, prix, atouts, sélection et prix Fooding ; adresse géolocalisée, chefs, réservation ; en option la critique complète, horaires, téléphone, site.

- **URL**: https://apify.com/cyrilfaia/lefooding-fr-scraper.md
- **Developed by:** [Cyril Faia](https://apify.com/cyrilfaia) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $15.00 / 1,000 restaurants

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Le Fooding Restaurant Guide Scraper — Avis, Prix, Chefs

Structured access to **Le Fooding**, the independent French restaurant guide (France and Belgium, about 1 400 restaurants in the active selection, 3 000+ reviewed since 2000). Search **around a place** (geocoded, sorted by distance) or by **département / region**, then narrow by **cuisine or style, price band, practical features, editorial selection (Palmarès, Feeling, Trop bon) and Fooding prizes**. Every row carries the **name, editorial headline, review excerpt, categories, price band, features, badges, prizes, chefs, full address with GPS, booking method, photo and public URL**; the detail mode adds the **complete review, opening hours, phone, website, take-away, transport access and nearby restaurants**.

### Who uses it

- **Restaurant tech, booking and delivery platforms**: enrich venue databases with the guide's selection, categories and chefs.
- **Tourism, hospitality and concierge services**: curated shortlists by neighbourhood, style and budget, with hours and phone numbers.
- **Food and beverage suppliers, wine merchants, kitchen equipment**: prospect lists of independent restaurants by region and style.
- **Market research, press and real-estate**: density of Fooding-selected venues per area, awards over time, new openings (`publishedAt`).
- **AI agents**: "a Feeling-badged bistrot under 35 € within 2 km of Gare Saint-Charles, open on Sunday".

### Output example

```json
{
  "id": 81423,
  "url": "https://lefooding.com/restaurants/petrin-couchette",
  "slug": "petrin-couchette",
  "name": "Pétrin Couchette",
  "headline": null,
  "excerpt": "Tout le monde en gare de Marseille, la triplette qui a toujours un train d’avance a encore frappé ! …",
  "cuisine": ["Coffee shop", "Lèche-doigts", "Sandwichs"],
  "priceRange": "De 16 à 35 €",
  "priceBand": "from16to35",
  "features": ["Antidépresseur", "En continu", "Kid-friendly", "Ouvert le dimanche", "Terrasse"],
  "selection": ["Feeling"],
  "prizes": [],
  "chefs": ["Basile Milou"],
  "address": "7 Cours Belsunce, 13001 Marseille, France",
  "postcode": "13001",
  "city": "Marseille",
  "region": "Provence-Alpes-Côte d'Azur",
  "country": "FR",
  "latitude": 43.2989,
  "longitude": 5.3789,
  "distanceKm": 0.35,
  "bookingMethods": null,
  "image": "https://cdn.lefooding.com/medias/2026/…jpg",
  "publishedAt": "2026-05-12 09:14:33",
  "scrapedAt": "2026-09-17T15:40:12.000Z"
}
```

With `fetchDetails: true`: `review` (full text), `schedules`, `closing`, `phone`, `website`, `takeAway`, `transport`, `delivery`, `nearbyRestaurants`.

### Input

| Field | Type | Description |
|---|---|---|
| `locations` | string\[] | Places to search around (city, district, address). Geocoded; results sorted by distance. |
| `latitude`, `longitude` | number | Explicit search point. |
| `maxDistanceKm` | integer | Radius around each place (default 15, max 100). |
| `departments` | string\[] | Département numbers or names (`13`, `Gironde`). |
| `regions` | string\[] | Region names (`Île-de-France`, `Bretagne`, `Brussels`). |
| `cuisines` | string\[] | Guide categories, FR or EN (`Bistrot`, `Cuisine d'auteur`, `Italien`, `Fish and seafood`…). Any matches. |
| `priceRanges` | string\[] | `under15`, `from16to35`, `from36to50`, `over51`. |
| `features` | string\[] | `Terrasse`, `Ouvert le dimanche`, `Brunch`, `Kid-friendly`… Any matches. |
| `selection` | string\[] | `palmares`, `feeling`, `tropBon`. |
| `awardedOnly` | boolean | Only restaurants with a Fooding prize. |
| `query` | string | Name contains. |
| `country` | `all` / `FR` / `BE` | |
| `maxItems` | integer | Default 200, 0 = unlimited. |
| `fetchDetails` | boolean | Default false. |

With no location filter at all, the Actor walks the whole active guide.

Examples:

```json
{ "locations": ["Paris 11e"], "maxDistanceKm": 3, "priceRanges": ["from16to35"], "features": ["Ouvert le dimanche"], "maxItems": 100 }
```

```json
{ "regions": ["Provence-Alpes-Côte d'Azur"], "cuisines": ["Bistrot", "Cuisine d'auteur"], "selection": ["feeling", "palmares"], "fetchDetails": true }
```

```json
{ "awardedOnly": true, "maxItems": 0 }
```

### Pricing

Pay per event: one **restaurant** event per row, one **restaurant detail** event per full record, plus a small **Actor start** fee. The Actor reads the guide's public JSON API directly: no browser, no proxy overhead, runs finish in seconds.

### Notes

- Places are geocoded with OpenStreetMap Nominatim (one request per place); the guide's own geo search returns venues within about 100 km sorted by distance, then the Actor keeps those within `maxDistanceKm`.
- Filters of different kinds are combined with AND; values inside one filter are OR-ed.
- Contact data is the restaurants' public business data as published by the guide. Chefs are named as in the guide's editorial content.
- Reviews and photos belong to Le Fooding; use the output for research, mapping and prospecting in compliance with the site's terms.

# Actor input Schema

## `locations` (type: `array`):

Cities, neighbourhoods or addresses in France or Belgium (e.g. "Marseille", "Paris 11e", "Bruxelles"). Each place is geocoded and restaurants are returned by distance within maxDistanceKm.

## `latitude` (type: `number`):

Optional explicit search point (with longitude). Used in addition to locations.

## `longitude` (type: `number`):

Optional explicit search point (with latitude).

## `maxDistanceKm` (type: `integer`):

Radius around each place. The guide returns restaurants up to about 100 km sorted by distance; rows beyond this radius are dropped.

## `departments` (type: `array`):

French département numbers or names ("13", "Bouches-du-Rhône", "75"). Used when no place is given, or in addition to places.

## `regions` (type: `array`):

Region names as used by the guide ("Île-de-France", "Provence-Alpes-Côte d'Azur", "Bretagne", "Flanders", "Brussels").

## `cuisines` (type: `array`):

Guide categories, French or English: "Bistrot", "Cuisine d'auteur", "Néobistrot", "Poissons et fruits de mer", "Italien", "Japonais", "Bar à vins / Cave à manger", "Terroir", "Végétarien", "Pizza"… Any of them matches.

## `priceRanges` (type: `array`):

Guide price bands per person: under15 (< 15 €), from16to35, from36to50, over51.

## `features` (type: `array`):

Practical tags: "Terrasse", "Ouvert le dimanche", "Ouvert le lundi", "Brunch", "Antidépresseur", "Voir et se faire voir", "Bon plan", "Enfants bienvenus"… Any of them matches.

## `selection` (type: `array`):

Editorial badges: palmares (award list), feeling (the guide's favourites), tropBon ("Trop bon").

## `awardedOnly` (type: `boolean`):

Keep only restaurants with at least one Fooding prize ("Fooding d'honneur", "Meilleur restaurant", …).

## `query` (type: `string`):

Keep only restaurants whose name contains this text (accent-insensitive).

## `country` (type: `string`):

The guide covers France and Belgium.

## `maxItems` (type: `integer`):

Stop after this many restaurants (0 = no limit, about 1 400 in the active guide).

## `fetchDetails` (type: `boolean`):

Also read each restaurant's full record: the complete review, opening hours, phone, website, booking, transport, take-away, nearby restaurants (one 'restaurant-detail' event per row instead of 'restaurant').

## `proxyConfiguration` (type: `object`):

Not needed for this source; datacenter proxies are used by default.

## Actor input object example

```json
{
  "locations": [
    "Marseille"
  ],
  "maxDistanceKm": 15,
  "departments": [],
  "regions": [],
  "cuisines": [],
  "priceRanges": [],
  "features": [],
  "selection": [],
  "awardedOnly": false,
  "country": "all",
  "maxItems": 200,
  "fetchDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `restaurants` (type: `string`):

Dataset items, one per restaurant (JSON).

## `restaurantsCsv` (type: `string`):

Same dataset as CSV.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "locations": [
        "Marseille"
    ],
    "departments": [],
    "regions": [],
    "cuisines": [],
    "priceRanges": [],
    "features": [],
    "selection": [],
    "query": "",
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("cyrilfaia/lefooding-fr-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "locations": ["Marseille"],
    "departments": [],
    "regions": [],
    "cuisines": [],
    "priceRanges": [],
    "features": [],
    "selection": [],
    "query": "",
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("cyrilfaia/lefooding-fr-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "locations": [
    "Marseille"
  ],
  "departments": [],
  "regions": [],
  "cuisines": [],
  "priceRanges": [],
  "features": [],
  "selection": [],
  "query": "",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call cyrilfaia/lefooding-fr-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,cyrilfaia/lefooding-fr-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/V5WaGjMTDVZy8qAlG/builds/QGsm4UmD6zPJiXb5X/openapi.json