{ "openapi": "3.0.1", "info": { "title": "MENA Jobs Scraper — Bayt, GulfTalent, NaukriGulf & Akhtaboot", "description": "Job postings from Bayt, GulfTalent, NaukriGulf and Akhtaboot in one normalized schema: title, company, location, salary, seniority, function. Cross-board duplicates merged. Optional: only jobs posted since your last run.", "version": "0.1", "x-build-id": "UXnKczLmdsy7lxIR9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/almoutasem_nabil~mena-jobs-aggregator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-almoutasem_nabil-mena-jobs-aggregator", "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/almoutasem_nabil~mena-jobs-aggregator/runs": { "post": { "operationId": "runs-sync-almoutasem_nabil-mena-jobs-aggregator", "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/almoutasem_nabil~mena-jobs-aggregator/run-sync": { "post": { "operationId": "run-sync-almoutasem_nabil-mena-jobs-aggregator", "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": { "keywords": { "title": "Keywords", "type": "array", "description": "Job titles or skills, in Arabic or English. A posting matches if any keyword appears in its title or company. Leave empty to take everything the selected boards list for your countries.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "ISO-2 codes: SA, AE, QA, KW, BH, OM, JO, EG, LB. Boards that do not cover a country are skipped for it rather than failing.", "default": [ "SA", "AE" ], "items": { "type": "string" } }, "boards": { "title": "Job boards", "type": "array", "description": "Which boards to search. GulfTalent, NaukriGulf and Akhtaboot work with the default Apify datacenter proxy. Bayt blocks datacenter IPs, so Bayt requests always go through Apify residential proxies (billed to your account as residential proxy usage, about $0.02 per 1,000 Bayt jobs).", "items": { "type": "string", "enum": [ "bayt", "gulftalent", "naukrigulf", "akhtaboot" ], "enumTitles": [ "Bayt", "GulfTalent", "NaukriGulf", "Akhtaboot" ] }, "default": [ "bayt", "gulftalent", "naukrigulf", "akhtaboot" ] }, "postedWithinDays": { "title": "Posted within days", "minimum": 0, "maximum": 365, "type": "integer", "description": "Ignore postings older than this. 0 keeps everything the boards return.", "default": 7 }, "functions": { "title": "Job functions", "type": "array", "description": "Keep only these functions, classified from the title: engineering, data, product, design, sales, marketing, customer_success, support, operations, finance, hr, legal, other.", "items": { "type": "string" } }, "seniority": { "title": "Seniority", "type": "array", "description": "Keep only these levels: intern, junior, mid, senior, staff, lead, manager, director, vp, c_level.", "items": { "type": "string" } }, "employmentType": { "title": "Employment type", "type": "array", "description": "Keep only these types: full_time, part_time, contract, temporary, internship.", "items": { "type": "string" } }, "remoteOnly": { "title": "Remote only", "type": "boolean", "description": "Keep only postings that say they are remote.", "default": false }, "maxJobsPerBoard": { "title": "Max jobs per board", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many postings per board, before keyword filtering and deduplication (GulfTalent and Akhtaboot filter keywords locally, so raise this when you search for a narrow keyword). The prefilled 10 keeps a first test run small; raise it (up to 5000) for real pulls.", "default": 500 }, "dedupe": { "title": "Merge cross-board duplicates", "type": "boolean", "description": "Merge the same vacancy across boards into one item listing every board it appeared on. Turn off to get one item per board posting.", "default": true }, "emitChangesOnly": { "title": "Emit changes only", "type": "boolean", "description": "Output only what changed since the last run with the same tracking ID: job_added, job_removed, job_updated. Off = output every matching job. A run with nothing new contains one free no_changes row that says why.", "default": false }, "trackingId": { "title": "Tracking ID", "type": "string", "description": "Name of this watch list. Required when 'Emit changes only' is on. Snapshots are stored under this key in the 'mena-jobs-state' key-value store." }, "emitBaselineAsAdded": { "title": "Emit baseline as added", "type": "boolean", "description": "On the very first run for a tracking ID, emit every job as job_added. Off = the first run records the baseline silently.", "default": false }, "includeDescription": { "title": "Include description", "type": "boolean", "description": "Include the full job description where the board publishes it. Makes items much larger.", "default": false }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many boards are searched in parallel. Lower it if a board starts rate-limiting you.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy for GulfTalent, NaukriGulf and Akhtaboot; Apify datacenter proxies (the default) work for all three. Bayt always uses Apify residential proxies, whatever is set here.", "default": { "useApifyProxy": 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 } } } } } } } } } }