{ "openapi": "3.0.1", "info": { "title": "Wuzzuf Jobs Scraper", "description": "[💰 $0.9 / 1K] Extract job postings from Wuzzuf, the leading job board for Egypt and the MENA region. Search by keyword and location, filter by career level, job type, workplace, and posting date — each result includes title, company, location, salary, skills, full description, and apply link.", "version": "1.0", "x-build-id": "TSpXHqOfnn6tbaF5k" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~wuzzuf-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-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/solidcode~wuzzuf-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-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/solidcode~wuzzuf-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-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": { "searchKeyword": { "title": "Search Keyword", "type": "string", "description": "Word or phrase to match across job title and description (e.g. 'software engineer', 'accountant', 'sales'). Leave blank to collect all jobs matching the filters below." }, "startUrls": { "title": "Wuzzuf Search URLs", "uniqueItems": true, "type": "array", "description": "Paste one or more Wuzzuf search-result URLs to scrape them directly (e.g. a search page you built on wuzzuf.net with your own filters applied). When provided, these take priority over the keyword and location above.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Filter to an exact city name as it appears on Wuzzuf (e.g. 'Cairo', 'Giza', 'Alexandria'). Must be the full English city name — partial text and governorate names are not matched. Leave blank for any location." }, "careerLevel": { "title": "Career Level", "uniqueItems": true, "type": "array", "description": "Only include jobs at these seniority levels. Leave empty to include all levels.", "items": { "type": "string", "enum": [ "student", "entry_level", "experienced", "manager", "senior_management" ], "enumTitles": [ "Student / Internship", "Entry Level", "Experienced (Non-Manager)", "Manager / Supervisor", "Senior Management (CEO, GM, Director)" ] }, "default": [] }, "jobTypes": { "title": "Job Types", "uniqueItems": true, "type": "array", "description": "Only include jobs of these employment types. Leave empty to include all types.", "items": { "type": "string", "enum": [ "full_time", "part_time", "freelance", "internship", "shift_based", "volunteering" ], "enumTitles": [ "Full Time", "Part Time", "Freelance / Project", "Internship", "Shift Based", "Volunteering" ] }, "default": [] }, "workplaceTypes": { "title": "Workplace", "uniqueItems": true, "type": "array", "description": "Only include jobs with these workplace arrangements. Leave empty to include all.", "items": { "type": "string", "enum": [ "on_site", "remote", "hybrid" ], "enumTitles": [ "On-site", "Remote", "Hybrid" ] }, "default": [] }, "postedWithinDays": { "title": "Posted Within", "enum": [ "0", "within_24_hours", "within_1_week", "within_1_month" ], "type": "string", "description": "Only include jobs posted within this time window. Great for daily or weekly scheduled runs that pick up just the newest postings. Wuzzuf supports three windows: last 24 hours, last week, and last month.", "default": "0" }, "maxResults": { "title": "Maximum Results", "minimum": 0, "type": "integer", "description": "Hard cap on total job rows returned. Default 100 — increase for bigger runs, or set to 0 for no cap (an internal upper bound still applies to prevent runaway pagination). The actor stops requesting new pages once this number is hit but keeps the full last page even if it slightly overshoots.", "default": 100 } } }, "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 } } } } } } } } } }