{ "openapi": "3.0.1", "info": { "title": "LinkedIn Jobs Scraper | Experience Filters & Company Data", "description": "Scrape LinkedIn job listings worldwide by keyword and place or from search URLs, no login. Experience-level and job-type filters that really work, company website, size, industry, followers and HQ address, parsed pay range, applicant count, Easy Apply, plus incremental alerts.", "version": "0.1", "x-build-id": "aMqgwRKbfE2yeTID6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/corvuslab~linkedin-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-corvuslab-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/corvuslab~linkedin-jobs-scraper/runs": { "post": { "operationId": "runs-sync-corvuslab-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/corvuslab~linkedin-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-corvuslab-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": { "searchTerms": { "title": "๐Ÿ”Ž Keywords", "type": "array", "description": "Job titles, skills or companies, as you would type them in LinkedIn's job search (e.g. \"data analyst\", \"python developer\"). Each keyword runs as its own search in every place below. Leave empty to list the newest jobs in each place.", "items": { "type": "string" } }, "locations": { "title": "๐Ÿ“ Places", "type": "array", "description": "Countries, regions or cities, as you would type them on LinkedIn: \"United States\", \"Germany\", \"London, England, United Kingdom\", \"Berlin\". A LinkedIn geoId (e.g. 101282230 for Germany) also works. Leave empty for LinkedIn's default market (United States).", "items": { "type": "string" } }, "countries": { "title": "๐ŸŒ Countries", "type": "array", "description": "Pick whole countries instead of typing them. Each country runs as its own search (added to Places).", "items": { "type": "string", "enum": [ "AF", "AL", "DZ", "AD", "AO", "AR", "AM", "AU", "AT", "AZ", "BH", "BD", "BY", "BE", "BJ", "BO", "BA", "BW", "BR", "BN", "BG", "KH", "CM", "CA", "CL", "CN", "CO", "CR", "HR", "CU", "CY", "CZ", "CI", "DK", "DO", "EC", "EG", "SV", "EE", "ET", "FI", "FR", "GE", "DE", "GH", "GR", "GT", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IL", "IT", "JM", "JP", "JO", "KZ", "KE", "KW", "KG", "LA", "LV", "LB", "LY", "LI", "LT", "LU", "MO", "MG", "MY", "MV", "MT", "MU", "MX", "MD", "MC", "MN", "ME", "MA", "MZ", "MM", "NA", "NP", "NL", "NZ", "NI", "NG", "MK", "NO", "OM", "PK", "PS", "PA", "PY", "PE", "PH", "PL", "PT", "PR", "QA", "RO", "RU", "RW", "SA", "SN", "RS", "SG", "SK", "SI", "ZA", "KR", "ES", "LK", "SE", "CH", "TW", "TZ", "TH", "TT", "TN", "TR", "UG", "UA", "AE", "GB", "US", "UY", "UZ", "VE", "VN", "ZM", "ZW" ], "enumTitles": [ "Afghanistan", "Albania", "Algeria", "Andorra", "Angola", "Argentina", "Armenia", "Australia", "Austria", "Azerbaijan", "Bahrain", "Bangladesh", "Belarus", "Belgium", "Benin", "Bolivia", "Bosnia and Herzegovina", "Botswana", "Brazil", "Brunei", "Bulgaria", "Cambodia", "Cameroon", "Canada", "Chile", "China", "Colombia", "Costa Rica", "Croatia", "Cuba", "Cyprus", "Czechia", "Cรดte d'Ivoire", "Denmark", "Dominican Republic", "Ecuador", "Egypt", "El Salvador", "Estonia", "Ethiopia", "Finland", "France", "Georgia", "Germany", "Ghana", "Greece", "Guatemala", "Honduras", "Hong Kong SAR", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Israel", "Italy", "Jamaica", "Japan", "Jordan", "Kazakhstan", "Kenya", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macao SAR", "Madagascar", "Malaysia", "Maldives", "Malta", "Mauritius", "Mexico", "Moldova", "Monaco", "Mongolia", "Montenegro", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nepal", "Netherlands", "New Zealand", "Nicaragua", "Nigeria", "North Macedonia", "Norway", "Oman", "Pakistan", "Palestine", "Panama", "Paraguay", "Peru", "Philippines", "Poland", "Portugal", "Puerto Rico", "Qatar", "Romania", "Russia", "Rwanda", "Saudi Arabia", "Senegal", "Serbia", "Singapore", "Slovakia", "Slovenia", "South Africa", "South Korea", "Spain", "Sri Lanka", "Sweden", "Switzerland", "Taiwan", "Tanzania", "Thailand", "Trinidad and Tobago", "Tunisia", "Tรผrkiye", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "Uruguay", "Uzbekistan", "Venezuela", "Vietnam", "Zambia", "Zimbabwe" ] } }, "regionPresets": { "title": "๐Ÿ—บ๏ธ Regions", "type": "array", "description": "Search a group of countries at once. Each country runs as its own search, so every one gets LinkedIn's full 1,000 jobs.", "items": { "type": "string", "enum": [ "dach", "nordics", "benelux", "ukIreland", "eu27", "gcc", "mena", "asean", "latam", "anglosphere" ], "enumTitles": [ "DACH (Germany, Austria, Switzerland)", "Nordics (Denmark, Sweden, Norway, Finland, Iceland)", "Benelux (Belgium, Netherlands, Luxembourg)", "UK & Ireland", "EU-27", "GCC (UAE, Saudi Arabia, Qatar, Kuwait, Bahrain, Oman)", "Middle East & North Africa", "ASEAN (Southeast Asia)", "Latin America", "Anglosphere (US, UK, Canada, Australia, New Zealand, Ireland)" ] } }, "distance": { "title": "๐ŸŽฏ Radius around a city (miles)", "enum": [ "", "5", "10", "25", "50", "100" ], "type": "string", "description": "Widen each city to everything within this distance. Has no effect on country-wide searches." }, "startUrls": { "title": "๐Ÿ“‹ Start URLs", "type": "array", "description": "Optional. Paste LinkedIn job-search URLs (linkedin.com/jobs/search?keywords=โ€ฆ&location=โ€ฆ, their filters are kept) or single job URLs (linkedin.com/jobs/view/โ€ฆ). Any start URL replaces the search form above.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "๐Ÿ”ข Max results", "minimum": 0, "type": "integer", "description": "Maximum number of jobs to return across all searches. Set 0 for no limit.", "default": 25 }, "maxResultsPerSearch": { "title": "๐Ÿ”ข Max results per search", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Cap each keyword ร— place search separately, so one big search can't use up the whole run. 0 = no per-search cap (LinkedIn shows at most 1,000 jobs per search)." }, "postedWithin": { "title": "๐Ÿ“… Posted within", "enum": [ "", "past24Hours", "pastWeek", "pastMonth" ], "type": "string", "description": "Only jobs posted (or re-posted) in this window." }, "postedWithinHours": { "title": "โฑ๏ธ Posted within the last N hours", "minimum": 0, "maximum": 720, "type": "integer", "description": "A custom window, e.g. 1 for the last hour or 6 for the last six hours โ€” handy for frequent scheduled runs. Overrides Posted within. 0 = off." }, "experienceLevels": { "title": "๐ŸŽ“ Experience level", "type": "array", "description": "Keep only jobs whose posting shows one of these seniority levels. Jobs that don't match are skipped and not charged.", "items": { "type": "string", "enum": [ "internship", "entryLevel", "associate", "midSenior", "director", "executive", "notApplicable" ], "enumTitles": [ "Internship", "Entry level", "Associate", "Mid-Senior level", "Director", "Executive", "Not applicable" ] } }, "employmentTypes": { "title": "๐Ÿ“„ Job type", "type": "array", "description": "Keep only jobs whose posting shows one of these employment types. Jobs that don't match are skipped and not charged.", "items": { "type": "string", "enum": [ "fullTime", "partTime", "contract", "temporary", "internship", "volunteer", "other" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Temporary", "Internship", "Volunteer", "Other" ] } }, "easyApplyOnly": { "title": "โšก Easy Apply only", "type": "boolean", "description": "Only jobs you can apply to directly on LinkedIn.", "default": false }, "under10Applicants": { "title": "๐ŸŒฑ Fewer than 10 applicants", "type": "boolean", "description": "Only jobs that fewer than 10 people have applied to so far.", "default": false }, "companyIds": { "title": "๐Ÿข Company IDs", "type": "array", "description": "Only jobs at these companies, by LinkedIn company ID: the number after f_C= in a company's job-search URL (e.g. 1441 for Google). Or use Companies (names or URLs) below.", "items": { "type": "string" } }, "companies": { "title": "๐Ÿข Companies (names or URLs)", "type": "array", "description": "Only jobs at these companies, by name (\"Google\", \"General Motors\") or LinkedIn company URL (linkedin.com/company/โ€ฆ). Each is matched to LinkedIn's company and searched exactly.", "items": { "type": "string" } }, "titleIncludes": { "title": "โœ… Title must contain", "type": "array", "description": "Keep only jobs whose title contains at least one of these words (case-insensitive), e.g. \"senior\", \"lead\".", "items": { "type": "string" } }, "titleExcludes": { "title": "๐Ÿšซ Title must not contain", "type": "array", "description": "Drop jobs whose title contains any of these words, e.g. \"intern\", \"sales\". Dropped jobs are not charged.", "items": { "type": "string" } }, "excludeCompanies": { "title": "๐Ÿšซ Exclude companies", "type": "array", "description": "Drop jobs from companies whose name contains any of these, e.g. staffing agencies you never want to see. Dropped jobs are not charged.", "items": { "type": "string" } }, "excludeAgencies": { "title": "๐Ÿšซ Exclude staffing & recruiting agencies", "type": "boolean", "description": "Drop jobs posted by staffing, recruitment and headhunting firms (by the employer's LinkedIn industry and name). Dropped jobs are not charged.", "default": false }, "excludeKeywords": { "title": "๐Ÿšซ Exclude keywords (title or description)", "type": "array", "description": "Drop jobs whose title or description mentions any of these, e.g. \"security clearance\", \"commission only\". Dropped jobs are not charged.", "items": { "type": "string" } }, "descriptionIncludes": { "title": "โœ… Description must contain", "type": "array", "description": "Keep only jobs whose description mentions at least one of these (case-insensitive), e.g. \"visa sponsorship\", \"Kubernetes\".", "items": { "type": "string" } }, "industryIncludes": { "title": "๐Ÿญ Industry must contain", "type": "array", "description": "Keep only jobs whose LinkedIn industry contains one of these, e.g. \"Software Development\", \"Hospitals\", \"Financial Services\".", "items": { "type": "string" } }, "requireSalary": { "title": "๐Ÿ’ฐ Only jobs with a stated pay range", "type": "boolean", "description": "Keep only jobs where the employer lists pay. Many postings don't, so expect fewer results.", "default": false }, "salaryMin": { "title": "๐Ÿ’ฐ Minimum yearly pay", "minimum": 0, "type": "integer", "description": "Keep jobs whose stated pay reaches this yearly amount (hourly ร— 2080, daily ร— 260, weekly ร— 52, monthly ร— 12), in the currency below." }, "salaryMax": { "title": "๐Ÿ’ฐ Maximum yearly pay", "minimum": 0, "type": "integer", "description": "Keep jobs whose stated pay starts at or below this yearly amount, in the currency below." }, "salaryCurrency": { "title": "๐Ÿ’ฑ Pay currency", "enum": [ "USD", "EUR", "GBP", "CAD", "AUD", "INR", "CHF", "SGD", "NZD", "PLN", "SEK", "BRL", "MXN", "HKD", "JPY" ], "type": "string", "description": "Currency of the pay bounds above. Jobs paid in another currency count as unknown pay. Default USD." }, "includeUnknownSalary": { "title": "โ” Keep jobs without comparable pay", "type": "boolean", "description": "With a pay bound set, also keep jobs that don't state pay (or state it in another currency).", "default": false }, "requireJobPoster": { "title": "๐Ÿ‘ค Only jobs that show the hiring team", "type": "boolean", "description": "Keep only jobs where LinkedIn shows who posted the job (name, title, profile link).", "default": false }, "companySizeMin": { "title": "๐Ÿข Minimum company size", "minimum": 0, "type": "integer", "description": "Keep jobs at companies of at least this size (LinkedIn's size band, e.g. 51-200). Reads company details automatically." }, "companySizeMax": { "title": "๐Ÿข Maximum company size", "minimum": 0, "type": "integer", "description": "Keep jobs at companies of at most this size (LinkedIn's size band). Reads company details automatically." }, "skipJobIds": { "title": "โญ๏ธ Skip job IDs", "type": "array", "description": "Job IDs (or job URLs) you already have. They are skipped and not charged.", "items": { "type": "string" } }, "includeDetails": { "title": "๐Ÿ”ฌ Fetch the full job posting", "type": "boolean", "description": "Add the full description, seniority level, employment type, industries, applicant count, employer-stated pay range and Easy Apply / external apply. Turn off for a faster, card-only run.", "default": true }, "includeCompanyDetails": { "title": "๐Ÿข Add company details", "type": "boolean", "description": "Add the hiring company's website, industry, size, employees on LinkedIn, followers, headquarters address, type, specialties and description. Each company is read once per run.", "default": false }, "descriptionFormat": { "title": "๐Ÿ“ Description format", "enum": [ "all", "text", "html", "markdown" ], "type": "string", "description": "Which representation(s) of the job description to include.", "default": "all" }, "descriptionMaxLength": { "title": "โœ‚๏ธ Description max length", "minimum": 0, "type": "integer", "description": "Cut descriptions to this many characters. 0 = full length.", "default": 0 }, "compact": { "title": "๐Ÿ“ฆ Compact records", "type": "boolean", "description": "Emit only the core fields (title, company, place, date, pay, job type, seniority, link). Ideal for AI agents and MCP clients.", "default": false }, "excludeEmptyFields": { "title": "๐Ÿงน Drop empty fields", "type": "boolean", "description": "Remove null, empty-string and empty-list fields from each record.", "default": false }, "incrementalMode": { "title": "โ™ป๏ธ Incremental mode", "type": "boolean", "description": "Track jobs between runs and tag every record NEW / UPDATED / UNCHANGED / REAPPEARED / EXPIRED. Unchanged jobs are skipped and not charged.", "default": false }, "stateKey": { "title": "๐Ÿ—๏ธ State key", "type": "string", "description": "Stable name for the tracked search. Leave empty to derive one automatically from your search settings." }, "emitUnchanged": { "title": "๐Ÿ” Include unchanged jobs", "type": "boolean", "description": "Also emit jobs that have not changed since the previous run.", "default": false }, "emitExpired": { "title": "๐Ÿ—‘๏ธ Include expired jobs", "type": "boolean", "description": "Emit jobs that were listed last run but are gone now. Needs a run that reads the whole search (Max results 0 or above the number of matches, and under 1,000 matches per search).", "default": false }, "skipReposts": { "title": "โ™ป๏ธ Skip re-posted jobs", "type": "boolean", "description": "Leave out jobs an employer took down and posted again under a new ID (same title, company and place as a job already tracked). They are not charged.", "default": false }, "telegramToken": { "title": "๐Ÿ’ฌ Telegram bot token", "type": "string", "description": "Bot token from @BotFather." }, "telegramChatId": { "title": "๐Ÿ†” Telegram chat ID", "type": "string", "description": "Chat or channel ID, e.g. \"-100123456789\" or \"@yourchannel\"." }, "slackWebhookUrl": { "title": "๐Ÿ’ผ Slack webhook URL", "type": "string", "description": "Slack incoming-webhook URL." }, "discordWebhookUrl": { "title": "๐ŸŽฎ Discord webhook URL", "type": "string", "description": "Discord incoming-webhook URL." }, "whatsappAccessToken": { "title": "๐ŸŸข WhatsApp access token", "type": "string", "description": "WhatsApp Cloud API access token (Meta for Developers). Messages reach a number that has written to your business number in the last 24 hours." }, "whatsappPhoneNumberId": { "title": "๐ŸŸข WhatsApp phone number ID", "type": "string", "description": "The Cloud API phone-number ID of your business number." }, "whatsappTo": { "title": "๐ŸŸข WhatsApp recipients", "type": "array", "description": "Recipient numbers in international format, e.g. \"4512345678\".", "items": { "type": "string" } }, "webhookUrl": { "title": "๐Ÿช Webhook URL", "type": "string", "description": "Any HTTPS endpoint. Receives a JSON POST with every matched job (up to 1,000 per run) โ€” works with n8n, Make and Zapier." }, "webhookHeaders": { "title": "๐Ÿงพ Webhook headers", "type": "object", "description": "Extra headers for the webhook request, e.g. {\"Authorization\": \"Bearer xyz\"}. Stored encrypted, like the other credentials." }, "notificationLimit": { "title": "๐Ÿ”ข Jobs per notification", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many jobs to list in each Telegram, Slack or Discord message. The webhook always gets every matched job.", "default": 5 }, "notifyOnlyChanges": { "title": "๐ŸŽฏ Alert only on changes", "type": "boolean", "description": "In incremental mode, alerts list only new, updated and reappeared jobs, even when Include unchanged jobs is on.", "default": false }, "proxyConfiguration": { "title": "๐Ÿ›ก๏ธ Proxy", "type": "object", "description": "Keep the default proxy settings for reliable runs โ€” LinkedIn slows down visitors who send many requests from one address.", "default": { "useApifyProxy": true } }, "detailConcurrency": { "title": "โšก Parallel posting reads", "minimum": 1, "maximum": 16, "type": "integer", "description": "How many job postings to read at the same time.", "default": 10 }, "ignoreUrlFailures": { "title": "โญ๏ธ Ignore URL failures", "type": "boolean", "description": "Skip start URLs that cannot be interpreted instead of failing the whole run.", "default": true }, "maxRequestRetries": { "title": "๐Ÿ”„ Max request retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "How many times to retry a refused or failed request (each retry uses a fresh connection).", "default": 6 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }