{ "openapi": "3.0.1", "info": { "title": "Restaurant Menu Scraper", "description": "Extract structured menu data from restaurant websites. Returns items, prices, descriptions, and categories. Handles direct sites, Toast, Square, Popmenu, and PDFs. Search by name + location or provide a URL. AI-powered completeness grading. ~70% success rate.", "version": "1.0", "x-build-id": "Tgdz9O2ik5SaRdX24" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/menus-r-us~restaurant-menu-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-menus-r-us-restaurant-menu-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/menus-r-us~restaurant-menu-scraper/runs": { "post": { "operationId": "runs-sync-menus-r-us-restaurant-menu-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/menus-r-us~restaurant-menu-scraper/run-sync": { "post": { "operationId": "run-sync-menus-r-us-restaurant-menu-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": { "mode": { "title": "Mode", "enum": [ "url", "urls", "search" ], "type": "string", "description": "Choose 'url' for a single restaurant, 'urls' for a list of URLs, or 'search' to discover restaurants by query + location.", "default": "url" }, "url": { "title": "Restaurant URL", "type": "string", "description": "The restaurant website URL to scrape menus from (for 'url' mode)", "default": "https://saltyflamerestaurant.com/" }, "urls": { "title": "Restaurant URLs", "type": "array", "description": "List of restaurant website URLs to scrape (for 'urls' mode)", "items": { "type": "string" } }, "query": { "title": "Search Query", "type": "string", "description": "What kind of restaurants to find (e.g. 'sushi', 'Mexican', 'Italian'). Required for 'search' mode. 'restaurants' is auto-appended.", "default": "Sea Food" }, "location": { "title": "Origin Point of Search", "type": "string", "description": "Neighborhood, address, or city to search near (e.g. 'Downtown San Diego, CA', 'North Park, San Diego', '123 Main St, Austin, TX'). More specific = better results. For broad city coverage, run multiple searches with different neighborhoods. Required for 'search' mode. Optional for 'url' mode (multi-location restaurants).", "default": "Miami, FL" }, "freshness": { "title": "Data Freshness", "enum": [ "long_cache", "med_cache", "short_cache", "fresh" ], "type": "string", "description": "How fresh the data should be. Fresher data costs more per request.", "default": "med_cache" }, "maxResults": { "title": "Max results (search mode)", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum restaurants to scrape in search mode. Discovery often finds far more than one run can scrape: scraping is sequential at roughly 1.5 minutes each, and the default run timeout is 1 hour, so 25 is about what fits with margin. Candidates are ranked by rating weighted by review count before the cap is applied, so you keep the best ones. If you raise this, raise the run's Timeout in the run options too — otherwise the run is killed partway and you are still charged for the results it produced.", "default": 25 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }