{ "openapi": "3.0.1", "info": { "title": "LinkedIn Job Scraper | Job Search API, Counts & Autocomplete", "description": "Search LinkedIn jobs with no login and no cookies. Get listings with the total results count, full job details with salary and applicants, plus title, company and location autocomplete for precise filters. Pay per row delivered: no start fee, filters run at the source.", "version": "0.1", "x-build-id": "zTfMHPJYDBgjZGBPT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/johnvc~linkedin-job-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-johnvc-linkedin-job-search-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/johnvc~linkedin-job-search-scraper/runs": { "post": { "operationId": "runs-sync-johnvc-linkedin-job-search-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/johnvc~linkedin-job-search-scraper/run-sync": { "post": { "operationId": "run-sync-johnvc-linkedin-job-search-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", "required": [ "search_mode" ], "properties": { "search_mode": { "title": "Mode", "enum": [ "search", "job", "autocomplete", "companySuggestions", "locationSuggestions" ], "type": "string", "description": "search returns job listings for keywords plus location with filters, and always pushes a free searchMeta row with the total results count caption. job scrapes full details for each URL or id in jobUrls. autocomplete returns job title suggestions for query. companySuggestions returns company names with the numeric ids the companyIds filter needs. locationSuggestions returns places with the geoId values the geoId field needs.", "default": "search" }, "keywords": { "title": "Keywords", "type": "string", "description": "What to search for: a job title, skill, or any phrase, for example semiconductor engineer. Search mode only." }, "location": { "title": "Location", "type": "string", "description": "Free-text place name, for example United States, Texas, or Philadelphia, PA. LinkedIn resolves it server-side. Search mode only." }, "geoId": { "title": "Geo ID (precision targeting)", "type": "string", "description": "Optional LinkedIn geo id from the locationSuggestions mode, for example 104937023 for Philadelphia. Works best together with the location text, not instead of it. Search mode only." }, "datePosted": { "title": "Date posted", "enum": [ "any", "past24h", "pastWeek", "pastMonth" ], "type": "string", "description": "Only return jobs posted within this window.", "default": "any" }, "companyIds": { "title": "Company ids", "type": "array", "description": "Numeric LinkedIn company ids to restrict the search to, for example 1441 for Google. Multiple ids combine as OR. Get ids from the companySuggestions mode. Search mode only.", "items": { "type": "string" } }, "easyApplyOnly": { "title": "Easy Apply only", "type": "boolean", "description": "Only jobs with LinkedIn Easy Apply. The filter is forwarded to LinkedIn as-is; listing rows do not carry an Easy Apply marker to verify against. Search mode only.", "default": false }, "under10Applicants": { "title": "Under 10 applicants", "type": "boolean", "description": "Only jobs with fewer than 10 applicants so far. The filter is forwarded to LinkedIn as-is. Search mode only.", "default": false }, "jobUrls": { "title": "Job URLs or ids", "type": "array", "description": "linkedin.com/jobs/view/ URLs or bare numeric job ids, mixed freely. Tracking parameters are stripped and duplicates of the same job collapse into one billed row. Job mode only.", "items": { "type": "string" } }, "query": { "title": "Suggestion query", "type": "string", "description": "The text to complete, for example semic for job titles, appl for companies, or phila for locations." }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum billable rows to return. Free rows (searchMeta, errors) never count. The guest search itself caps out near 1000 results per query; slice by date, location, or company to go deeper.", "default": 100 } } }, "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 } } } } } } } } } }