{ "openapi": "3.0.1", "info": { "title": "Egypt Business Directory Scraper", "description": "Scrapes business directory data from EgyptYello (egyptyello.com) including company information, reviews, products, and more", "version": "1.0", "x-build-id": "ZEaRcop34fkFDdRKn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nickslam~egyptyello-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nickslam-egyptyello-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/nickslam~egyptyello-scraper/runs": { "post": { "operationId": "runs-sync-nickslam-egyptyello-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/nickslam~egyptyello-scraper/run-sync": { "post": { "operationId": "run-sync-nickslam-egyptyello-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": { "categories": { "title": "Categories", "type": "array", "description": "Optional: Filter by business categories.\n\nExample: For category page like `https://www.egyptyello.com/category/Estate_agents` enter only the final segment.", "items": { "type": "string" } }, "searchKeywords": { "title": "Search Keywords ($$)", "type": "string", "description": "Optional: Search for specific companies or keywords. Enables premium pricing." }, "locations": { "title": "Locations", "type": "array", "description": "Optional: Filter by cities/regions. If not provided, browse modes use the full directory or your other filters.", "items": { "type": "string", "enum": [ "10th_of_Ramadan_City", "6th_of_October", "Abu_Kabir", "Akhmim", "Al_Mansura", "Al_Minya", "Alexandria", "Arish", "Assyout", "Aswan", "Asyut", "Baharia_Oasis", "Banha", "Beni_Suef", "Benisuef", "Bilbais", "Cairo", "Dahab", "Damietta", "Desouk", "El_Ain_El_Sokhna", "El_Beheira", "El_Dakahleya", "El_Fayoum", "El_Gharbeya", "El_Gouna", "El_Menia", "El_Monofeya", "El_Salloum", "El_Sharkeya", "El_Tur", "El_Wadi_El_Gadid", "Fayyum", "Giza", "Heliopolis", "Hurghada", "Ismaileya", "Ismailia", "Kafr_El_Sheikh", "Kaliobey", "Luxor", "Mallawi", "Marsa_Alam", "Marsa_Matrouh", "Marsa_Matruh", "Matareya", "Mit_Ghamr", "Nasr_City", "North_Coast", "North_Sinai", "Nuweibaa", "Port_Said", "Qalyub", "Qena", "Quseir", "Ras_Ghareb", "Ras_Sidr", "Safaga", "Sharm_El_Sheikh", "Shibin_El_Kom", "Shubra_El_Kheima", "Sohag", "South_Sinai", "St_Catherine", "Suez", "Taba", "Tanta", "Zagazig" ], "enumTitles": [ "10th of Ramadan City", "6th of October", "Abu Kabir", "Akhmim", "Al-Mansura", "Al-Minya", "Alexandria", "Arish", "Assyout", "Aswan", "Asyut", "Baharia Oasis", "Banha", "Beni Suef", "Benisuef", "Bilbais", "Cairo", "Dahab", "Damietta", "Desouk", "El Ain El Sokhna", "El Beheira", "El Dakahleya", "El Fayoum", "El Gharbeya", "El Gouna", "El Menia", "El Monofeya", "El Salloum", "El Sharkeya", "El Tur", "El Wadi El Gadid", "Fayyum", "Giza", "Heliopolis", "Hurghada", "Ismaileya", "Ismailia", "Kafr El Sheikh", "Kaliobey", "Luxor", "Mallawi", "Marsa Alam", "Marsa Matrouh", "Marsa Matruh", "Matareya", "Mit Ghamr", "Nasr City", "North Coast", "North Sinai", "Nuweibaa", "Port Said", "Qalyub", "Qena", "Quseir", "Ras Ghareb", "Ras Sidr", "Safaga", "Sharm El Sheikh", "Shibin El Kom", "Shubra El-Kheima", "Sohag", "South Sinai", "St. Catherine", "Suez", "Taba", "Tanta", "Zagazig" ] } }, "maxResults": { "title": "Max Results", "minimum": 1, "type": "integer", "description": "Maximum number of companies to scrape", "default": 20 }, "startPage": { "title": "Start Page", "minimum": 1, "type": "integer", "description": "Page number to start scraping from. Useful for resuming previous searches.", "default": 1 }, "maxPages": { "title": "Max Pages", "minimum": 1, "type": "integer", "description": "Maximum number of pages to scrape. Each page usually contains around 20 companies.", "default": 5 }, "enableRateLimiting": { "title": "Enable Rate Limiting", "type": "boolean", "description": "Enable rate limiting (2 seconds delay) or disable (0.5 seconds delay)", "default": true }, "hybridStrategy": { "title": "Strategy", "type": "string", "description": "`fast` = Cheerio + Impit HTTP (default). `browser` = Playwright (fallback).", "default": "fast" }, "includeContactDetails": { "title": "Include Contact & Details ($)", "type": "boolean", "description": "Include business hours, year established, employees, contact person", "default": false }, "includeExtendedCompanyInfo": { "title": "Include Extended Company Information ($)", "type": "boolean", "description": "Include website, description, and maps coordinates", "default": false }, "includeRegistrationLegal": { "title": "Include Registration & Legal ($)", "type": "boolean", "description": "Include registration number and VAT number", "default": false }, "includeMetadata": { "title": "Include Metadata ($)", "type": "boolean", "description": "Include listing type, verified status, years with platform, tags", "default": false }, "includeMediaContent": { "title": "Include Media & Product Information ($)", "type": "boolean", "description": "Include photos, logo, products", "default": false }, "includeReviewSummary": { "title": "Include Review Summary ($)", "type": "boolean", "description": "Include review summary (rating and count) - Fast extraction", "default": false }, "includeIndividualReviews": { "title": "Include Individual Reviews ($$)", "type": "boolean", "description": "Include individual reviews - Slower (requires additional pages). Enables premium pricing.", "default": false }, "proxy": { "title": "Proxy Configuration", "type": "object", "description": "Select proxies to be used by the crawler. Recommended: Use Apify Proxy with Residential proxies for better Cloudflare bypass." } } }, "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 } } } } } } } } } }