{ "openapi": "3.0.1", "info": { "title": "New Job Alerts - Only Postings That Appeared Since Last Run", "description": "Each run returns only the job postings that are new since your previous run, read live from each employer's applicant tracking system. Schedule it and pipe genuinely new openings into Slack, email or a database.", "version": "0.1", "x-build-id": "SD5WLCPG5T0F5Kpd5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/starbright_overlap~new-jobs-feed/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-starbright_overlap-new-jobs-feed", "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/starbright_overlap~new-jobs-feed/runs": { "post": { "operationId": "runs-sync-starbright_overlap-new-jobs-feed", "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/starbright_overlap~new-jobs-feed/run-sync": { "post": { "operationId": "run-sync-starbright_overlap-new-jobs-feed", "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": "Job title keywords (any match)", "type": "array", "description": "Keep only postings whose title contains at least one of these. Case-insensitive. Leave empty for every job.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude titles containing", "type": "array", "description": "Drop postings whose title contains any of these, e.g. `senior`, `intern`.", "items": { "type": "string" } }, "locations": { "title": "Locations (any match)", "type": "array", "description": "Keep only postings whose location contains one of these, e.g. `london`, `germany`.", "items": { "type": "string" } }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Keep only postings flagged remote by the ATS or with a remote-looking location.", "default": false }, "feedId": { "title": "Feed name", "type": "string", "description": "Each feed name remembers its own position. Use a different name per alert you run — e.g. `remote-react` and `berlin-sales` — so they don't consume each other's new postings.", "default": "default" }, "lookbackDays": { "title": "Consider postings from the last N days", "minimum": 1, "maximum": 90, "type": "integer", "description": "A posting older than this is never treated as new, even on a first run. Raise it if you run the feed less than weekly.", "default": 7 }, "companies": { "title": "Limit to specific companies", "type": "array", "description": "Board slugs, e.g. `databricks`. Leave empty to watch the whole registry of 17,000+ companies.", "items": { "type": "string" } }, "providers": { "title": "Limit to specific ATS platforms", "type": "array", "description": "Any of: greenhouse, personio, smartrecruiters, breezy, workday, lever, workable, ashby, rippling, pinpoint. Leave empty for all.", "items": { "type": "string" } }, "maxBoards": { "title": "Max company boards to watch", "minimum": 1, "type": "integer", "description": "Boards are scanned largest-first, so a capped run still watches the most active employers. Raise for full coverage of all 17,000+ boards.", "default": 300 }, "maxJobs": { "title": "Max new postings to return", "minimum": 1, "type": "integer", "description": "Hard cap on returned rows, so a run costs what you expect. Defaults to 300 — enough for a daily alert without burning free-tier credit. Raise it for a wider sweep.", "default": 300 }, "includeDescription": { "title": "Include full job descriptions", "type": "boolean", "description": "Off by default — alerts are usually title, company and link. Turning it on makes runs slower and heavier.", "default": false }, "concurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 20, "type": "integer", "description": "Higher is faster but more likely to hit ATS rate limits.", "default": 8 }, "maxJobsPerCompany": { "title": "Max new postings per company", "minimum": 1, "type": "integer", "description": "Keeps one huge employer from filling the whole alert. Boards are scanned largest-first, so without this the biggest few use up the result budget and you stop hearing about everyone else.", "default": 25 } } }, "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 } } } } } } } } } }