{ "openapi": "3.0.1", "info": { "title": "LinkedIn Jobs Scraper — Salary, Applicants & Company Data", "description": "Scrape public LinkedIn jobs by keyword & location — no login. Title, company, location, full description, seniority, employment type, applicant count, PARSED salary, and optional company firmographic enrichment (employees, industry, HQ, domain). For recruiting, market research & sales intent.", "version": "0.1", "x-build-id": "YUh63SnDk6mZawR7O" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/foxlabs~linkedin-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-foxlabs-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/foxlabs~linkedin-jobs-scraper/runs": { "post": { "operationId": "runs-sync-foxlabs-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/foxlabs~linkedin-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-foxlabs-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": "Keywords", "type": "string", "description": "Job title, skill or keyword to search — e.g. \"software engineer\", \"account executive\", \"react\"." }, "location": { "title": "Location", "type": "string", "description": "City, region or country — e.g. \"New York\", \"London\", \"Germany\", \"European Union\". Leave blank to search worldwide." }, "workplaceType": { "title": "Workplace type", "type": "string", "description": "No longer applied: LinkedIn's public job pages ignore the workplace filter (the results do not change) and do not state a job's workplace type reliably. Kept so saved inputs still run. Add \"remote\" or \"hybrid\" to the keywords instead." }, "datePosted": { "title": "Date posted", "enum": [ "any", "24h", "week", "month" ], "type": "string", "description": "Only jobs posted within this window. Use \"Past 24 hours\" or \"Past week\" for fresh hiring signals.", "default": "any" }, "experienceLevel": { "title": "Experience level", "enum": [ "any", "internship", "entry", "associate", "mid-senior", "director", "executive" ], "type": "string", "description": "Keep only jobs whose page states this seniority. LinkedIn's own seniority filter has no effect on its public pages, so the Actor reads each listed job's page (full details are switched on) and reads at most 10 listed jobs per requested job. Many employers state \"Not Applicable\" and are then left out.", "default": "any" }, "jobType": { "title": "Employment type", "enum": [ "any", "full-time", "part-time", "contract", "temporary", "internship" ], "type": "string", "description": "Keep only jobs whose page states this employment type. Like seniority, this is applied by the Actor on each job's page (full details are switched on), reading at most 10 listed jobs per requested job.", "default": "any" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many jobs to return (1–1000). LinkedIn's public search caps at ~1000 per query — narrow with keywords, location or date for large searches.", "default": 100 }, "scrapeDetails": { "title": "Scrape full details", "type": "boolean", "description": "Open each job for its full description, seniority, employment type, job function, industries, applicant count and parsed salary. Turn off for a faster, lighter run (list fields only).", "default": true }, "enrichCompany": { "title": "Enrich with company firmographics", "type": "boolean", "description": "Add employer firmographics (employee count, industry, HQ, website domain, followers) from the company's public LinkedIn page. One extra request per unique company, cached — repeated employers are not refetched. Resolves for roughly 6 in 10 employers; it also sharpens ownership matching by supplying the employer's domain.", "default": false }, "includeOwnership": { "title": "Reveal ultimate beneficial owner (KYB)", "type": "boolean", "description": "Resolve each employer to its ULTIMATE beneficial owner — a real person or a cross-border parent company — by walking UK holding-company ownership chains (Companies House PSC + GLEIF). E.g. an employer owned via layers by a US or private-equity parent. Confidence-gated: the owner is only attached when it can be resolved with high confidence (never guessed). Turn on company enrichment to sharpen the match via the employer's domain.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Proxy configuration. Residential proxy (the default) is strongly recommended — LinkedIn rate-limits and blocks un-proxied and datacenter traffic.", "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 }, "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 } } } } } } } } } }