{ "openapi": "3.0.1", "info": { "title": "Wuzzuf Jobs Scraper [๐Ÿ’ฐ$0.85] - Applicant Counts & Salaries", "description": "Scrape Wuzzuf.net jobs in Egypt, Saudi Arabia, UAE and 12 more countries: title, salary, experience, skills, education, applicant counts (applied, viewed, shortlisted, rejected) and company website, LinkedIn & industry. Filters, incremental monitoring and Telegram/Slack alerts.", "version": "0.1", "x-build-id": "HtFRVlbHJWNfyarFu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/corvuslab~wuzzuf-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-corvuslab-wuzzuf-jobs-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/corvuslab~wuzzuf-jobs-scraper/runs": { "post": { "operationId": "runs-sync-corvuslab-wuzzuf-jobs-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/corvuslab~wuzzuf-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-corvuslab-wuzzuf-jobs-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": { "searchTerms": { "title": "๐Ÿ”‘ Search terms", "type": "array", "description": "Job titles, skills or keywords, e.g. \"accountant\" or \"python developer\". Each term runs as its own search; results are merged and de-duplicated. Leave empty for all jobs.", "items": { "type": "string" } }, "countries": { "title": "๐ŸŒ Countries", "type": "array", "description": "Only jobs in these countries. Most jobs on the board are in Egypt; Gulf and other countries have fewer openings. Leave empty for all countries.", "items": { "type": "string", "enum": [ "Egypt", "Saudi Arabia", "United Arab Emirates", "Qatar", "Kuwait", "Oman", "Bahrain", "Jordan", "Lebanon", "Iraq", "Libya", "Algeria", "United States", "United Kingdom", "Germany" ], "enumTitles": [ "Egypt", "Saudi Arabia", "United Arab Emirates", "Qatar", "Kuwait", "Oman", "Bahrain", "Jordan", "Lebanon", "Iraq", "Libya", "Algeria", "United States", "United Kingdom", "Germany" ] } }, "locations": { "title": "๐Ÿ“ Cities or districts", "type": "array", "description": "Cities (\"Cairo\", \"Giza\", \"Alexandria\", \"Riyadh\") or districts (\"New Cairo\", \"Nasr City\", \"Maadi\", \"6th of October\"). \"City, Country\" works too. Places with no open jobs are skipped with a warning.", "items": { "type": "string" } }, "startUrls": { "title": "๐Ÿ“‹ Start URLs", "type": "array", "description": "Paste Wuzzuf search URLs (wuzzuf.net/search/jobs/?q=โ€ฆ, filters included), country pages (wuzzuf.net/jobs/egypt) or single job URLs (wuzzuf.net/jobs/p/โ€ฆ). When set, these replace the search form.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "๐Ÿ”ข Max results", "minimum": 0, "type": "integer", "description": "Maximum number of jobs to return in total, across all search terms and places. Set 0 for every matching job.", "default": 25 }, "jobTypes": { "title": "๐Ÿ’ผ Job type", "type": "array", "description": "Employment type.", "items": { "type": "string", "enum": [ "full_time", "part_time", "freelance_project", "internship", "shift_based", "volunteering" ], "enumTitles": [ "Full time", "Part time", "Freelance / project", "Internship", "Shift based", "Volunteering" ] } }, "workplace": { "title": "๐Ÿ  Workplace", "type": "array", "description": "On-site, hybrid or remote.", "items": { "type": "string", "enum": [ "on_site", "hybrid", "remote" ], "enumTitles": [ "On-site", "Hybrid", "Remote" ] } }, "careerLevels": { "title": "๐Ÿ“ˆ Career level", "type": "array", "description": "Seniority of the role.", "items": { "type": "string", "enum": [ "student", "entry_level", "experienced", "manager", "senior_management" ], "enumTitles": [ "Student", "Entry level (junior / fresh grad)", "Experienced (non-manager)", "Manager", "Senior management" ] } }, "categories": { "title": "๐Ÿ—‚๏ธ Job category", "type": "array", "description": "The site's job categories.", "items": { "type": "string", "enum": [ "Accounting/Finance", "Administration", "Analyst/Research", "Banking", "Business Development", "C-Level Executive/GM/Director", "Creative/Design/Art", "Customer Service/Support", "Education/Teaching", "Engineering - Construction/Civil/Architecture", "Engineering - Mechanical/Electrical", "Engineering - Oil & Gas/Energy", "Engineering - Other", "Engineering - Telecom/Technology", "Fashion", "Hospitality/Hotels/Food Services", "Human Resources", "Installation/Maintenance/Repair", "IT/Software Development", "Legal", "Logistics/Supply Chain", "Manufacturing/Production", "Marketing/PR/Advertising", "Media/Journalism/Publishing", "Medical/Healthcare", "Operations/Management", "Other", "Pharmaceutical", "Project/Program Management", "Purchasing/Procurement", "Quality", "R&D/Science", "Sales/Retail", "Strategy/Consulting", "Tourism/Travel", "Training/Instructor", "Writing/Editorial" ], "enumTitles": [ "Accounting/Finance", "Administration", "Analyst/Research", "Banking", "Business Development", "C-Level Executive/GM/Director", "Creative/Design/Art", "Customer Service/Support", "Education/Teaching", "Engineering - Construction/Civil/Architecture", "Engineering - Mechanical/Electrical", "Engineering - Oil & Gas/Energy", "Engineering - Other", "Engineering - Telecom/Technology", "Fashion", "Hospitality/Hotels/Food Services", "Human Resources", "Installation/Maintenance/Repair", "IT/Software Development", "Legal", "Logistics/Supply Chain", "Manufacturing/Production", "Marketing/PR/Advertising", "Media/Journalism/Publishing", "Medical/Healthcare", "Operations/Management", "Other", "Pharmaceutical", "Project/Program Management", "Purchasing/Procurement", "Quality", "R&D/Science", "Sales/Retail", "Strategy/Consulting", "Tourism/Travel", "Training/Instructor", "Writing/Editorial" ] } }, "postedWithin": { "title": "๐Ÿ—“๏ธ Posted within", "enum": [ "any", "24h", "week", "month" ], "type": "string", "description": "Only jobs posted recently.", "default": "any" }, "yearsOfExperience": { "title": "๐ŸŽ“ Years of experience", "minimum": 0, "maximum": 50, "type": "integer", "description": "Your years of experience: only jobs whose required range includes this number (jobs with no stated range are kept)." }, "onlyWithSalary": { "title": "๐Ÿ’ฐ Only jobs with a published salary", "type": "boolean", "description": "Skip jobs whose salary is confidential. Skipped jobs are not charged.", "default": false }, "minSalary": { "title": "๐Ÿ’ต Minimum monthly salary", "minimum": 0, "type": "integer", "description": "Only jobs whose published monthly salary reaches this amount (top of the range), in the job's own currency โ€” EGP for Egypt. Implies a published salary. Skipped jobs are not charged." }, "excludeConfidential": { "title": "๐Ÿข Skip confidential employers", "type": "boolean", "description": "Skip jobs posted by an anonymous (\"Confidential\") company โ€” handy for lead lists. Skipped jobs are not charged.", "default": false }, "includeApplicantInsights": { "title": "๐Ÿ“Š Include applicant counts", "type": "boolean", "description": "Add how many people applied, how many applications the employer viewed, shortlisted and rejected, page views, and a demand label โ€” handy for spotting low-competition openings.", "default": true }, "includeCompanyProfile": { "title": "๐Ÿข Include company profile", "type": "boolean", "description": "Add the employer's website, LinkedIn, Facebook, industry, description, logo and founding year.", "default": true }, "descriptionFormat": { "title": "๐Ÿ“ Description format", "enum": [ "all", "text", "html", "markdown" ], "type": "string", "description": "Which version(s) of the job description and requirements to include.", "default": "all" }, "descriptionMaxLength": { "title": "โœ‚๏ธ Max description length", "minimum": 0, "type": "integer", "description": "Truncate descriptions and requirements to this many characters. 0 or empty = full text." }, "compact": { "title": "๐Ÿ“ฆ Compact records", "type": "boolean", "description": "Emit only the core fields (title, company, location, job type, career level, experience, salary, date, applicants). Ideal for AI agents and MCP clients.", "default": false }, "excludeEmptyFields": { "title": "๐Ÿงน Drop empty fields", "type": "boolean", "description": "Remove null, empty-string and empty-array fields from each record.", "default": false }, "incrementalMode": { "title": "โ™ป๏ธ Incremental mode", "type": "boolean", "description": "Track jobs between runs and tag each with a changeType (NEW / UPDATED / REAPPEARED / UNCHANGED / EXPIRED). Unchanged jobs are skipped and not charged.", "default": false }, "stateKey": { "title": "๐Ÿ—๏ธ State key", "type": "string", "description": "Stable name for the tracked search. Leave empty to derive one automatically from your search settings." }, "emitUnchanged": { "title": "๐Ÿ” Include unchanged records", "type": "boolean", "description": "Also emit records that have not changed since the previous run.", "default": false }, "emitExpired": { "title": "๐Ÿ—‘๏ธ Include expired records", "type": "boolean", "description": "Emit a record for each job seen last time but gone now. Only reported by runs that read the whole search (Max results 0 or above the search size).", "default": false }, "skipReposts": { "title": "๐Ÿšซ Skip re-posted jobs", "type": "boolean", "description": "Skip a job that re-appears under a new id with the same title, company and location as one already tracked.", "default": false }, "telegramToken": { "title": "๐Ÿ’ฌ Telegram bot token", "type": "string", "description": "Bot token from @BotFather." }, "telegramChatId": { "title": "๐Ÿ†” Telegram chat ID", "type": "string", "description": "Chat or channel ID, e.g. \"-100123456789\" or \"@yourchannel\"." }, "slackWebhookUrl": { "title": "๐Ÿ’ผ Slack webhook URL", "type": "string", "description": "Slack incoming-webhook URL." }, "discordWebhookUrl": { "title": "๐ŸŽฎ Discord webhook URL", "type": "string", "description": "Discord incoming-webhook URL." }, "webhookUrl": { "title": "๐Ÿช Webhook URL", "type": "string", "description": "Any HTTPS endpoint. Receives a JSON POST with the matched records โ€” works with n8n, Make and Zapier." }, "webhookHeaders": { "title": "๐Ÿงพ Webhook headers", "type": "object", "description": "Extra headers for the webhook request, e.g. {\"Authorization\": \"Bearer xyz\"}." }, "notificationLimit": { "title": "๐Ÿ”ข Records per notification", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many records to include in each notification message.", "default": 5 }, "notifyOnlyChanges": { "title": "๐Ÿ”• Notify only about changes", "type": "boolean", "description": "In incremental mode, send notifications only for NEW, UPDATED and REAPPEARED jobs.", "default": false }, "proxyConfiguration": { "title": "๐ŸŒ Proxy configuration", "type": "object", "description": "Optional. Not needed โ€” the actor works without a proxy. Enable it only if your runs get blocked.", "default": { "useApifyProxy": false } }, "maxRequestRetries": { "title": "๐Ÿ”„ Max request retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "How many times to retry a failed request before giving up on it.", "default": 3 }, "ignoreUrlFailures": { "title": "โญ๏ธ Ignore URL failures", "type": "boolean", "description": "Skip start URLs that cannot be interpreted instead of failing the whole run.", "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 } } } } } } } } } }