{ "openapi": "3.0.1", "info": { "title": "Talabat Restaurants Scraper: مطاعم طلبات, Menus & Delivery Fees", "description": "Scrape Talabat restaurants in the UAE, Saudi Arabia, Kuwait, Qatar, Bahrain, Oman, Jordan and Egypt: ratings, cuisines, delivery fee, delivery time, minimum order and full menus with prices. English or Arabic, by area, search word or link. No login, account or API key.", "version": "0.2", "x-build-id": "W0Zh0X3MdPOsXRfGd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~talabat-restaurant-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-talabat-restaurant-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/getascraper~talabat-restaurant-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-talabat-restaurant-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/getascraper~talabat-restaurant-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-talabat-restaurant-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": { "startUrls": { "title": "Talabat links (optional)", "type": "array", "description": "Talabat restaurant pages, delivery area pages (talabat.com/uae/restaurants/1272/dubai-marina) or menu pages with an area (talabat.com/uae/restaurant/721446/...?aid=1203). Any of the eight supported countries. When links are given, only they are read.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "areas": { "title": "Delivery areas (optional)", "type": "array", "description": "Area names as Talabat shows them (Dubai Marina, Salmiya, Al Olaya) or area page links. Each area returns the restaurants that deliver there, with delivery fee, delivery time and minimum order.", "default": [], "items": { "type": "string" } }, "searchQueries": { "title": "Search words (optional)", "type": "array", "description": "Restaurant name words to search in the country directory, for example pizza or shawarma. Use Arabic words when the language is Arabic.", "default": [], "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "uae", "ksa", "kuwait", "qatar", "bahrain", "oman", "jordan", "egypt" ], "type": "string", "description": "The Talabat market to read.", "default": "uae" }, "language": { "title": "Language", "enum": [ "en", "ar" ], "type": "string", "description": "English or Arabic names, cuisines and delivery texts.", "default": "en" }, "cuisineKeywords": { "title": "Cuisine keywords (optional)", "type": "array", "description": "Keep only restaurants whose cuisines contain at least one keyword, for example burgers or lebanese.", "default": [], "items": { "type": "string" } }, "minimumRating": { "title": "Minimum rating (optional)", "minimum": 0, "maximum": 5, "type": "number", "description": "Keep only restaurants with a public rating at or above this value (scale 0 to 5). Restaurants without a rating are skipped." }, "freeDeliveryOnly": { "title": "Free delivery only", "type": "boolean", "description": "Keep only restaurants with a delivery fee of zero. Works with delivery areas.", "default": false }, "maxDeliveryMinutes": { "title": "Maximum delivery time in minutes (optional)", "minimum": 1, "maximum": 240, "type": "integer", "description": "Keep only restaurants that deliver within this many minutes. Works with delivery areas." }, "maxItems": { "title": "Maximum restaurants", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum restaurant rows to return. The default is a 10-restaurant sample; set a higher limit for larger exports.", "default": 10 }, "maxPages": { "title": "Maximum pages per source", "minimum": 1, "maximum": 100, "type": "integer", "description": "Result pages to read for each area, search word or directory. A directory page holds 30 restaurants, an area page 15.", "default": 1 }, "includeDetails": { "title": "Add rating and location from restaurant pages", "type": "boolean", "description": "For directory and search results, open each restaurant page to add rating, image, location and payment options. Area results already include them.", "default": true }, "includeMenu": { "title": "Include full menu with prices", "type": "boolean", "description": "Add the menu (sections, dishes, descriptions, prices, discounts) to each restaurant. Needs delivery areas or an area link, because menus are shown per area. Slower for large exports.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. The Actor connects directly and switches to Apify datacenter proxy by itself if Talabat refuses the connection.", "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 } } } } } } } } } }