# Gault\&Millau France Guide Scraper — Notes, Toques, Chefs (`cyrilfaia/gaultmillau-fr-scraper`) Actor Extrait les restaurants du guide Gault\&Millau France : note sur 20, toques, chef, cuisine, prix moyen, adresse géolocalisée, horaires ; en option la critique complète, la carte et les prix. Filtres par ville, département, toques, note, cuisine. - **URL**: https://apify.com/cyrilfaia/gaultmillau-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 ## Gault\&Millau France Restaurant Guide Scraper — Notes, Toques, Chefs The complete **Gault\&Millau France** selection as structured data: 6 000+ restaurants with the guide's **rating out of 20**, **toques (0–5)**, **chef**, **cuisine**, **occasions and services**, **average price**, **geocoded address**, **opening slots** and the **public guide URL**. Filter by city, département or region, minimum toques or rating, cuisine, and free text. Optional detail mode adds the **full guide review with its edition year**, the **menu with dish prices**, style and extras, **website, social links and the establishment phone**. This is the only Actor on Apify Store covering the Gault\&Millau guide. It reads the guide's own public search engine and pages, with no browser, no login and no proxy overhead: fast, cheap to run, stable. ### Who uses it - **Hospitality software and booking platforms**: enrich venue databases with guide ratings and toques. - **PR, media and food journalism**: track new entries, rating changes and rising chefs by region. - **Market research and tourism boards**: density of rated restaurants, price bands and cuisines per territory. - **Suppliers and wine merchants**: prospect lists of gastronomic restaurants with chefs' names and business contacts. - **AI agents**: structured answers to "best 3-toque restaurants near Lyon under 80 €". ### Output example Listing mode: ```json { "id": "0708c583-2de8-41be-8250-c8226e8a3e35", "url": "https://fr.gaultmillau.com/fr/restaurants/lima-lemon", "name": "Lima Lemon", "mark": 10, "toques": 0, "reviewYear": 2027, "chef": "Avi Nurul Choiria", "cuisine": ["Péruvien", "Tapas"], "moment": ["Entre amis", "En famille", "Décontracté"], "services": [], "averagePrice": null, "hasHotel": false, "address": "24 rue Saint-Sébastien, 13006 Marseille 6", "postcode": "13006", "city": "Marseille", "district": "6e Arr.", "department": "Bouches-du-Rhône", "region": "Provence-Alpes-Côte d'Azur", "latitude": 43.285269, "longitude": 5.382569, "openings": [{ "day": "monday", "begin": "12:00", "end": "14:00" }, "…"], "publishedDate": "2023-02-28T15:18:20.114Z", "scrapedAt": "2026-09-17T14:02:11.000Z" } ``` Detail mode (`fetchDetails: true`) adds: ```json { "review": "Cette maison est unique, Danièle et Bernard Pacaud l'ont voulue et construite ainsi…", "reviewEdition": 2026, "reviewDate": "2025-10-02T09:04:18.999Z", "practical": { "Chef": "Shintaro Awa", "Cuisine": "Cuisine d'auteur | Français | Gastronomique", "Truc en +": "Service voiturier", "Style": "Elégant | Romantique" }, "menuType": "A la carte", "menu": [{ "category": "Entrée", "name": "Chaud-froid d'oeuf mollet au cresson, asperges vertes et caviar", "price": 135, "priceText": "135 €" }, "…"], "website": "http://www.ambroisie-paris.com/", "phone": "+33142785145", "socials": ["https://www.instagram.com/ambroisieparis/"], "image": "https://assets.gaultmillau.com/assets/…", "keywords": ["Cuisine d'auteur", "restaurant gastronomique", "…"] } ``` ### Input | Field | Type | Description | |---|---|---| | `locations` | string\[] | Cities, départements or regions, one per line. Empty = all of France. | | `query` | string | Free text: name, chef or cuisine. | | `minToques` | integer | 0–5. | | `minMark` | integer | Minimum rating out of 20. | | `cuisines` | string\[] | Cuisine labels as used by the guide (e.g. `Gastronomique`, `Bistronomique`, `Japonais`). | | `sort` | string | `markDesc` (default), `toquesDesc`, `relevance`, `newest`. | | `maxItems` | integer | Stop after this many restaurants (0 = unlimited). Default 200. | | `fetchDetails` | boolean | Visit each restaurant page. Default false. | Examples: ```json { "locations": ["Bouches-du-Rhône", "Var"], "minToques": 2, "sort": "markDesc" } ``` ```json { "locations": ["Lyon"], "cuisines": ["Gastronomique"], "fetchDetails": true, "maxItems": 50 } ``` ```json { "query": "Ducasse", "maxItems": 20 } ``` ### Pricing Pay per event: one **restaurant** event per row in listing mode, one **restaurant detail** event per enriched page, plus a small **Actor start** fee. The whole French selection (6 000+ rated restaurants with chef, rating, toques and coordinates) costs less than a single restaurant guide subscription. ### Notes - Ratings, toques and reviews are editorial content of Gault\&Millau; use them with attribution and in compliance with the guide's terms. Phone and website are the establishments' public business contacts. - The Actor reads the search configuration from the live site at each run, so it keeps working if the guide rotates its search key. - Opening slots reflect the guide's data and may lag the restaurant's actual hours. # Actor input Schema ## `locations` (type: `array`): Une localité par ligne : ville (« Marseille », « Lyon »), département (« Bouches-du-Rhône », « Gironde ») ou région (« Bretagne »). Vide = toute la France. ## `query` (type: `string`): Texte recherché dans le nom, le chef ou la cuisine (ex. « Ducasse », « japonais »). Optionnel. ## `minToques` (type: `integer`): 0 à 5. ## `minMark` (type: `integer`): Note Gault\&Millau minimale. ## `cuisines` (type: `array`): Filtre sur la cuisine (ex. « Gastronomique », « Bistronomique », « Japonais »). Vide = toutes. ## `sort` (type: `string`): Ordre des résultats. ## `maxItems` (type: `integer`): 0 = illimité (6 000+ pour toute la France). ## `fetchDetails` (type: `boolean`): Visite chaque fiche : critique complète du guide et son millésime, carte et prix des plats, style, atouts, site web et réseaux sociaux, téléphone de l'établissement. Facturé par fiche. ## `proxyConfiguration` (type: `object`): Proxy Apify (datacenter suffit). ## Actor input object example ```json { "locations": [ "Marseille" ], "minToques": 0, "minMark": 0, "cuisines": [], "sort": "markDesc", "maxItems": 200, "fetchDetails": false, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `restaurants` (type: `string`): One item per restaurant. ## `restaurantsCsv` (type: `string`): No description # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "locations": [ "Marseille" ], "cuisines": [], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("cyrilfaia/gaultmillau-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "locations": ["Marseille"], "cuisines": [], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("cyrilfaia/gaultmillau-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" ], "cuisines": [], "proxyConfiguration": { "useApifyProxy": true } }' | apify call cyrilfaia/gaultmillau-fr-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,cyrilfaia/gaultmillau-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 ` 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/Kv7bwHz7GhNtSpAn9/builds/RzKI9zhiKlFQOKHXX/openapi.json