{ "openapi": "3.0.1", "info": { "title": "LinkedIn Jobs Scraper + Direct Apply Links & API", "description": "LinkedIn jobs for recruiting and hiring research, plus the original posting from the company job board: direct apply link, salary and full description.", "version": "0.1", "x-build-id": "buLja0nTPlsrr6nY7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dev_web_col~company-jobs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dev_web_col-company-jobs", "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/dev_web_col~company-jobs/runs": { "post": { "operationId": "runs-sync-dev_web_col-company-jobs", "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/dev_web_col~company-jobs/run-sync": { "post": { "operationId": "run-sync-dev_web_col-company-jobs", "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": { "searchKeyword": { "title": "Search jobs", "type": "string", "description": "What to search for on LinkedIn, e.g. \"python developer\", \"marketing manager\", \"nurse\". This is the normal way to use the actor. Leave it empty only if you want to target specific companies below instead." }, "company": { "title": "Single company (API lookup)", "type": "string", "description": "One company name, for when you call this Actor as an API — every open role at that company, cross-referenced with its own job board. For several companies, use the list below." }, "location": { "title": "Location", "type": "string", "description": "City, region or country: Berlin, London, United States, Remote. Leave empty to search worldwide." }, "postedWithin": { "title": "Posted within", "enum": [ "", "24h", "week", "month" ], "type": "string", "description": "Only jobs published recently. The tightest window is the most useful one: it is how you catch a role before the applications pile up.", "default": "" }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Keeps only roles LinkedIn flags as remote.", "default": false }, "companies": { "title": "Or: specific companies", "type": "array", "description": "Several company names at once, one per line. Each returns all of its open roles. Use this for batch runs rather than a live lookup.", "default": [], "items": { "type": "string" } }, "titleKeyword": { "title": "Job title contains", "type": "string", "description": "Extra filter applied to the job title after fetching, e.g. \"senior\". Leave empty to keep everything." }, "sources": { "title": "Sources", "type": "array", "description": "Leave empty to use both. LinkedIn alone is faster; the company job board alone avoids LinkedIn entirely and never gets blocked.", "items": { "type": "string", "enum": [ "linkedin", "ats" ], "enumTitles": [ "LinkedIn", "Company job board (Greenhouse, Lever, Ashby, Workable)" ] }, "default": [] }, "maxPagesPerCompany": { "title": "LinkedIn pages to fetch", "minimum": 1, "maximum": 100, "type": "integer", "description": "Each page is 10 jobs. In search mode this is the total; in company mode it is per company.", "default": 10 }, "maxResults": { "title": "Max jobs to return", "minimum": 1, "type": "integer", "description": "Safety cap. You are charged per job returned.", "default": 2000 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Required for LinkedIn. It blocks datacenter IPs, including Apify's, so runs without a residential proxy return nothing from LinkedIn.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }