{ "openapi": "3.0.1", "info": { "title": "Freelance Job Leads Monitor — Contract Alerts", "description": "Watch public LinkedIn Jobs for freelance and contract postings in your niche and get only the new leads since your last run. Every lead carries the company website, LinkedIn page and employee count, plus job URL, posted date, salary and applicant count. Run it weekly.", "version": "1.0", "x-build-id": "qcTTLMnfGZ6PpvOlU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/davidbenittah~freelance-job-leads-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-davidbenittah-freelance-job-leads-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/davidbenittah~freelance-job-leads-monitor/runs": { "post": { "operationId": "runs-sync-davidbenittah-freelance-job-leads-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/davidbenittah~freelance-job-leads-monitor/run-sync": { "post": { "operationId": "run-sync-davidbenittah-freelance-job-leads-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": [ "keywords" ], "properties": { "keywords": { "title": "Job keywords to watch", "type": "array", "description": "What you would type in the LinkedIn Jobs search bar, e.g. 'video editor' or 'brand designer'. Hard maximum: 5 keywords per run.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Free-text location as LinkedIn accepts it, e.g. 'United States', 'France' or 'London'. Leave empty for worldwide." }, "postedWithin": { "title": "Posted within", "enum": [ "day", "week", "month" ], "type": "string", "description": "Only scan jobs posted in this window. 'week' is the sweet spot for a weekly schedule.", "default": "week" }, "requireFreelanceSignal": { "title": "Keep only freelance/contract jobs", "type": "boolean", "description": "When enabled (default), a job is kept only if its employment type is Contract/Temporary or its title/description contains a freelance signal. Disable to monitor ALL new jobs for the keywords.", "default": true }, "freelanceSignals": { "title": "Freelance signal phrases", "type": "array", "description": "Phrases (case-insensitive) that mark a job as freelance/contract work when found in the title or description. Leave empty to use the built-in list (freelance, independent contractor, contract basis, temporary, prestataire...).", "items": { "type": "string" } }, "maxJobsPerSearch": { "title": "Max jobs per keyword", "minimum": 1, "maximum": 200, "type": "integer", "description": "Safety cap on jobs scanned per keyword. Hard maximum: 200.", "default": 50 }, "scrapeCompanyDetails": { "title": "Enrich with company details", "type": "boolean", "description": "Adds company website, LinkedIn page and employee count to each lead (slower scrape).", "default": true }, "includeBaselineInOutput": { "title": "Output the baseline on first run", "type": "boolean", "description": "The very first run saves a baseline of current postings. When enabled, those leads are also pushed to the dataset (flagged isBaseline=true). Later runs always output only NEW leads.", "default": true }, "monitorId": { "title": "Custom monitor ID", "type": "string", "description": "Optional. Advanced: name this monitor to keep several baselines for the same search, or reset one by changing the ID." } } }, "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 } } } } } } } } } }