{ "openapi": "3.0.1", "info": { "title": "Michelin Restaurants Search Scraper", "description": "Scrape restaurant listings from the official Michelin Guide with ease. Collect star ratings, chef info, cuisine types, location data, booking availability, and 30+ fields per restaurant — perfect for food researchers, travel platforms, and hospitality analysts.", "version": "0.0", "x-build-id": "p5i9eywSc1CBHpOgi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~michelin-restaurants-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-michelin-restaurants-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/stealth_mode~michelin-restaurants-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-michelin-restaurants-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/stealth_mode~michelin-restaurants-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-michelin-restaurants-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "urls": { "title": "URLs of the restaurants list urls to scrape", "type": "array", "description": "Add the URLs of the restaurants list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." }, "keyword": { "title": "Keyword to search", "type": "string", "description": "Enter the keyword to search for items" }, "distinction": { "title": "Distinction", "enum": [ "", "3-stars-michelin", "2-stars-michelin", "1-star-michelin", "bib-gourmand", "the-plate-michelin" ], "type": "string", "description": "Enter the distinction to search for items" }, "good_for": { "title": "Good For", "enum": [ "", "chefs-table", "date-night", "eat-like-a-local", "family-friendly", "farm-to-table", "groups", "iconic", "inspectors-favorite", "outdoor-dining", "solo-dining", "trending", "worth-queueing-for" ], "type": "string", "description": "Enter the good for to search for items" }, "cuisine": { "title": "Cuisine", "enum": [ "", "afghan", "african", "alpine", "alsatian", "american", "american-contemporary", "andalusian", "apulian", "argentinian", "armenian", "asian", "asian-and-western", "asian-contemporary", "asian-influences", "asturian", "australian-contemporary", "austrian", "bakery", "balkan", "barbecue-1143", "basque", "beef-specialities", "pekingese", "belgian", "brazilian", "british-contemporary", "burmese", "cajun", "calabrian", "californian", "campanian", "cantonese", "caribbean", "castilian", "catalan", "central-asian-120", "chao-zhou", "chinese", "chinese-contemporary", "classic-cuisine", "classic-french", "colombian", "congee", "contemporary", "country", "creative", "creative-french", "creole", "croatian", "cuban", "cuisine-from-abruzzo", "cuisine-from-lazio", "cuisine-from-the-aosta-valley", "cuisine-from-the-marches", "czech", "danish", "deli", "dim-sum", "dongbei", "dumplings", "dwaeji-gukbap", "emilian", "emirati-cuisine", "english", "ethiopian", "european", "european-contemporary", "market-cuisine", "filipino", "finnish", "french", "french-contemporary", "friulian", "fujian", "fusion-1161", "fusion", "galician", "gastropub", "gejang", "german", "gomtang", "greek", "grills-1162", "hakkanese", "hang-zhou", "home-cooking", "hotpot", "huai-yang", "hubei", "hui-cuisine", "hunanese", "hungarian", "indian", "indonesian", "innovative", "international", "irish", "isan", "israeli", "italian", "italian-and-japanese", "italian-contemporary", "italian-american", "izakaya", "jamaican", "japanese", "japanese-contemporary", "japanese-steakhouse", "jiangsu-cuisine", "jiangzhe", "korean", "korean-contemporary", "lao", "latin-american", "lebanese", "ligurian", "lombardian", "lyonnaise", "malaysian", "meats-and-grills", "meats-and-seafood", "mediterranean-cuisine", "memil-guksu", "mexican", "middle-eastern", "milanese", "modern-british", "modern-cuisine", "modern-french", "moroccan", "naengmyeon", "new-zealand", "ningbo", "noodles", "noodles-and-congee", "north-american", "onigiri", "organic", "peranakan", "persian", "peruvian", "piedmontese", "pizza", "polish", "pork-specialities", "portuguese", "provençal", "ramen", "regional-cuisine", "regional-european", "rice-dishes", "roman", "samoan", "sardinian", "saudi-cuisine", "scandinavian", "seafood-1096", "seafood", "seasonal-cuisine", "seolleongtang", "shandong", "shanghainese", "sharing", "sichuan", "sicilian", "small-eats", "soba", "south-american", "south-east-asian", "southern", "spanish", "spanish-contemporary", "sri-lankan", "steakhouse", "sukiyaki", "sushi", "swedish", "taiwanese", "taizhou", "tempura", "tex-mex", "thai", "thai-contemporary", "traditional-british", "traditional-cuisine", "turkish", "tuscan", "udon", "umbrian", "unagi-freshwater-eel", "vegan-90", "vegetarian", "venetian", "venezuelan", "vietnamese", "vietnamese-contemporary", "world-cuisine", "yakitori", "yunnan", "zhejiang-1278" ], "type": "string", "description": "Enter the cuisine to search for items" }, "special_diets": { "title": "Special Diets", "enum": [ "", "vegetarian-options", "vegan", "gluten-free", "vegetarian_menu", "halal", "koshel" ], "type": "string", "description": "Enter the special diets to search for items (V, T)" }, "price": { "title": "Price", "enum": [ "", "affordable", "mid-range", "premium", "luxury" ], "type": "string", "description": "Enter the price to search for items (V, T)" }, "service": { "title": "Service", "enum": [ "", "disabled_access", "air_conditioning", "amex", "bring_your_own_bottle", "brunch", "car_park", "cash_only", "cash-only-lunch", "china-unionpay", "counter", "credit_card", "credit-cards-not-accepted", "din", "discover-card", "foreign-credit-cards-not-accepted", "garden", "interesting_view", "interesting_wine_list", "jcb", "maestro", "mc", "no_alcohol_served", "sake", "pets_allowed_everywhere", "pets_allowed_only_outdoor", "pets_not_allowed", "shoes-must-be-removed", "terrace", "valet", "visa" ], "type": "string", "description": "Enter the service to search for items (V, T)" }, "sort_by": { "title": "Sort Items by options", "enum": [ "", "lowestPrice", "highestPrice" ], "type": "string", "description": "Sort items by options" }, "page": { "title": "Page start", "type": "integer", "description": "Specify the page number to start scraping from" }, "max_items_per_url": { "title": "Max items per URL", "type": "integer", "description": "The maximum number of items to scrape per URL." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }