{ "openapi": "3.0.1", "info": { "title": "OpenTable Reviews & Restaurants Scraper, No Login", "description": "Get OpenTable guest reviews with overall, food, service, ambience and value ratings, dined date and restaurant replies, or search restaurants by city with cuisine, price band, rating, review count, address and phone. No login.", "version": "0.1", "x-build-id": "Vwc3iAMMHUbYabEcK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cliqtomedia~opentable-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cliqtomedia-opentable-reviews-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/cliqtomedia~opentable-reviews-scraper/runs": { "post": { "operationId": "runs-sync-cliqtomedia-opentable-reviews-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/cliqtomedia~opentable-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-cliqtomedia-opentable-reviews-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": "What to scrape", "enum": [ "reviews", "search" ], "type": "string", "description": "Reviews: guest reviews of the restaurants you paste below. Search: restaurants OpenTable lists for a city or area.", "default": "reviews" }, "restaurantUrls": { "title": "Restaurant URLs or IDs", "type": "array", "description": "OpenTable restaurant pages, e.g. https://www.opentable.com/r/brooklyn-chop-house-new-york, from any OpenTable country site, or numeric restaurant IDs. Up to 200; one run reads reviews of the first 40, the rest are listed as not started (free) for another run. Used when \"What to scrape\" is Reviews.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "City, neighborhood or area as you would type it on OpenTable, e.g. \"New York\", \"Chicago\" or \"London\". Used when \"What to scrape\" is Search." }, "maxReviewsPerRestaurant": { "title": "Max reviews per restaurant", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Most reviews to return for each restaurant (1–10,000), in the order chosen below. OpenTable serves at most 10,000 reviews per restaurant in one order; run again with another order for more. Each returned review is one review event.", "default": 100 }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Most rows to return in the whole run: reviews in Reviews mode (1–50,000, empty: 1,000), restaurants in Search mode (1–1,000, empty: 30). One run opens at most 40 OpenTable pages, so with details on, restaurants past about 38 come with search-list data only." }, "sortReviewsBy": { "title": "Review order", "enum": [ "newest", "highest", "lowest" ], "type": "string", "description": "Which reviews come first: newest, highest rated or lowest rated.", "default": "newest" }, "reviewsSince": { "title": "Only reviews since", "type": "string", "description": "Return only reviews submitted on or after this date: a date like 2026-01-31 or a period like \"30 days\", \"2 weeks\" or \"6 months\". With newest-first order the run stops reading a restaurant as soon as older reviews start, so scheduled runs only pay for new reviews." }, "includeRestaurantDetails": { "title": "Include restaurant details", "type": "boolean", "description": "Search mode only: on — every restaurant comes with address, phone, website, hours, food/service/ambience ratings and more (opens each restaurant page); off — only what the search list shows (name, cuisine, price band, rating, review count, neighborhood), which is faster. In Reviews mode every restaurant always has one restaurant row with these details before its reviews.", "default": true } } }, "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 } } } } } } } } } }