{ "openapi": "3.0.1", "info": { "title": "LinkedIn Jobs Scraper: Job Postings with Full Descriptions", "description": "Search LinkedIn jobs by role or skill, like \"data engineer\", or by company, by name, website or LinkedIn page, filtered by location and date posted. Each posting comes with company, pay, applicants, seniority and full description. No login. Empty searches are not charged.", "version": "0.1", "x-build-id": "VCYzyen6f0mIsiBT6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hydrafetch~linkedin-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hydrafetch-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/hydrafetch~linkedin-jobs-scraper/runs": { "post": { "operationId": "runs-sync-hydrafetch-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/hydrafetch~linkedin-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-hydrafetch-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": { "searches": { "title": "searches", "type": "array", "description": "The searches to process, one per line. Role or skill terms like \"data engineer\", or LinkedIn jobs search links. To see what one company is hiring for, set Search by to Company and give its name, website or LinkedIn company link.", "items": { "type": "string", "pattern": "^\\s*\\S.{0,1998}\\S?\\s*$" } }, "location": { "title": "Location", "type": "string", "description": "Where the jobs are, like \"United States\", \"London\" or \"Berlin, Germany\". Leave empty for anywhere. A pasted LinkedIn search link uses its own location." }, "searchBy": { "title": "Search by", "enum": [ "keywords", "company" ], "type": "string", "description": "Keywords searches jobs by role or skill. Company treats each line as a company, by name, website or LinkedIn company link, and returns the jobs that company has open.", "default": "keywords" }, "postedWithin": { "title": "Posted within", "enum": [ "any", "24h", "week", "month" ], "type": "string", "description": "Only jobs posted in this window.", "default": "any" }, "maxJobsPerSearch": { "title": "Max jobs per search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many jobs to return for each search, at most 1,000.", "default": 25 }, "includeDescriptions": { "title": "Include full descriptions", "type": "boolean", "description": "Read each job page for the full description, applicant count, seniority, employment type, function, industries and pay. Off returns the list only, at the lower price.", "default": true }, "onlyNewJobs": { "title": "Only new jobs", "type": "boolean", "description": "Return only jobs this account has not received from the same search before, so a scheduled run delivers and charges for new postings only. Remembered for 45 days per search.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Send this run's requests through your own Apify Proxy, billed to your Apify account, for example residential addresses in a chosen country. This needs a paid Apify plan, because the requests leave the Apify platform; on a free plan the run uses our network and says so. Leave it off and the run uses our network, which works for most sites.", "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 } } } } } } } } } }