{ "openapi": "3.0.1", "info": { "title": "OpenTable Scraper — Ratings, Reviews & Cuisine", "description": "Scrape OpenTable restaurants by city, cuisine, or name. Returns rating, review count, price band, address, phone, coordinates, and top review. HTTP-only, MCP-ready.", "version": "1.0", "x-build-id": "jZSAainw5bfiODpkN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~opentable-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-opentable-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/khadinakbar~opentable-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-opentable-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/khadinakbar~opentable-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-opentable-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": { "searchTerms": { "title": "Search terms (city, cuisine, or restaurant name)", "type": "array", "description": "Free-text OpenTable searches, one per line. Use this to find restaurants by city ('Miami'), cuisine + city ('Italian, Chicago'), neighborhood ('SoHo, New York'), or restaurant name ('Carbone'). Each term is run separately and paginated up to Max restaurants. NOT an OpenTable URL — for a pre-built search/listing URL use Start URLs instead.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (OpenTable search or city listing pages)", "type": "array", "description": "OpenTable search or metro/cuisine listing URLs to scrape directly (e.g. 'https://www.opentable.com/s/?term=miami'). Use this when you already have an OpenTable results URL with filters applied. Each URL is paginated up to Max restaurants. NOT an individual restaurant page ('/r/...') — those are bot-protected and not supported; search by name via Search terms instead.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxRestaurants": { "title": "Max restaurants (per term / URL)", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum number of unique restaurants to return for EACH search term or start URL. OpenTable serves 50 restaurants per page; the actor auto-paginates until this cap or the result set is exhausted. Defaults to 50. Raise for full-market pulls (a large metro can exceed 800 restaurants).", "default": 50 }, "partySize": { "title": "Party size (covers)", "minimum": 1, "maximum": 20, "type": "integer", "description": "Number of diners used to contextualize OpenTable's availability-aware results. Accepts 1 to 20. Defaults to 2. This influences which restaurants surface as available but does not filter out restaurants; it mirrors the 'covers' selector on opentable.com.", "default": 2 }, "reservationDate": { "title": "Reservation date (optional, YYYY-MM-DD)", "type": "string", "description": "Optional target reservation date in YYYY-MM-DD format (e.g. '2026-07-15'). Use this to bias results toward restaurants with availability on that date. Leave empty for the default 'anytime' search. Must be today or a future date; past dates are ignored by OpenTable." }, "reservationTime": { "title": "Reservation time (optional, HH:mm 24h)", "type": "string", "description": "Optional target time in 24-hour HH:mm format (e.g. '19:30'). Only applied when Reservation date is set. Defaults to '19:00' (7 PM). Ignored when Reservation date is empty.", "default": "19:00" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. OpenTable resets datacenter and non-browser TLS at the edge, so Apify Residential (US) is enabled by default and strongly recommended. Only change this if you know your IPs clear OpenTable. The actor impersonates Chrome TLS regardless of proxy choice.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }