{ "openapi": "3.0.1", "info": { "title": "LinkedIn Jobs Scraper - Listings, Multi-Title, Location, CSV", "description": "LinkedIn Jobs Scraper with no login or cookies: title, company, location, posted date, full description, seniority, applicant count, Easy Apply flag, advertised pay when shown. Date/experience filters, title include/exclude, only-new-jobs monitoring, webhook alerts. CSV/JSON. $0.50 per 1,000 jobs.", "version": "0.1", "x-build-id": "3c2bI3uztMgnfYYGe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/flash_scraper~linkedin-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-flash_scraper-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/flash_scraper~linkedin-jobs-scraper/runs": { "post": { "operationId": "runs-sync-flash_scraper-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/flash_scraper~linkedin-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-flash_scraper-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", "required": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Job titles / keywords (what)", "type": "array", "description": "Job titles, skills, or company keywords to search — one per line. e.g. 'data analyst', 'react developer'.", "default": [ "data analyst" ], "items": { "type": "string" } }, "location": { "title": "Location (where)", "type": "string", "description": "City, state, country, or zip to search within — e.g. 'United States', 'London', 'Remote'. Ignored when `locations` or `geoId` is set.", "default": "United States" }, "locations": { "title": "Locations (one search per place)", "type": "array", "description": "Optional. Search each of these places separately INSTEAD of `location` — e.g. 'Austin, TX', 'Dallas, TX', 'Houston, TX'. LinkedIn's public search stops at 800 results per search, so a list of cities is how one run goes past that wall for a whole state or country; a posting found under two places is delivered (and billed) once. `maxItems` applies to EACH place. Up to 25 places per run — extra entries are not searched and the run says so. Leave empty to search `location`.", "default": [], "items": { "type": "string" } }, "geoId": { "title": "LinkedIn geoId (optional)", "type": "string", "description": "Optional. The numeric geoId from a LinkedIn job-search URL (the number after geoId=, e.g. 103644278 = United States). When set, `location` and `locations` are ignored and LinkedIn's own place id pins the search, so ambiguous names (Paris, Cambridge, Georgia) resolve deterministically. Measured 2026-08-29 from a home IP: geoId=103644278 with no location returned the same listings as location 'United States'. A non-numeric value is ignored (the run says so) and `location` is used." }, "datePosted": { "title": "Date posted", "enum": [ "", "r86400", "r604800", "r2592000" ], "type": "string", "description": "Only jobs posted within this window.", "default": "" }, "experienceLevel": { "title": "Experience level", "type": "array", "description": "Filter by seniority (leave empty for all).", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "Internship", "Entry level", "Associate", "Mid-Senior level", "Director" ] }, "default": [] }, "contractType": { "title": "Employment type", "type": "array", "description": "Employment type HINT (leave empty for all). Since LinkedIn's August 2026 AI search (measured 2026-08-29) workplace type and job type are not honoured at the source; the actor converts them to search keywords plus a title/location check — verify with isRemote. Each code is appended to the search as a word (Part-time → 'part-time', Contract → 'contract', Temporary → 'temporary', Internship → 'internship'); Full-time adds no keyword (LinkedIn's default — verify with employmentType); the row's employmentType column, read from the job page, is the truth.", "items": { "type": "string", "enum": [ "F", "P", "C", "T", "I" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Temporary", "Internship" ] }, "default": [] }, "remote": { "title": "Work arrangement", "type": "array", "description": "Work arrangement HINT (leave empty for all). Since LinkedIn's August 2026 AI search (measured 2026-08-29) workplace type and job type are not honoured at the source; the actor converts them to search keywords plus a title/location check — verify with isRemote. Codes become search words ('remote' / 'hybrid'); On-site adds no keyword (LinkedIn's default — verify with isRemote). Remote only (just '2') additionally keeps only listings whose title or location says remote/WFH — checked on the search cards BEFORE the job pages are read, so the others are neither fetched nor billed.", "items": { "type": "string", "enum": [ "1", "2", "3" ], "enumTitles": [ "On-site", "Remote", "Hybrid" ] }, "default": [] }, "companyNames": { "title": "Companies", "type": "array", "description": "Keep only listings whose company name, as printed on the search card, contains one of these (case-insensitive substring: 'Google' keeps Google and Google Cloud, drops Alphabet). Checked on the search cards BEFORE the job pages are read, so a dropped listing is neither fetched nor billed. A subsidiary or a differently spelled legal name is dropped — use `companyId` for an exact pin. Leave empty for all.", "default": [], "items": { "type": "string" } }, "companyId": { "title": "Company IDs", "type": "array", "description": "Filter by LinkedIn numeric company IDs (from a company page URL). Leave empty for all.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max jobs per search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of jobs per search (1-1000): per search query and, when `locations` is set, per place — 3 queries x 4 places can deliver up to 12 x this figure (a posting found under two places is billed once).", "default": 100 }, "requireSalary": { "title": "Only jobs with a salary", "type": "boolean", "description": "Keep only listings whose public job page shows a base-pay range (varies by posting and state; on the 6 pages measured 2026-08-29, 2 showed a base-pay range). Listings without advertised pay — and listings whose job page could not be read — are dropped.", "default": false }, "minSalary": { "title": "Minimum salary (annualized)", "minimum": 0, "type": "integer", "description": "Keep only listings whose advertised pay (salaryMax, else salaryMin) is at least this much per year; hourly pay is annualized (x2080). Listings showing no pay are dropped, like requireSalary. 0 = no filter.", "default": 0 }, "easyApplyOnly": { "title": "Easy Apply only", "type": "boolean", "description": "Keep only jobs that support LinkedIn Easy Apply — applied at the source (measured 2026-08-29 from a home IP; the post-fetch check stays as a safety net), so the run asks LinkedIn for Easy Apply postings instead of reading every job page to find them.", "default": false }, "maxApplicants": { "title": "Max applicants", "minimum": 0, "type": "integer", "description": "Keep only jobs with at most this many applicants (low-competition roles; 0 = no filter).", "default": 0 }, "titleInclude": { "title": "Title must contain (any of)", "type": "array", "description": "Keep only listings whose job title contains at least one of these words or phrases (case-insensitive). Checked on the search cards BEFORE the job pages are read, so a dropped listing is neither fetched nor billed. Leave empty for all.", "default": [], "items": { "type": "string" } }, "titleExclude": { "title": "Title must not contain", "type": "array", "description": "Drop listings whose job title contains any of these words or phrases (case-insensitive) — e.g. 'intern', 'manager', 'clearance'. Checked on the search cards BEFORE the job pages are read, so a dropped listing is neither fetched nor billed. Leave empty for none.", "default": [], "items": { "type": "string" } }, "excludeAgencies": { "title": "Exclude staffing agencies", "type": "boolean", "description": "Drop listings whose company name looks like a staffing / recruiting agency (name contains staffing, recruit, talent, headhunt, manpower, personnel, placement, consultancy, resourcing, workforce, ...). A name-based heuristic: 'Deloitte Consulting' passes, 'TalentBridge Staffing' is dropped. Checked on the search cards BEFORE the job pages are read, so a dropped listing is neither fetched nor billed.", "default": false }, "onlyNewJobs": { "title": "Only new jobs (monitor mode)", "type": "boolean", "description": "ON: the run remembers every listing it delivers for this exact search (queries + location + filters) in a key-value store in YOUR account and, on later runs, delivers — and bills — only listings that are new since. The first run is the baseline. A quiet run delivers nothing and charges nothing. OFF (default): every run returns everything it finds.", "default": false }, "descriptionFormat": { "title": "Description format", "enum": [ "text", "markdown", "html" ], "type": "string", "description": "How the posting's description is written into the `descriptionText` column. `text` (default): plain text, whitespace collapsed — unchanged. `markdown`: **bold**, *italic*, `- ` bullets, `1.` numbers, `[text](url)` links and line breaks from the job page's own markup — the best input for an LLM or a spreadsheet. `html`: the description block as LinkedIn serves it (, ,
,