{
"openapi": "3.0.1",
"info": {
"title": "LinkedIn Jobs Scraper",
"description": "Scrape public LinkedIn job postings by keyword, location and company – no login required. Returns title, company, location, posting date, salary, seniority, full description and more, with pagination, de-duplication, proxy support and an automatic stealth-browser fallback.",
"version": "0.1",
"x-build-id": "WJoCRxdQ485Fv4TI7"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/dtrungtin~linkedin-jobs-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-dtrungtin-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/dtrungtin~linkedin-jobs-scraper/runs": {
"post": {
"operationId": "runs-sync-dtrungtin-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/dtrungtin~linkedin-jobs-scraper/run-sync": {
"post": {
"operationId": "run-sync-dtrungtin-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": "array",
"description": "Job titles, skills or company names to search for – anything you would type into the LinkedIn Jobs search box. Each entry runs as its own search and results are de-duplicated.",
"items": {
"type": "string"
}
},
"location": {
"title": "Location",
"type": "string",
"description": "City, region or country exactly as you would type it into LinkedIn, e.g. New York, Germany or European Union."
},
"datePosted": {
"title": "Date posted",
"enum": [
"any",
"pastHour",
"past24Hours",
"pastWeek",
"pastMonth"
],
"type": "string",
"description": "Only return jobs posted within this time window.",
"default": "any"
},
"jobTypes": {
"title": "Job type",
"type": "array",
"description": "Leave empty for all job types.",
"items": {
"type": "string",
"enum": [
"fullTime",
"partTime",
"contract",
"temporary",
"internship",
"volunteer",
"other"
],
"enumTitles": [
"Full-time",
"Part-time",
"Contract",
"Temporary",
"Internship",
"Volunteer",
"Other"
]
},
"default": []
},
"experienceLevels": {
"title": "Experience level",
"type": "array",
"description": "Leave empty for all experience levels.",
"items": {
"type": "string",
"enum": [
"internship",
"entryLevel",
"associate",
"midSeniorLevel",
"director",
"executive"
],
"enumTitles": [
"Internship",
"Entry level",
"Associate",
"Mid-Senior level",
"Director",
"Executive"
]
},
"default": []
},
"workplaceTypes": {
"title": "Workplace type",
"type": "array",
"description": "Leave empty for on-site, remote and hybrid jobs alike.",
"items": {
"type": "string",
"enum": [
"onSite",
"remote",
"hybrid"
],
"enumTitles": [
"On-site",
"Remote",
"Hybrid"
]
},
"default": []
},
"companyIds": {
"title": "Company IDs",
"type": "array",
"description": "Restrict the search to these companies using their numeric LinkedIn company IDs (LinkedIn's f_C filter). Filter by company on linkedin.com/jobs and copy the number from the URL, e.g. 1441 for Google. This filters on LinkedIn's side, so no extra pages are fetched.",
"items": {
"type": "string"
}
},
"companyNames": {
"title": "Company names",
"type": "array",
"description": "Only keep jobs whose company name contains one of these values (case-insensitive, e.g. Amazon also matches Amazon Web Services). Applied by the scraper after fetching, so it does not reduce the number of pages requested.",
"items": {
"type": "string"
}
},
"sortBy": {
"title": "Sort by",
"enum": [
"relevance",
"date"
],
"type": "string",
"description": "Order in which LinkedIn returns results. Sorting by date works well with a small Maximum jobs for daily monitoring.",
"default": "relevance"
},
"startUrls": {
"title": "Start URLs",
"type": "array",
"description": "Optional. Paste LinkedIn job search URLs (linkedin.com/jobs/search?keywords=... – all filters in the URL are preserved) or individual job posting URLs (linkedin.com/jobs/view/...). These are scraped in addition to the search defined above.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"maxItems": {
"title": "Maximum jobs",
"minimum": 0,
"type": "integer",
"description": "Stop after this many jobs have been saved across all searches. Use 0 for no limit. Note that LinkedIn never returns more than 1,000 results for a single search – split broad searches by location or date to get more.",
"default": 100
},
"scrapeJobDetails": {
"title": "Scrape job details",
"type": "boolean",
"description": "Open every job posting to get the full description, seniority level, employment type, job function, industries and applicant count. Costs one extra request per job. Turn off for a faster, listing-only run (title, company, location, date).",
"default": true
},
"fetchMode": {
"title": "Fetch mode",
"enum": [
"auto",
"http",
"browser"
],
"type": "string",
"description": "Auto fetches over plain HTTP and only falls back to a stealth browser (Camoufox) for requests LinkedIn blocked. HTTP only is fastest and cheapest but gives up on blocked requests. Browser only is slowest but most resilient.",
"default": "auto"
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"maximum": 20,
"type": "integer",
"description": "How many requests to run in parallel. Lower it if you see many blocked requests; the browser fallback never uses more than 3.",
"default": 5
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxies to route requests through. LinkedIn blocks datacenter IPs quickly, so Apify's RESIDENTIAL proxy group gives the most reliable results.",
"default": {
"useApifyProxy": true
}
},
"geoId": {
"title": "LinkedIn geo ID",
"type": "string",
"description": "LinkedIn's numeric location identifier (the geoId parameter visible in LinkedIn job search URLs, e.g. 103644278 for the United States). More precise than the free-text location and used together with it."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}