{ "openapi": "3.0.1", "info": { "title": "Advanced Linkedin Job Scraper", "description": "Scrape linkedin job postings and get company and recruiter details. Supports boolean search and other advanced search filters. Success rate is > 98%", "version": "1.1", "x-build-id": "i6gsEd6Va4TvpXJt1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/curious_coder~linkedin-jobs-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-curious_coder-linkedin-jobs-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/curious_coder~linkedin-jobs-search-scraper/runs": { "post": { "operationId": "runs-sync-curious_coder-linkedin-jobs-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/curious_coder~linkedin-jobs-search-scraper/run-sync": { "post": { "operationId": "run-sync-curious_coder-linkedin-jobs-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": [ "cookies", "userAgent" ], "properties": { "cookies": { "title": "🍪 Cookies", "type": "array", "description": "Cookies are used to authorize the actor with linkedin.com

Follow these steps to get the cookies:
  1. Install [Cookie-Editor](https://chromewebstore.google.com/detail/cookie-editor/hlkenndednhfkekhgcdicdfddnkalmdm) chrome extension
  2. Login to your linkedin.com account
  3. Click on the extension and export the linkedin cookies
  4. Paste the copied contents here

Video - How to get cookies (0:14)" }, "userAgent": { "title": "User agent", "type": "string", "description": "[Click here](https://www.google.com/search?q=my+user+agent) to get the user agent info." }, "searchUrl": { "title": "Jobs search URL", "type": "string", "description": "Optional if you use filters.* below. Supports all jobs search filters.

Go to [linkedin jobs search page](https://www.linkedin.com/jobs/search/), search with required filters and once you are done, copy the full URL from address bar and pass it here" }, "filters.keywords": { "title": "Keywords", "type": "string", "description": "Job title, skills, or free-text search (e.g. \"software engineer\")" }, "filters.location": { "title": "Location", "type": "string", "description": "City, region, or country (resolved via typeahead to geoId). Pick a suggestion or type any place, e.g. \"London, United Kingdom\"." }, "filters.geoId": { "title": "Geo ID", "type": "string", "description": "Optional LinkedIn geoId (from a search URL as `geoId=`). Overrides free-text location when both are set." }, "filters.distance": { "title": "Distance", "enum": [ "0", "5", "10", "25", "50", "100" ], "type": "string", "description": "Search radius around the location" }, "filters.sortBy": { "title": "Sort by", "enum": [ "R", "DD" ], "type": "string", "description": "Result sort order" }, "filters.timePostedRange": { "title": "Date posted", "enum": [ "r86400", "r604800", "r2592000" ], "type": "string", "description": "Only return jobs posted within this window" }, "filters.experience": { "title": "Experience level", "type": "array", "description": "One or more experience levels", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6" ], "enumTitles": [ "Internship", "Entry level", "Associate", "Mid-Senior level", "Director", "Executive" ] } }, "filters.company": { "title": "Company", "type": "array", "description": "Company names (resolved via typeahead) or numeric LinkedIn company IDs. Pick suggestions or type any name/ID.", "items": { "type": "string", "enumSuggestedValues": [ "Google", "Microsoft", "Amazon", "Apple", "Meta", "Netflix", "NVIDIA", "Tesla", "Salesforce", "IBM", "Oracle", "Uber", "Airbnb", "Accenture", "Deloitte" ] } }, "filters.jobType": { "title": "Job type", "type": "array", "description": "Employment type", "items": { "type": "string", "enum": [ "F", "P", "C", "T", "V", "I", "O" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Temporary", "Volunteer", "Internship", "Other" ] } }, "filters.workplaceType": { "title": "Workplace / Remote", "type": "array", "description": "On-site, remote, or hybrid", "items": { "type": "string", "enum": [ "1", "2", "3" ], "enumTitles": [ "On-site", "Remote", "Hybrid" ] } }, "filters.salaryBucketV2": { "title": "Salary", "enum": [ "21", "22", "23", "24", "25", "26", "27", "28", "29" ], "type": "string", "description": "Minimum salary bucket" }, "filters.industry": { "title": "Industry", "type": "array", "description": "Industry names (resolved via typeahead) or LinkedIn industry IDs. Pick suggestions or type any name/ID.", "items": { "type": "string", "enumSuggestedValues": [ "Software Development", "IT Services and IT Consulting", "Technology, Information and Internet", "Financial Services", "Hospitals and Health Care", "Manufacturing", "Banking", "Construction", "Business Consulting and Services", "Retail", "Staffing and Recruiting", "Higher Education" ] } }, "filters.function": { "title": "Job function", "type": "array", "description": "Pick common job functions or type another name/code (resolved via typeahead).", "items": { "type": "string", "enumSuggestedValues": [ "mgmt", "it", "mnfc", "othr", "sale", "eng", "bd", "hcpr", "edu", "fin", "adm", "mrkt" ], "enumTitles": [ "Management", "Information Technology", "Manufacturing", "Other", "Sales", "Engineering", "Business Development", "Health Care Provider", "Education", "Finance", "Administrative", "Marketing" ] } }, "filters.title": { "title": "Title", "type": "array", "description": "Standardized job titles (resolved via typeahead) or LinkedIn title IDs. Pick suggestions or type any title/ID.", "items": { "type": "string", "enumSuggestedValues": [ "Software Engineer", "Senior Software Engineer", "Product Manager", "Data Scientist", "Account Executive", "Project Manager", "Solutions Architect", "Financial Advisor", "Salesperson", "Marketing Manager" ] } }, "filters.populatedPlace": { "title": "City (populated place)", "type": "array", "description": "Additional cities within the search. Pick suggestions or type a city name / `f_PP` geo ID.", "items": { "type": "string", "enumSuggestedValues": [ "New York, New York, United States", "San Francisco, California, United States", "Los Angeles, California, United States", "Seattle, Washington, United States", "Austin, Texas, United States", "Chicago, Illinois, United States", "Boston, Massachusetts, United States", "London, England, United Kingdom", "Toronto, Ontario, Canada", "Berlin, Germany", "Dublin, County Dublin, Ireland", "Bengaluru, Karnataka, India", "Singapore", "Sydney, New South Wales, Australia", "Amsterdam, Netherlands" ] } }, "filters.commitments": { "title": "Commitments", "type": "array", "description": "Company commitments shown on the job", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "Diversity, equity, and inclusion", "Environmental sustainability", "Work-life balance", "Social impact", "Career growth and learning" ] } }, "filters.applyWithLinkedin": { "title": "Easy Apply", "type": "boolean", "description": "Only Easy Apply jobs", "default": false }, "filters.earlyApplicant": { "title": "Under 10 applicants", "type": "boolean", "description": "Only jobs with fewer than 10 applicants", "default": false }, "filters.jobInYourNetwork": { "title": "In your network", "type": "boolean", "description": "Only jobs in your network", "default": false }, "filters.verifiedJob": { "title": "Has verifications", "type": "boolean", "description": "Only verified jobs", "default": false }, "filters.workRemoteAllowed": { "title": "Work remote allowed", "type": "boolean", "description": "Only jobs that allow remote work (`f_WRA`)", "default": false }, "filters.fairChanceEmployer": { "title": "Fair chance employer", "type": "boolean", "description": "Only fair chance employers (`f_FCE`)", "default": false }, "scrapeJobDetails": { "title": "Scrape more details (Slower)", "type": "boolean", "description": "This will require additional actions for each job record and take longer to scrape. \nWill scrape following additional data for each job: \n- Benefits\n-Hiring team\n-Company Info\n- Insights", "default": false }, "scrapeSkills": { "title": "Scrape skills requirements", "type": "boolean", "description": "This will require additional actions for each job record and take longer to scrape", "default": false }, "scrapeCompany": { "title": "Scrape company details", "type": "boolean", "description": "This will require additional scraping requests for each job record and take longer to scrape", "default": false }, "count": { "title": "#️⃣ Total number of records required", "type": "integer", "description": "Leave this field empty if you want to scrape all items." } } }, "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 } } } } } } } } } }