{ "openapi": "3.0.1", "info": { "title": "Indeed Company Jobs Monitor — Hiring Signals & Alerts", "description": "From $0.005 per company snapshot + $0.0005 per job — monitor any employer's newest Indeed postings, diff runs to flag new & closed roles, and get Slack/email/webhook hiring-signal alerts. Salary, location, remote flag, dates & company rating included. No login or API key.", "version": "0.1", "x-build-id": "fWE0ZetD4YkGORj0f" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapersdelight~indeed-company-hiring-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapersdelight-indeed-company-hiring-monitor", "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/scrapersdelight~indeed-company-hiring-monitor/runs": { "post": { "operationId": "runs-sync-scrapersdelight-indeed-company-hiring-monitor", "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/scrapersdelight~indeed-company-hiring-monitor/run-sync": { "post": { "operationId": "run-sync-scrapersdelight-indeed-company-hiring-monitor", "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": { "companies": { "title": "Target companies", "type": "array", "description": "Company names to track, one per line (e.g. 'Walmart', 'Netflix'). Each is searched as an employer on Indeed's job-search API, newest postings first, and filtered to the exact employer (see Company-name matching). For exact employer scoping pass the Indeed company-page slug as 'cmp:' or a https://www.indeed.com/cmp/ URL (any country host) — those are matched on Indeed's own employer page identity.", "items": { "type": "string" } }, "country": { "title": "Indeed country site", "enum": [ "US", "UK", "CA", "AU", "IN", "DE", "FR", "JP", "BR", "MX", "IT", "ES", "NL", "BE", "CH", "AT", "SG", "HK", "IE", "NZ", "AR", "BH", "CL", "CN", "CO", "CR", "CZ", "DK", "EC", "EG", "FI", "GR", "HU", "ID", "IL", "KR", "KW", "LU", "MA", "MY", "NG", "NO", "OM", "PA", "PE", "PH", "PK", "PL", "PT", "QA", "RO", "SA", "SE", "TH", "TR", "TW", "UA", "AE", "UY", "VE", "VN", "ZA" ], "type": "string", "description": "Which Indeed site to search: US = www.indeed.com, UK = uk.indeed.com, DE = de.indeed.com, and so on. Labels (job types, benefits) and salary currency follow the site. A cmp URL with a country host (e.g. https://de.indeed.com/cmp/Lidl) overrides this for that company.", "default": "US" }, "maxJobsPerCompany": { "title": "Max jobs per company", "minimum": 0, "type": "integer", "description": "Newest postings kept per company per run — this is the monitor window (0 = all; Indeed serves up to 1,000 per search, 100 per request). 50 covers most employers; raise it for very high-volume ones, or narrow with a location / title keyword." }, "monitorMode": { "title": "Monitor mode (new/closed-posting watcher)", "type": "boolean", "description": "Recurring watcher: diff each company's current postings against the prior run (state kept in a named key-value store) and output NEW-posting and CLOSED-posting signal records. The first run per company seeds a baseline (full snapshot, no 'new' flags or alerts). Pair with an Apify Schedule. Off = plain snapshot of all current postings." }, "companyMatch": { "title": "Company-name matching", "enum": [ "contains", "exact", "off" ], "type": "string", "description": "Indeed's employer search is fuzzy ('Stripe' also matches 'Stripe-A-Zone'), so results are filtered by the exact employer field. 'contains' (default) keeps employers whose name contains your query (catches 'Walmart Supply Chain'); 'exact' requires an exact name match; 'off' keeps everything Indeed returned. 'cmp:' targets are always matched on Indeed's exact employer page.", "default": "contains" }, "keyword": { "title": "Title keyword filter", "type": "string", "description": "Optional. Keep only postings whose TITLE contains this text (case-insensitive), e.g. 'engineer', 'account executive'." }, "locationQuery": { "title": "Location (server-side)", "type": "string", "description": "Optional. Passed to Indeed's location search with a 25-mile radius, e.g. 'New York, NY', 'Austin, TX' or 'Remote' — narrows the search itself." }, "locationFilter": { "title": "Location filter (client-side)", "type": "string", "description": "Optional. Keep only postings whose location contains this text, e.g. 'TX', 'Chicago'." }, "remoteOnly": { "title": "Remote postings only", "type": "boolean", "description": "Keep only postings Indeed tags as remote (applied by Indeed's search and re-checked on every row).", "default": false }, "newWithinDays": { "title": "Only postings from the last N days", "minimum": 0, "type": "integer", "description": "Optional. Keep only postings that appeared on Indeed within the last N days (0 = all). Applied by Indeed's search and re-checked on every row.", "default": 0 }, "fetchDescriptions": { "title": "Fetch full job descriptions", "type": "boolean", "description": "Opt-in enrichment: add each delivered posting's full description (text + HTML) from Indeed's job API, 50 postings per request. Charged as lot-detail-enriched per posting that receives a description. The 300-character snippet and the benefits list are on every row regardless.", "default": false }, "detectClosed": { "title": "Detect closed postings (monitor mode)", "type": "boolean", "description": "In monitor mode, when a previously-seen posting leaves the company's newest-jobs window, VERIFY it through Indeed's job API and emit a 'closed-posting' record only if Indeed reports it expired or no longer holds it (no false closes from window rotation).", "default": true }, "maxCloseChecksPerRun": { "title": "Max close-checks per run", "minimum": 0, "type": "integer", "description": "Cap on closed-posting verifications per run (0 = unlimited; 50 postings per request). Unchecked candidates are re-queued next run, least-recently-checked first.", "default": 25 }, "alertOnNewPosting": { "title": "Alert on new postings", "type": "boolean", "description": "In monitor mode, send an alert for each newly-detected posting.", "default": true }, "alertOnClosedPosting": { "title": "Alert on closed postings", "type": "boolean", "description": "In monitor mode, also alert when a posting closes.", "default": false }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "POST endpoint for hiring-signal alerts (JSON payload per signal)." }, "slackWebhookUrl": { "title": "Slack webhook URL", "type": "string", "description": "Slack incoming-webhook URL for hiring-signal alerts." }, "emailRecipients": { "title": "Email recipients", "type": "array", "description": "Emails for the hiring-signal digest (via apify/send-mail).", "items": { "type": "string" } }, "requestDelaySecs": { "title": "Delay between companies (seconds)", "minimum": 0, "type": "integer", "description": "Pause between company searches. The API path needs no pacing (0, default); set a value to pace very large company lists.", "default": 0 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Proxy settings. On the Apify platform a proxy is required (Indeed refuses direct connections from Apify's network); the default Apify datacenter group served every test call.", "default": { "useApifyProxy": true } }, "diagnose": { "title": "Diagnostic mode (dev)", "type": "boolean", "description": "Dev only. Searches the first target and logs the first mapped posting, then exits.", "default": false } } }, "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 } } } } } } } } } }