{ "openapi": "3.0.1", "info": { "title": "Zomato Scraper — Restaurants, Phones, Ratings & Cuisines", "description": "Zomato scraper: export restaurants from any Indian city with phone numbers, address, coordinates, PIN code, rating, votes, cost for two, cuisines, opening hours, features and popular dishes. Filter by city, cuisine, rating and cost. Up to tens of thousands of rows per city. No login.", "version": "1.0", "x-build-id": "A7iAf0CHbRcc0zbzn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~zomato-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-zomato-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/logiover~zomato-scraper/runs": { "post": { "operationId": "runs-sync-logiover-zomato-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/logiover~zomato-scraper/run-sync": { "post": { "operationId": "run-sync-logiover-zomato-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": { "cities": { "title": "Cities", "type": "array", "description": "Cities to collect restaurants from: Mumbai, Bangalore, Delhi NCR, Pune, Hyderabad, Chennai, Kolkata... Common spellings work (Bengaluru, Delhi, Gurgaon). Any zomato.com city slug works too (the part after zomato.com/). Leave empty to use only the Zomato URLs below (Mumbai when both are empty).", "items": { "type": "string" } }, "startUrls": { "title": "Zomato URLs (optional)", "type": "array", "description": "Paste zomato.com listing pages (city, cuisine or locality pages) or single restaurant pages. Listing pages are crawled like a city; restaurant pages return that one restaurant.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "category": { "title": "Listing type", "enum": [ "dineout", "nightlife" ], "type": "string", "description": "Dining out (all restaurants of a city) or Nightlife (bars, pubs, clubs).", "default": "dineout" }, "cuisines": { "title": "Cuisines (optional)", "type": "array", "description": "Only restaurants serving one of these cuisines, e.g. North Indian, Chinese, Pizza, Biryani, Cafe. Names as Zomato shows them.", "items": { "type": "string" } }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only restaurants rated at least this value (0-5). Unrated new restaurants are excluded when set." }, "minCostForTwo": { "title": "Minimum cost for two", "minimum": 0, "type": "integer", "description": "Lowest cost for two people, in the city's currency (INR in India)." }, "maxCostForTwo": { "title": "Maximum cost for two", "minimum": 0, "type": "integer", "description": "Highest cost for two people, in the city's currency (INR in India)." }, "sortBy": { "title": "Order", "enum": [ "popularity", "rating", "costLow", "costHigh" ], "type": "string", "description": "Order of the results when fewer restaurants are requested than exist.", "default": "popularity" }, "includeDetails": { "title": "Include phone, coordinates, hours and features", "type": "boolean", "description": "Open every restaurant page for phone numbers, coordinates, PIN code, opening hours, features, payment methods and popular dishes. Switch off for a faster list-only export (about 8 times faster).", "default": true }, "splitLargeSearches": { "title": "Go beyond 500 per search", "type": "boolean", "description": "Zomato shows at most about 500 restaurants per search. When more are requested, the Actor splits the city by cuisine, cost and rating to reach the rest.", "default": true }, "maxResults": { "title": "Maximum restaurants", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stop after this many restaurants (across all cities). You are charged per restaurant saved.", "default": 1000 }, "maxConcurrency": { "title": "Parallel sessions", "minimum": 1, "maximum": 30, "type": "integer", "description": "Number of parallel browser-like sessions (each uses its own proxy address). 24 reads about 1,000 restaurants with full details in a minute or two; lower it if you share a proxy plan.", "default": 24 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify datacenter proxy works and is the default. If Zomato refuses these addresses, the Actor falls back to a small amount of Indian residential traffic by itself.", "default": { "useApifyProxy": 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 } } } } } } } } } }