{ "openapi": "3.0.1", "info": { "title": "Hiring Change Monitor", "description": "Monitor public job boards powered by Lever and detect new, removed, updated, remote, salary, and hiring-trend changes between runs.", "version": "0.2", "x-build-id": "vR9u0Agcr4y88MBnB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/woolly_kingcrab~lever-hiring-change-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-woolly_kingcrab-lever-hiring-change-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/woolly_kingcrab~lever-hiring-change-monitor/runs": { "post": { "operationId": "runs-sync-woolly_kingcrab-lever-hiring-change-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/woolly_kingcrab~lever-hiring-change-monitor/run-sync": { "post": { "operationId": "run-sync-woolly_kingcrab-lever-hiring-change-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", "required": [ "companies" ], "properties": { "companies": { "title": "Companies / Lever board URLs", "type": "array", "description": "Lever company slugs (e.g. \"netflix\") or full jobs.lever.co / jobs.eu.lever.co board URLs.", "items": { "type": "string" } }, "monitorId": { "title": "Monitor ID", "type": "string", "description": "Stable name for this monitoring configuration. Reuse the SAME value on every scheduled run so the Actor can compare against the previous baseline. Use different IDs for unrelated watch lists.", "default": "default" }, "outputMode": { "title": "Output mode", "enum": [ "CHANGES_ONLY", "ALL_JOBS" ], "type": "string", "description": "CHANGES_ONLY returns just the change events (recommended for schedules). ALL_JOBS also returns one row per currently open job.", "default": "CHANGES_ONLY" }, "keywords": { "title": "Keywords", "type": "array", "description": "Optional. Keep only jobs whose title, team or description contains at least one of these (case-insensitive).", "items": { "type": "string" }, "default": [] }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Optional. Drop jobs whose title, team or description contains any of these.", "items": { "type": "string" }, "default": [] }, "locationFilter": { "title": "Location filter", "type": "array", "description": "Optional. Keep only jobs whose location matches one of these values (substring match, case-insensitive).", "items": { "type": "string" }, "default": [] }, "remoteOnly": { "title": "Remote only", "type": "boolean", "description": "Keep only postings Lever marks as remote.", "default": false }, "maxJobs": { "title": "Max jobs per company", "minimum": 0, "type": "integer", "description": "Optional cap on jobs tracked per company (0 = no limit). Lowest job IDs are kept.", "default": 0 }, "salaryChangeThresholdPct": { "title": "Salary change threshold (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Ignore salary-midpoint changes smaller than this percentage. 0 reports any salary-range change.", "default": 0 }, "enableWebhook": { "title": "Send results to a webhook", "type": "boolean", "description": "POST the run result to webhookUrl after a successful run.", "default": false }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "HTTPS destination for the webhook. Private / local addresses are rejected.", "default": "" } } }, "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 } } } } } } } } } }