# Wuzzuf.net MENA Job Scraper — Egypt & Middle East Jobs (`blackfalcondata/wuzzuf-scraper`) Actor 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. - **URL**: https://apify.com/blackfalcondata/wuzzuf-scraper.md - **Developed by:** [Black Falcon Data](https://apify.com/blackfalcondata) (community) - **Categories:** Jobs, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### What does Wuzzuf.net MENA Job Scraper do? Wuzzuf.net MENA Job Scraper extracts structured job data from [wuzzuf.net](https://wuzzuf.net) — including salary data, apply URLs, company metadata, and full descriptions. It supports keyword search, location filters, and controllable result limits, so you can run the same query consistently over time. The actor also offers detail enrichment (full descriptions and company metadata) where the source provides them. **New to Apify?** [Sign up free](https://console.apify.com/sign-up?fpr=1h3gvi) and use the included $5 monthly platform credit to test this actor. ### Key features - **♻️ Incremental mode** — recurring runs emit only NEW / UPDATED / REAPPEARED records — UNCHANGED and EXPIRED are opt-in. First run builds the baseline; subsequent runs emit and charge only for the diff. Pair with notifications for daily "new jobs" alerts to your hiring team. Saves 80–95% on daily monitoring. - **🔔 Notifications** — Telegram, Slack, Discord, WhatsApp Cloud API, generic webhook — out of the box. Pair with incremental + `notifyOnlyChanges` for daily "new Wuzzuf jobs" pings to your hiring channel. - **🔗 Paste-mode** — paste any wuzzuf.net URL straight from your browser — single-job pages, search-results URLs, or category SEO URLs. Build the search you want in the UI, copy the URL, paste it here. - **💰 Structured salary** — salary parsed into structured `salaryMin` / `salaryMax` / `salaryCurrency` / period — no string parsing on your side. Includes `salaryHidden` flag when the source filtered against a bracket but the listing itself doesn't disclose. - **📦 Compact mode** — AI-agent and MCP-friendly compact payloads with core fields only — pipe straight into your ATS, salary-benchmarking tool, or LLM context without parsing extras. - **✂️ Description truncation** — cap description length with `descriptionMaxLength` to control LLM prompt cost and dataset size — set 0 for full descriptions, or any char-limit to trim. - **📌 Change classification** — each record carries a `changeType` of NEW / UPDATED / UNCHANGED / REAPPEARED / EXPIRED. Default emits NEW + UPDATED + REAPPEARED; opt into the others with `emitUnchanged` / `emitExpired`. Repost detection flags previously-expired listings that come back. - **📤 Export anywhere** — Download the dataset as JSON, CSV, or Excel from the Apify Console, or stream live via the Apify API and integrations (Make, Zapier, Google Sheets, n8n, …). ### What data can you extract from wuzzuf.net? Each result includes Core listing fields (`jobId`, `jobKey`, `title`, `location`, `locationCountry`, `locationCity`, `locationArea`, and `salaryText`, and more), detail fields when enrichment is enabled (`description`, `descriptionHtml`, `descriptionMarkdown`, `descriptionLength`, and `salaryAdditionalDetails`), apply information (`applyUrl`), and company metadata (`company`, `companyId`, `companyLogo`, and `companyUrl`). In standard mode, all fields are always present — unavailable data points are returned as `null`, never omitted. In compact mode, only core fields are returned. Enable detail enrichment in the input to get richer fields such as full descriptions and company metadata where the source provides them. ### Input The main inputs are a search keyword, an optional location filter, and a result limit. Additional filters and options are available in the input schema. Key parameters: - **`query`** — 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`** — 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`** — City or region label as it appears on the site (e.g. "Cairo", "Riyadh"). Use a JSON array for multi-city searches. - **`startUrls`** — Direct search URLs or individual job detail URLs. When provided, these run in addition to the search above. - **`careerLevel`** — Filter by seniority. Leave empty to include all levels. (default: `""`) - **`employmentType`** — Filter by contract style. (default: `""`) - **`workplaceArrangement`** — On-site, hybrid, or remote. (default: `""`) - **`yearsOfExperience`** — Filter to jobs requiring at least this many years. - **`salaryFrom`** — Minimum monthly salary in the country's local currency (EGP for Egypt, SAR for Saudi Arabia, AED for UAE). - **`categories`** — Industry codes to filter by (advanced). Leave empty for all industries. - **`maxResults`** — Maximum total jobs to return across all searches. Set 0 to disable the cap. (default: `50`) - **`maxPages`** — Cap on result pages per search query (page size is 15). (default: `10`) - ...and 19 more parameters ### Input examples **Basic search** — Keyword-driven search with a result cap. → Full payload per result — all standard fields populated where the source provides them. ```json { "query": "developer", "maxResults": 50 } ```` **Filtered search** — Narrow results with advanced filters — only matching jobs are returned. → Same field set as basic search; fewer, more relevant rows. ```json { "query": "developer", "employmentType": "", "careerLevel": "", "maxResults": 100 } ``` **Incremental tracking** — Only emit jobs that changed since the previous run with this `stateKey`. → First run builds the baseline state. Subsequent runs emit only records that are new or whose tracked content changed. Set `emitUnchanged: true` to include unchanged records as well. ```json { "query": "developer", "maxResults": 200, "incrementalMode": true, "stateKey": "developer-tracker" } ``` **Compact filtered output** — Combine filters with compact mode for a lightweight AI-agent or MCP data source. → Core fields only — ideal for piping into LLMs or downstream tools without token overhead. ```json { "query": "developer", "employmentType": "", "careerLevel": "", "maxResults": 50, "compact": true } ``` ### Output Each run produces a dataset of structured job records. Results can be downloaded as JSON, CSV, or Excel from the Dataset tab in Apify Console. ### Example job record ```json { "jobId": "ff1e47038ecf1cd6d3dd77288e871d7cbf659d5510c07659daadcacbe28ffc25", "jobKey": "8r4uol2csi8n", "title": "Senior Oracle Developer (E-Business Suite).", "description": "Designs, delivers customizations and extensions to the Oracle E-Business Suite using Oracle development tools, including Oracle Forms, Reports and PL/SQL to meet specific business needs and improve pr...", "descriptionHtml": "