{ "openapi": "3.0.1", "info": { "title": "iFoodie (愛食記) Taiwan Restaurants Scraper", "description": "Restaurant listings from ifoodie.tw, Taiwan's largest restaurant review site: name, user and editorial rating, average price (TWD), price level, opening hours, address, coordinates, cuisine tags, phone, website, signature dishes. Filter by city, district, keyword and sort. No login, no API key.", "version": "0.1", "x-build-id": "NvkqY21BnO3nwRssX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ardent_fork~ifoodie-taiwan-restaurants/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ardent_fork-ifoodie-taiwan-restaurants", "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/ardent_fork~ifoodie-taiwan-restaurants/runs": { "post": { "operationId": "runs-sync-ardent_fork-ifoodie-taiwan-restaurants", "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/ardent_fork~ifoodie-taiwan-restaurants/run-sync": { "post": { "operationId": "run-sync-ardent_fork-ifoodie-taiwan-restaurants", "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", "required": [ "city" ], "properties": { "city": { "title": "City", "type": "string", "description": "City or county exactly as ifoodie spells it, e.g. 台北市, 新北市, 桃園市, 台中市, 台南市, 高雄市, 基隆市, 新竹市, 新竹縣, 宜蘭縣, 花蓮縣, 台東縣, 屏東縣, 嘉義市, 彰化縣, 南投縣, 苗栗縣, 雲林縣, 澎湖縣, 金門縣. An unknown city fails the run.", "default": "台北市" }, "district": { "title": "District", "type": "string", "description": "Optional district within the city, as ifoodie spells it (e.g. 大安區, 信義區, 中山區 for 台北市). Leave empty for the whole city." }, "keyword": { "title": "Keyword", "type": "string", "description": "Optional cuisine, dish or restaurant-name keyword in Chinese (e.g. 拉麵, 火鍋, 早午餐, 咖啡廳, 燒肉). Leave empty for every restaurant in the city." }, "sortby": { "title": "Sort", "enum": [ "default", "recent", "popular", "rating" ], "type": "string", "description": "Order of the results. \"default\" is ifoodie's own ranking (by rating on a plain city list, by recent activity on keyword lists); \"recent\" = recently reviewed; \"popular\" = most visited; \"rating\" = highest rated (the most stable order for deep runs).", "default": "default" }, "maxItems": { "title": "Max restaurants", "minimum": 1, "maximum": 1005, "type": "integer", "description": "Stop after this many restaurants have been saved. Each list page holds 15 and ifoodie shows at most ~1000 results (67 pages) per query — use district or keyword filters to reach more restaurants.", "default": 100 }, "fetchDetails": { "title": "Fetch restaurant pages", "type": "boolean", "description": "Open every restaurant page for the extra fields: facilities, notes (service charge, cards, reservations, minimum spend), signature dishes, price range, suitable groups, meal types, nearby landmarks, tags, ambience. Turn off to get only the list data (rating, price, hours, address, coordinates, phone, website) — about 15× fewer requests.", "default": true }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Parallel page fetches.", "default": 5 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. ifoodie.tw serves these pages without a proxy; use one only if your IP is blocked." } } }, "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 } } } } } } } } } }