{ "openapi": "3.0.1", "info": { "title": "LinkedIn Search Jobs Scraper With Advanced Search Filters", "description": "LinkedIn Search Jobs Scraper retrieves job listings from LinkedIn based on keywords, location, filters, and seniority. It extracts titles, companies, descriptions, employment types, and posting dates, delivering clean, structured data for recruiting, research, and market analysis", "version": "0.1", "x-build-id": "LatPoiB97pI8RxyEt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simpleapi~linkedin-search-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simpleapi-linkedin-search-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/simpleapi~linkedin-search-jobs-scraper/runs": { "post": { "operationId": "runs-sync-simpleapi-linkedin-search-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/simpleapi~linkedin-search-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-simpleapi-linkedin-search-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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "🔗 URLs / Keywords / Company URL (Bulk Input)", "type": "array", "description": "Add LinkedIn job search URLs, keywords, a company profile URL (e.g. linkedin.com/company/notion), or structured 'keyword, location' inputs. Examples: 'software engineer, United States', 'https://www.linkedin.com/company/notion', a full job search URL, or a direct job URL/ID. Company URLs now correctly resolve to that company's real numeric ID before filtering, instead of returning an unfiltered firehose of unrelated jobs. One item per line. The filters below apply to every item in this list.", "items": { "type": "string" } }, "sortOrder": { "title": "↕️ Sort Order", "enum": [ "relevant", "recent" ], "type": "string", "description": "Choose how to sort results: most relevant or most recent.", "default": "relevant" }, "maxJobs": { "title": "🔢 Max Jobs Per Input", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Set the maximum number of jobs to scrape for each input (range: 1-10000). Note: real delivery per input is capped at roughly 1000 jobs by the search pagination depth, same as the base scraper.", "default": 10 }, "workplaceType": { "title": "🏢 Workplace Type", "type": "array", "description": "Filter by LinkedIn's native workplace-type facet. Leave empty for all workplace types. Applies to every search in this run (zero extra requests — a native LinkedIn URL parameter).", "items": { "type": "string", "enum": [ "on_site", "remote", "hybrid" ], "enumTitles": [ "🏢 On-site", "🏠 Remote", "🔀 Hybrid" ] }, "default": [] }, "experienceLevel": { "title": "🎓 Experience Level", "type": "array", "description": "Filter by LinkedIn's native experience-level facet. Leave empty for all levels.", "items": { "type": "string", "enum": [ "internship", "entry", "associate", "mid_senior", "director" ], "enumTitles": [ "🎒 Internship", "🌱 Entry level", "🧑‍💼 Associate", "📈 Mid-Senior level", "🏆 Director" ] }, "default": [] }, "employmentType": { "title": "💼 Employment Type", "type": "array", "description": "Filter by LinkedIn's native employment-type facet. Leave empty for all types.", "items": { "type": "string", "enum": [ "full_time", "part_time", "contract", "temporary", "volunteer" ], "enumTitles": [ "🕘 Full-time", "🕐 Part-time", "📝 Contract", "⏳ Temporary", "🤝 Volunteer" ] }, "default": [] }, "datePosted": { "title": "📅 Date Posted", "enum": [ "any", "past_24h", "past_week", "past_month" ], "type": "string", "description": "Filter by LinkedIn's native date-posted facet.", "default": "any" }, "minSalaryBand": { "title": "💰 Minimum Salary (Annual, USD)", "enum": [ "any", "40000", "60000", "80000", "100000", "120000", "140000", "160000", "180000", "200000" ], "type": "string", "description": "Filter by LinkedIn's native minimum-salary-band facet. Coverage depends on how many postings in the result set carry LinkedIn's estimated or employer-provided salary data.", "default": "any" }, "proxyConfiguration": { "title": "🛡️ Proxy Configuration (Optional)", "type": "object", "description": "Optional: Enable Apify proxy if needed. By default, the actor runs with direct requests (no proxy). Turn proxy on only if requests get blocked. Note: proxies may consume extra credits." } } }, "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 } } } } } } } } } }