{ "openapi": "3.0.1", "info": { "title": "ForkScan", "description": "💫 All-in-One TheFork.com Scraper", "version": "0.1", "x-build-id": "qbxe4Qoc9QZRvaaok" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jupri~fork-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jupri-fork-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/jupri~fork-scraper/runs": { "post": { "operationId": "runs-sync-jupri-fork-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/jupri~fork-scraper/run-sync": { "post": { "operationId": "run-sync-jupri-fork-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": { "query": { "title": "❓ Query", "type": "array", "description": "💡 Where is it ❓

URL or LOCATION or COORDINATES (LAT, LON)

", "items": { "type": "string" } }, "example": { "title": "Example", "enum": [ "London", "43.7679178, 11.2523792", "838887", "838887/reviews", "https://www.thefork.com/restaurant/ristorante-il-foyer-r838887", "https://www.thefork.com/restaurants/florence-c170853" ], "type": "string", "description": "Query INPUT examples" }, "limit": { "title": "♾️ Limit", "type": "integer", "description": "💡 Number of results (per-query)" }, "sort": { "title": "Sorting", "enum": [ "quality", "promotion", "rating", "tripadvisor", "popularity", "recent", "forkrank", "price", "rating_week", "booked_week", "rating_month", "booked_month" ], "type": "string", "description": "Sorting key" }, "includes.photos": { "title": "Photos", "type": "boolean", "description": "" }, "includes.description": { "title": "Description", "type": "boolean", "description": "" }, "includes.hours": { "title": "Hours", "type": "boolean", "description": "Opening Hours" }, "includes.menu": { "title": "Menu", "type": "boolean", "description": "" }, "review_sort": { "title": "Reviews Sorting", "type": "string", "description": "" }, "reserve_date": { "title": "Date (YYYY-MM-DD)", "type": "string", "description": "" }, "reserve_time": { "title": "Time (HH:MM)", "type": "string", "description": "" }, "reserve_size": { "title": "Size", "type": "integer", "description": "" }, "timezone": { "title": "Timezone", "type": "string", "description": "default: Europe/London" }, "rating": { "title": "Average Rating", "type": "string", "description": "Minimum Rating (7.0 - 10.0)" }, "min_price": { "title": "Average Price (euro)", "type": "integer", "description": "" }, "max_price": { "title": "", "type": "integer", "description": "" }, "cuisine": { "title": "Cuisine", "type": "array", "description": "", "items": { "type": "string", "enum": [ "1037", "2292", "385", "3625", "461", "441", "459", "403", "453", "462", "404", "387", "2279", "2143", "1031", "405", "5359", "431", "1223", "445", "454", "430", "944", "388", "5773", "943", "2555", "398", "406", "2639", "389", "455", "443", "399", "444", "456", "525", "2139", "433", "2659", "463", "951", "2366", "386", "428", "2557", "895", "434", "449", "418", "442", "420", "410", "421", "411", "423", "415", "416", "427", "450", "429", "435", "1513", "2543", "2545", "451", "1504", "471", "992", "464", "4351", "2547", "436", "391", "2559", "390", "5573", "465", "1025", "2641", "1026", "1028", "3475", "949", "2499", "1465", "789", "457", "460", "1027", "3427", "466", "5771", "892", "3471", "1254", "392", "2273", "955", "2451", "458", "987", "2645", "1029", "896", "437", "447", "3473", "1030", "988", "2141", "989", "1024", "950", "438", "1032", "1033", "448", "439", "2283", "791", "5775", "452", "432", "790", "2142", "1270", "469", "2388", "393", "1294", "1034", "401", "467", "468", "1035", "2310", "2643", "2375", "485", "952", "1036", "2553", "394" ], "enumTitles": [ "Abruzzese", "Afghan", "African", "Afternoon Tea", "Algerian", "Alsatian", "American", "Andalusian", "Argentinian", "Armenian", "Arrocería", "Asian", "Australian", "Austrian", "Barese", "Basque", "Bavarian", "Belgian", "Bergamasco", "Bouchon lyonnais", "Brazilian", "British", "Calabrese", "Cambodian", "Campano", "Campanon", "Cantonese", "Caribbean", "Catalan", "Chilean", "Chinese", "Colombian", "Corsican", "Creole", "Crêperie", "Cuban", "Del Norte", "Dutch", "Eastern Europe", "Ecuadorian", "Egyptian", "Emiliano", "Eritrean", "Ethiopian", "European", "Feijoada", "Franco-Belgian", "French", "French Southwest", "From Asturias", "From Auvergne", "From Canarias", "From Castille", "From Extremadura", "From Galicia", "From Madrid", "From Murcia", "From Navarre", "From the Pyrenees", "Fusion", "German", "Greek", "Grilled", "Hawaiian", "Hungarian", "Indian", "Indonesian", "International", "International food", "Iranian", "Iraqi", "Israeli", "Italian", "Japanese", "Jewish", "Korean", "Laziale", "Lebanese", "Ligure", "Local", "Lombardo", "Lucano", "Malaysian", "Marchigiano", "Mauritian", "Meat Cuisine", "Mediterranean", "Mexican", "Middle Eastern", "Milanese", "Modern New Zealand", "Moroccan", "Napolitano", "Napolitanon", "Nepalese", "Ottoman", "Pakistani", "Palestinian", "Parmigiano", "Persian", "Peruvian", "Piacentino", "Picadas", "Piemontese", "Pizzeria", "Portuguese", "Provencal", "Pub grub", "Pugliese", "Reggiano", "Regional", "Romagnolo", "Romanian", "Romano", "Russian", "Salentina", "Sardo", "Savoyard", "Scandinavian", "Scottish", "Seafood", "Siciliano", "South American", "Spanish", "Steakhouse", "Surinamese", "Swedish", "Swiss", "Syrian", "Thai", "Tibetan", "Toscano", "Traditional cuisine", "Tunisian", "Turkish", "Umbro", "Uruguayan", "Varied", "Vegan cuisine", "Vegetarian", "Venetian", "Veneziano", "Venezuelan", "Vietnamese" ] } }, "themes": { "title": "Setting & Moments", "type": "array", "description": "", "items": { "type": "string", "enum": [ "3533", "1292", "5467", "516", "523", "788", "325", "377", "767", "5889", "378", "1622", "894", "793", "1299", "3531", "329", "397", "2293", "764", "2083", "384", "2597", "1507", "850", "383", "763", "363", "1681", "2585", "5779", "2619", "5409", "4", "1506", "1", "898", "2104", "349", "1222", "2147", "1467", "6", "2579", "1460", "885", "1278", "5777", "761", "8", "9", "2140", "1073", "3619", "1290", "362", "5", "3623", "332", "882", "2551", "3621", "370", "5411", "2098", "2631", "381", "1072", "380", "7", "365", "351", "5725", "2" ], "enumTitles": [ "A puertas cerradas", "After work", "Agriturismo", "All you can eat buffet", "Author", "Bachelor party", "Birthday", "Bistro", "Bistronomic", "Bookable terrace", "Brasserie", "Breakfast", "Brunch", "Café", "Central location", "Cervecería", "Communion", "Contemporary cuisine", "Cosy", "Creative", "Design", "Dinner cruise", "Estaminet", "Ethnic", "Fiestas San Isidro", "Fine Dining", "From market", "Garden", "Gastronomic market", "Gastropub", "Gift cards", "Ginos", "Giro pizza", "Good for a business lunch", "Good for ceremonies", "Good for families", "Good for groups", "Grande Brasserie", "Great view", "Healthy.old", "High tea", "Homemade cuisine", "In the mountains", "Izakaya", "Kid-friendly", "La Tagliatella", "Live music", "Lunch", "Nightlife", "Oceanfront", "On the beach", "Organic", "Osteria", "Para ir antes de la rumba", "Raw food", "Restaurant hotel", "Romantic", "Salida en grupos", "Seminar", "Shopping center", "Street Food", "Tematicos", "Terrace", "Terrazza", "To watch sports", "Tony Roma's", "Traditional", "Trattoria", "Trendy", "Waterfront", "Wedding", "Wine bar", "Winter terrace", "With friends" ] } }, "selection": { "title": "TheFork Selection", "type": "array", "description": "", "items": { "type": "string", "enum": [ "2487", "4399", "3425", "5465", "5399", "648", "2268", "2084", "869", "1074", "4349", "5403", "5283", "2372", "2307", "2605", "338", "2383", "2655", "4405", "2637", "2447", "519", "4427", "4425", "2404", "1256", "2112", "6179", "6071", "2442", "2080", "2539", "5639", "2625", "2116", "4357", "6161", "6178", "2033", "2445", "891", "2603", "4355", "2387", "2623", "486", "859", "1692", "2471", "2082", "2651", "2647", "4429", "1657", "4401", "6081", "2030", "4363", "483", "1448", "2032", "868", "2051" ], "enumTitles": [ "A taste of summer", "Amex Welcome", "Awards 2019", "Back to the Restaurant", "Back to the Restaurant - 50% off", "Before/after theatre", "Best of Chiado", "Best of Fish", "Best of rapport qualité-prix", "Best of romantique", "Black Friday", "Breakfast & Brunch", "COVID re-open", "Cheap eats", "Christmas", "Christmas and New Year", "Châteaux & Hotels Collection", "Deco resto", "ELLE GOURMET", "Eco-friendly", "Family Days", "Father's Day", "Female Chefs", "Food Delivery", "Food delivery & takeaway", "Fromages de France", "Gastronomy festival", "Good to watch football games", "Gourmet", "Green Week", "Healthy", "Hidden gems", "Homemade Label", "I più recensiti", "Insider Week", "Italian week", "Léon de Bruxelles", "Meliá Rewards", "Miller & Carter", "Most booked", "Mother's Day", "New restaurants", "New year's eve", "Olivier Experience", "POP DAYS", "Promos TheFork Festival", "Quirky", "Restaurant Week", "Ristoranti contro la Fame", "Rooftops", "Selection of the week", "TASTE ASIA", "TOGETHER", "Takeaway", "TheFork Festival", "TheFork Festival - Menu Insider", "TheFork SUMMER!", "TheFork Tuesday", "Top 25", "Top Chefs", "Top list on TripAdvisor", "Top rated", "Travelers' Choice 2020", "Valentine's Day" ] } }, "dishes": { "title": "Dishes", "type": "array", "description": "", "items": { "type": "string", "enum": [ "2615", "5389", "1300", "5379", "5405", "2599", "513", "2563", "2501", "2695", "515", "2565", "5377", "2503", "654", "3665", "658", "2567", "2284", "792", "2571", "662", "5673", "660", "1670", "2657", "2144", "2577", "2649", "1044", "2039", "665", "2535", "2573", "2569", "517", "2661", "5667", "664", "2581", "5371", "2575", "2151", "5375", "5373", "2533", "2282", "2531", "2529", "1042", "5369", "1289", "2272", "2527", "1696", "2525", "661", "2523", "2521", "2519", "657", "651", "2517", "993", "2497", "5387", "652", "2495", "1000", "5669", "5385", "2633", "2373", "2515", "1724", "666", "999", "2513", "785", "2511", "319", "512", "2509", "994", "2507", "5365", "667", "663", "650", "5367", "995", "2613", "1001", "323", "787", "5407", "2587", "2593", "5633", "1557", "2505", "5671", "990", "2589", "784", "655", "2145", "2595", "2561", "811", "996" ], "enumTitles": [ "Arepas", "Arrosticini", "Asian tapas", "Asparagus", "Avocado", "Baos", "Barbecue", "Beef Bourguignon", "Bobun", "Bouillabaisse", "Burger", "Burrito", "Cabbage roll", "Cachopo", "Calçots", "Cassoulet", "Ceviche", "Cheeseburger", "Chicken", "Chocolate cake", "Churrasco", "Cod", "Cold cuts platters", "Couscous", "Crepes", "Croquettes", "Dim sum", "Doner Kebab", "Duck Liver", "Eggs", "Escalope", "Escargots", "Escudella", "Falafel", "Fish and Chips", "Fondue", "Fried fish", "Frittura di mare", "Game meat", "Gyros", "Ham Hock", "Hot Dog", "Ice Cream", "Kale", "Knödel", "Kobe Beef", "Lamb", "Lasagne", "Lobster", "Meat specialties", "Meatloaf", "Meats", "Mezze", "Moussaka", "Mushrooms", "Noodle", "Octopus", "Omelette", "Oyster", "Pad Thai", "Paella", "Pasta", "Peking Duck", "Piadina", "Pies", "Pinsa", "Pizza", "Poke", "Polenta", "Porceddu", "Puccia", "Raclette", "Ramen", "Ribs", "Rice", "Risotto", "Salad", "Sandwiche", "Sauerkraut", "Schnitzel", "Scrambled eggs", "Seafood platter", "Shrimps", "Soup", "Souvlaki", "Spaetzle", "Stew", "Suckling pig", "Sushi", "Swabian ravioli", "T-bone steak", "Tacos", "Tandoori", "Tapas", "Tartar steak", "Tartare", "Tempura", "Teppanyaki", "Tigella", "Toasted ham and cheese sandwich", "Tortillas", "Tripes", "Truffle", "Udon & Soba", "Veal ragoût", "Winter food", "Wok", "Yakiniku", "Yakitori", "perch fillet", "piglet" ] } }, "dietary": { "title": "Dietary requirements", "type": "array", "description": "", "items": { "type": "string", "enum": [ "336", "335", "5413", "334", "2155", "1291", "2156", "333", "2157", "2107", "470" ], "enumTitles": [ "Gluten free", "Halal", "KM 0 - Chilometro zero", "Kosher", "Lactose intolerance", "Locally produced", "Nut allergies", "Organic food", "Peanut allergy", "Vegan dishes", "Vegetarian dishes" ] } }, "features": { "title": "Restaurant features", "type": "array", "description": "", "items": { "type": "string", "enum": [ "2148", "354", "3659", "350", "2683", "368", "812", "1287", "2591", "369", "367", "379", "348", "1295", "2149", "359", "2106", "2286", "360", "357", "2601", "364", "2685", "2133", "814", "897", "2687", "1288", "2287", "366", "374", "346", "2289", "375", "2583" ], "enumTitles": [ "Accessible by boat", "Air-conditioning", "BYO", "Bar", "Braille Menu", "Can be privatized", "Cellar", "Children's menu", "Cocktail", "Continuous service", "Dance floor", "Dinner show", "Dog-Friendly", "Dutch spoken", "Elevator", "English spoken", "Football games", "Free parking", "French spoken", "German spoken", "Italian spoken", "Karaoke", "No Valet Parking", "Open in August", "Open late", "Open sunday", "Smoking Area", "Sommelier", "Spanish spoken", "Swimming pool", "Valet parking", "Wheelchair Accessible", "Wheelchair accessible toilet", "Wifi", "Without Alcohol" ] } }, "payment": { "title": "Accepted credit cards", "type": "array", "description": "", "items": { "type": "string", "enum": [ "2665", "311", "2473", "1296", "1654", "2667", "2677", "2681", "2152", "316", "2669", "2679", "312", "313", "5381", "5323", "1656", "5471", "3627", "782", "2663", "314", "1671", "521", "2675", "2673", "1653", "4367", "2699", "315", "2671", "317" ], "enumTitles": [ "Alelo", "American Express", "Apple Pay", "Bancontact", "Banescard", "Cabal Credit Card", "Cabal Debit Card", "Cash Only", "Cash not accepted", "Check", "Clave Credit Card", "Clave Debit Card", "Credit Card", "Diners Club Card", "EC card", "EC-Karte", "Elo", "Google Pay", "Lunch-Check", "Maestro Card", "Magna", "Mastercard", "MobilePay", "PostFinance Card", "Redcompra", "Rede Shop", "Sodexo", "TheFork Pay", "UnionPay via TheFork PAY", "Visa", "Visa Electron", "Voucher" ] } }, "dev_proxy_config": { "title": "🌐 PROXY NETWORKING", "type": "object", "description": "💡 Supported protocol:

HTTP(S), SOCKS5
{http|socks5}://{user:pass}@{hostname|ip-address}:port

Example: socks5://example.com:9000" }, "dev_custom_headers": { "title": "📜 HTTP HEADERS", "type": "array", "description": "💡 Additional HTTP Headers", "items": { "type": "object", "required": [ "key", "value" ], "properties": { "key": { "type": "string", "title": "Key" }, "value": { "type": "string", "title": "Value" } } } }, "dev_custom_cookies": { "title": "🍰 HTTP COOKIES", "type": "array", "description": "💡 Additional HTTP Cookies", "items": { "type": "object", "required": [ "key", "value" ], "properties": { "key": { "type": "string", "title": "Key" }, "value": { "type": "string", "title": "Value" } } } }, "dev_transform_fields": { "title": "♻️ CUSTOM FIELD", "type": "array", "description": "💡 Transform the resulting output. Select only needed fields.

For nested object use DOT. For example: 
address.streetAddress

For nested array use NUMBER (index of array element starting from index=0). For example: 
images.0.url
", "items": { "type": "object", "required": [ "key", "value" ], "properties": { "key": { "type": "string", "title": "Key" }, "value": { "type": "string", "title": "Value" } } } }, "dev_dataset_name": { "title": "📁 CUSTOM STORAGE", "type": "string", "description": "💡 Save results into custom named Dataset, use mask to customize dataset name

{ACTOR} = actor name
{DATE} = date (YYYYMMDD)
{TIME} = time (HHMMSS)

This masks can be used to autogenerate Dataset Name.

example: data-{DATE}
Depending on today date the dataset name will be: data-20230603

default: data-{ACTOR}-{DATE}-{TIME}" }, "dev_dataset_clear": { "title": "Clear Storage", "type": "boolean", "description": "Clear Dataset before insert/update." }, "dev_no_strip": { "title": "Disable data cleansing", "type": "boolean", "description": "💡 Keep/Save empty values (NULL, FALSE, empty ARRAY, empty OBJECT, empty STRING)" }, "dev_fileupload": { "title": "📁 FILE UPLOADER", "type": "string", "description": "💡 Upload your file and copy & paste the URL somewhere." } } }, "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 } } } } } } } } } }