{ "openapi": "3.0.1", "info": { "title": "Wuzzuf.net MENA Job Scraper — Egypt & Middle East Jobs", "description": "Scrape wuzzuf.net — Egypt's largest job platform plus the wider MENA region across Saudi Arabia, UAE, Kuwait, Qatar, Bahrain, Oman, Jordan, and Lebanon. Get structured salary, career level, and employment type. Incremental mode tracks changes across runs.", "version": "0.1", "x-build-id": "iZk21ignr2sbIFr2R" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/blackfalcondata~wuzzuf-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-blackfalcondata-wuzzuf-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/blackfalcondata~wuzzuf-scraper/runs": { "post": { "operationId": "runs-sync-blackfalcondata-wuzzuf-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/blackfalcondata~wuzzuf-scraper/run-sync": { "post": { "operationId": "run-sync-blackfalcondata-wuzzuf-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": { "query": { "title": "🔍 Search Term(s)", "type": "string", "description": "Keywords to match against job titles and descriptions. Leave empty to browse all jobs in the selected country. Use a JSON array like [\"python\", \"java\"] to run several searches in one execution." }, "country": { "title": "🌍 Country", "enum": [ "EG", "SA", "AE", "KW", "QA", "BH", "OM", "JO", "LB" ], "type": "string", "description": "Country market to search (ISO-2 code: EG = Egypt, SA = Saudi Arabia, AE = UAE, KW = Kuwait, QA = Qatar, BH = Bahrain, OM = Oman, JO = Jordan, LB = Lebanon). Pick a single market per run. Defaults to EG. Full country names like \"Egypt\" are not accepted.", "default": "EG" }, "location": { "title": "📍 City", "type": "string", "description": "City or region label as it appears on the site (e.g. \"Cairo\", \"Riyadh\"). Use a JSON array for multi-city searches." }, "startUrls": { "title": "🔗 Start URLs", "type": "array", "description": "Direct search URLs or individual job detail URLs. When provided, these run in addition to the search above.", "items": { "type": "string" } }, "careerLevel": { "title": "🎯 Career Level", "enum": [ "", "1", "2", "3", "4", "5" ], "type": "string", "description": "Filter by seniority. Leave empty to include all levels.", "default": "" }, "employmentType": { "title": "💼 Employment Type", "enum": [ "", "1", "2", "3", "4", "5", "6" ], "type": "string", "description": "Filter by contract style.", "default": "" }, "workplaceArrangement": { "title": "🏢 Workplace", "enum": [ "", "1", "2", "3" ], "type": "string", "description": "On-site, hybrid, or remote.", "default": "" }, "yearsOfExperience": { "title": "📈 Minimum Years of Experience", "minimum": 0, "maximum": 30, "type": "integer", "description": "Filter to jobs requiring at least this many years." }, "salaryFrom": { "title": "💰 Minimum Salary", "minimum": 0, "type": "integer", "description": "Minimum monthly salary in the country's local currency (EGP for Egypt, SAR for Saudi Arabia, AED for UAE)." }, "categories": { "title": "🏷️ Industry Categories", "type": "array", "description": "Industry codes to filter by (advanced). Leave empty for all industries.", "items": { "type": "string" } }, "maxResults": { "title": "💯 Max Results", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Maximum total jobs to return across all searches. Set 0 to disable the cap.", "default": 50 }, "maxPages": { "title": "📄 Max Pages per Search", "minimum": 1, "maximum": 100, "type": "integer", "description": "Cap on result pages per search query (page size is 15).", "default": 10 }, "includeDetails": { "title": "📋 Fetch Extra Per-Job Detail", "type": "boolean", "description": "Optional. Fetch each job's individual page to add application counts and similar-job IDs. Slows the run; off by default because the main feed already includes full descriptions.", "default": false }, "descriptionMaxLength": { "title": "✂️ Description Max Length", "minimum": 0, "type": "integer", "description": "Truncate plain-text and markdown descriptions to this many characters. 0 = no truncation.", "default": 0 }, "compact": { "title": "📦 Compact Output", "type": "boolean", "description": "Emit only core fields (title, company, salary, URL, posted date). Useful for AI agents.", "default": false }, "incrementalMode": { "title": "♻️ Incremental Mode", "type": "boolean", "description": "On follow-up runs, only emit jobs that are new or changed since last run. Auto-derives a state key from your filters so different searches stay separate.", "default": false }, "stateKey": { "title": "🔑 State Key", "type": "string", "description": "Optional. Manual label for the tracked search universe (e.g. \"eg-developers\"). Leave empty to auto-derive." }, "emitUnchanged": { "title": "♻️ Emit Unchanged", "type": "boolean", "description": "Also emit jobs that are unchanged since the last run.", "default": false }, "emitExpired": { "title": "⚰️ Emit Expired", "type": "boolean", "description": "Also emit a record for jobs that have dropped off the listings.", "default": false }, "skipReposts": { "title": "🚫 Skip Reposts", "type": "boolean", "description": "Skip jobs whose content matches a job that previously expired (cross-run repost detection).", "default": false }, "telegramToken": { "title": "🔑 Telegram Bot Token", "type": "string", "description": "Telegram bot token (from @BotFather). Required for Telegram notifications." }, "telegramChatId": { "title": "💬 Telegram Chat ID", "type": "string", "description": "Telegram chat or channel ID (e.g. \"-100123456789\"). Required when telegramToken is set." }, "discordWebhookUrl": { "title": "🎮 Discord Webhook URL", "type": "string", "description": "Discord incoming webhook URL." }, "slackWebhookUrl": { "title": "💼 Slack Webhook URL", "type": "string", "description": "Slack incoming webhook URL." }, "whatsappAccessToken": { "title": "📱 WhatsApp Access Token", "type": "string", "description": "WhatsApp Cloud API access token (System User token from Meta Business). Recipient must have messaged the business number in the last 24h." }, "whatsappPhoneNumberId": { "title": "📞 WhatsApp Phone Number ID", "type": "string", "description": "Your WhatsApp Business phone-number ID." }, "whatsappTo": { "title": "📲 WhatsApp Recipient", "type": "string", "description": "Recipient phone in E.164 format without + (e.g. \"201234567890\")." }, "webhookUrl": { "title": "🪝 Generic Webhook URL", "type": "string", "description": "Receives a JSON POST with {metadata, items} after the run. Use with n8n / Make / Zapier / custom backends." }, "webhookHeaders": { "title": "📋 Webhook Headers", "type": "object", "description": "Optional JSON object of custom headers (e.g. {\"Authorization\": \"Bearer ...\"})." }, "notificationLimit": { "title": "📊 Max Jobs Per Notification", "minimum": 1, "maximum": 20, "type": "integer", "description": "Number of jobs included in each notification message (1–20).", "default": 5 }, "notifyOnlyChanges": { "title": "🔄 Notify Only New/Updated", "type": "boolean", "description": "When incremental mode is on, only notify about NEW and UPDATED jobs.", "default": false } } }, "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 } } } } } } } } } }