{ "openapi": "3.0.1", "info": { "title": "Drushim.co.il [$1/1k] Job Scraper", "description": "[$1/1k] Scrape Drushim.co.il — Israel's leading job board — by keyword (Hebrew or English), category, region or any pasted URL. Full descriptions + requirements, salary where published, skill tags, geo-coded cities, direct apply links. Incremental monitoring built in. $1 per 1,000 jobs.", "version": "0.0", "x-build-id": "y6aMVmwKZFcWsdpg4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~drushim-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-drushim-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/memo23~drushim-scraper/runs": { "post": { "operationId": "runs-sync-memo23-drushim-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/memo23~drushim-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-drushim-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 keywords", "type": "array", "description": "Job search keywords, Hebrew or English — each entry runs as its own drushim search (e.g. `מפתח`, `מנהל מוצר`, `QA`).", "items": { "type": "string" } }, "category": { "title": "Category code", "type": "integer", "description": "Drushim category (`catdir`) code, e.g. `6` = הייטק-תוכנה (software / hi-tech). Find the code in any category URL: drushim.co.il/jobs/cat6/ → 6. Combined with every keyword; also works with no keyword at all (full-category browse)." }, "area": { "title": "Region / zone codes", "type": "array", "description": "Zone codes (`area`) to filter by, e.g. `1` = מרכז (Center), as seen in drushim.co.il/jobs/area/1-2-3/ URLs. Leave empty for all of Israel." }, "experience": { "title": "Experience-level codes", "type": "array", "description": "Experience filter codes (`experience`) as used by the site's filter URLs (e.g. `4` = 5-6 שנים). Leave empty for any experience." }, "scope": { "title": "Position-scope codes", "type": "array", "description": "Scope filter codes (`scope`) — e.g. `1` = משרה מלאה (full-time). Leave empty for all scopes." }, "cvOptional": { "title": "Only jobs that don't require a CV", "type": "boolean", "description": "Limit to postings that accept applications without an uploaded CV (the site's משרות ללא קורות חיים filter).", "default": false }, "includeExtendedMatches": { "title": "Include broadened matches", "type": "boolean", "description": "Drushim lists broadened matches, related jobs that do not necessarily contain your keyword, after a search's exact matches. A search with exact matches returns only those. A search with none, which is common for niche keywords, returns the broadened rows instead, each with isExtendedMatch: true. Turn this off to return exact matches only, so you do not pay for broadened rows.", "default": true }, "startUrls": { "title": "Drushim.co.il URLs (optional)", "type": "array", "description": "Full drushim.co.il URLs to crawl instead of (or in addition to) keyword searches. Supported: search pages with any filters, `/jobs/cat{N}/`, `/jobs/subcat/{N}/`, `/jobs/area/{codes}/`, raw `/api/jobs/search?…` URLs, and direct job pages (`/job/{code}/{hash}/`).", "items": { "type": "string" } }, "enrichEmails": { "title": "Enrich with employer contact emails (experimental, billed per email)", "type": "boolean", "description": "If enabled, tries to discover a contact email for each hiring employer from public sources (name-based discovery — drushim postings don't expose employer websites). Adds contactEmail + contactWebsite columns plus a detailed emailEnrichment object. Best-effort; only charged when an email is returned, never for misses.", "default": false }, "qualifyByPayment": { "title": "💳 Qualify by payment (flag businesses that take money online)", "type": "boolean", "description": "Requires \"Enrich with contact emails\". Scans each discovered employer site — reusing the pages already fetched for email discovery — for payment processors and e-commerce platforms. Adds takesPayments, paymentProcessors, stripeLiveKey and paymentConfidence. No extra charge.", "default": false }, "includeKeywords": { "title": "✅ Include keywords", "type": "array", "description": "Only keep jobs whose title, company, description or requirements contains at least one of these (case-insensitive, Hebrew or English). Filtered rows are never charged.", "items": { "type": "string" } }, "excludeKeywords": { "title": "🚫 Exclude keywords", "type": "array", "description": "Drop jobs whose title, company, description or requirements contains any of these (case-insensitive).", "items": { "type": "string" } }, "fromDate": { "title": "📅 Posted from", "type": "string", "description": "Only keep jobs posted on or after this date (ISO 8601, e.g. 2026-08-01)." }, "toDate": { "title": "📅 Posted to", "type": "string", "description": "Only keep jobs posted on or before this date (ISO 8601). A date-only value means through the end of that day." }, "maxAgeMinutes": { "title": "⏱️ Max age (minutes)", "minimum": 0, "type": "integer", "description": "Only keep jobs posted within the last N minutes. Empty or 0 = no age limit. Ideal for tight scheduled runs." }, "incrementalMode": { "title": "♻️ Incremental mode", "type": "boolean", "description": "Compare against the previous run and only emit jobs that are NEW, UPDATED, or REAPPEARED — you are only charged for what changed. The first run seeds the baseline. Each emitted row carries `changeType` and `firstSeenAt`.", "default": false }, "stateKey": { "title": "🔑 State key", "type": "string", "description": "Optional stable name for this tracked search (e.g. \"dev-tel-aviv\"). Leave empty to auto-derive one from the search inputs — same inputs, same baseline." }, "emitUnchanged": { "title": "♻️ Emit unchanged records", "type": "boolean", "description": "When incremental, also emit rows whose content did not change (charged as normal results).", "default": false }, "emitExpired": { "title": "⚰️ Emit expired records", "type": "boolean", "description": "When incremental, emit a small `changeType: EXPIRED` row for every previously-tracked job that vanished from drushim.", "default": false }, "skipReposts": { "title": "🚫 Skip reposts", "type": "boolean", "description": "When incremental, skip jobs whose content matches a previously-expired posting (employer re-listed the same ad under a new id).", "default": false }, "resetIncrementalState": { "title": "🧨 Reset incremental state", "type": "boolean", "description": "One-shot: drop the stored baseline for this state key at the start of the run.", "default": false }, "compact": { "title": "📦 Compact output", "type": "boolean", "description": "Emit only the core fields (id, title, company, regions, salary, skills, apply link, dates) — small payloads for AI-agent / MCP / LLM pipelines.", "default": false }, "excludeEmptyFields": { "title": "🧹 Exclude empty fields", "type": "boolean", "description": "Drop null / empty-string / empty-array fields from each record.", "default": false }, "descriptionMaxLength": { "title": "✂️ Description max length", "minimum": 0, "type": "integer", "description": "Truncate description/requirements fields to this many characters (0 = full text). Controls LLM prompt cost and dataset size." }, "telegramBotToken": { "title": "🔔 Telegram bot token", "type": "string", "description": "Your bot's token from @BotFather. With Chat ID set, a summary of new jobs is sent after each run." }, "telegramChatId": { "title": "🔔 Telegram chat ID", "type": "string", "description": "Chat or channel id the bot posts to (e.g. \"-1001234567890\")." }, "slackWebhookUrl": { "title": "💼 Slack webhook URL", "type": "string", "description": "Slack incoming-webhook URL (api.slack.com/messaging/webhooks)." }, "discordWebhookUrl": { "title": "🎮 Discord webhook URL", "type": "string", "description": "Discord incoming-webhook URL (Server Settings → Integrations → Webhooks)." }, "whatsappAccessToken": { "title": "📱 WhatsApp access token", "type": "string", "description": "WhatsApp Cloud API token (Meta Business system user). The recipient must have messaged your business number within the last 24h — Cloud API rule." }, "whatsappPhoneNumberId": { "title": "📱 WhatsApp phone-number ID", "type": "string", "description": "Your WhatsApp Business phone-number id (numeric, from the Meta dashboard)." }, "whatsappTo": { "title": "📱 WhatsApp recipient", "type": "string", "description": "Recipient phone in E.164 without + (e.g. \"972501234567\")." }, "webhookUrl": { "title": "🪝 Generic webhook URL", "type": "string", "description": "Receives one JSON POST with { metadata, items } after the run — the universal escape hatch for n8n / Make / Zapier / custom backends." }, "webhookHeaders": { "title": "🪝 Webhook headers", "type": "object", "description": "Optional custom headers for the generic webhook (e.g. {\"Authorization\": \"Bearer …\"})." }, "notificationLimit": { "title": "🔔 Max jobs per notification", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many job lines each chat notification includes (1–20). The rest are summarised as a count.", "default": 5 }, "notifyOnlyChanges": { "title": "🔔 Notify only new/updated", "type": "boolean", "description": "With Incremental mode on, notify only about NEW / UPDATED / REAPPEARED jobs.", "default": false }, "maxItems": { "title": "Maximum jobs to scrape", "minimum": 1, "type": "integer", "description": "Hard cap on the number of jobs collected across all searches. Use this to limit billing.", "default": 1000 }, "maxPagesPerSearch": { "title": "Max pages per search", "minimum": 1, "maximum": 200, "type": "integer", "description": "Stop paginating each search after this many API pages (25 jobs on the first page, 10 on each page after it). The walk also stops automatically at the last page.", "default": 20 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Parallel search tasks / job pages. Kept modest by default — drushim rate-limits bursty clients.", "default": 4 } } }, "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 } } } } } } } } } }