{ "openapi": "3.0.1", "info": { "title": "LinkedIn Jobs Scraper - Full Descriptions & Job Feeds", "description": "Search public LinkedIn jobs with full descriptions, company data, source filters and persistent only-new monitoring. No LinkedIn login or third-party API key.", "version": "1.0", "x-build-id": "13q1pTAKyYbmzxJdP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/benthepythondev~linkedin-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-benthepythondev-linkedin-jobs-scraper", "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/benthepythondev~linkedin-jobs-scraper/runs": { "post": { "operationId": "runs-sync-benthepythondev-linkedin-jobs-scraper", "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/benthepythondev~linkedin-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-benthepythondev-linkedin-jobs-scraper", "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 keywords", "type": "string", "description": "Plain-text source search. Strict matching requires every word in the title or full description; disable it for source-defined query syntax.", "default": "python" }, "location": { "title": "Location", "type": "string", "description": "Location passed to LinkedIn.", "default": "Berlin, Germany" }, "jobUrls": { "title": "Direct job URLs or IDs", "type": "array", "description": "Public /jobs/view/ URLs or numeric IDs. Overrides search; keyword and recency filters do not apply.", "items": { "type": "string" } }, "maxResults": { "title": "Maximum matching jobs", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum jobs collected in this snapshot, before only-new filtering. LinkedIn serves at most 1,000 results per search.", "default": 10 }, "maxPages": { "title": "Maximum search pages", "minimum": 1, "maximum": 100, "type": "integer", "description": "Scan at most this many result pages even when fewer jobs match. A page has ten jobs, so 100 pages reach LinkedIn's 1,000-result limit.", "default": 5 }, "timeRange": { "title": "Posted within", "enum": [ "all", "day", "week", "month" ], "type": "string", "description": "Source recency filter, also checked against available calendar dates. Not an exact-hour timestamp guarantee.", "default": "week" }, "sortBy": { "title": "Source ordering", "enum": [ "date", "relevance" ], "type": "string", "description": "Ordering requested from LinkedIn; the source may rank or recommend results.", "default": "date" }, "strictKeywords": { "title": "Require all keyword words", "type": "boolean", "description": "Reject unrelated source recommendations: every keyword word must occur in the title or description, ignoring case.", "default": true }, "workTypes": { "title": "Workplace filters", "type": "array", "description": "Pass these filters to LinkedIn. Leave empty for any.", "items": { "type": "string", "enum": [ "1", "2", "3" ], "enumTitles": [ "Onsite", "Remote", "Hybrid" ] } }, "jobTypes": { "title": "Employment filters", "type": "array", "description": "Pass these filters to LinkedIn. Leave empty for any.", "items": { "type": "string", "enum": [ "F", "P", "C", "T", "I", "V", "O" ], "enumTitles": [ "Full time", "Part time", "Contract", "Temporary", "Internship", "Volunteer", "Other" ] } }, "experienceLevels": { "title": "Experience filters", "type": "array", "description": "Pass these filters to LinkedIn. Leave empty for any.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6" ], "enumTitles": [ "Internship", "Entry level", "Associate", "Mid senior", "Director", "Executive" ] } }, "onlyNew": { "title": "Only newly observed jobs", "type": "boolean", "description": "Persist IDs in your account and omit previously exported jobs from later snapshots.", "default": false }, "monitorId": { "title": "Saved search name", "type": "string", "description": "Use one name per search and separate names for different filters. Avoid overlapping runs." }, "firstRunMode": { "title": "First monitor run", "enum": [ "emitAll", "seedOnly" ], "type": "string", "description": "Return initial jobs or seed the baseline without exporting the existing backlog.", "default": "emitAll" }, "resetState": { "title": "Reset this monitor once", "type": "boolean", "description": "Discard this monitor baseline only. Turn this off again before scheduling.", "default": false }, "proxyConfiguration": { "title": "Optional proxy", "type": "object", "description": "Leave as is: the Actor reads through one direct address and several residential ones at no extra charge to you. Supply your own proxy only if you want all requests to leave through it.", "default": { "useApifyProxy": 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 } } } } } } } } } }