{ "openapi": "3.0.1", "info": { "title": "LinkedIn Jobs Scraper Pro", "description": "Paste any LinkedIn job-search URL (with filters) and get every listing with full job details, deep company data, hiring-team profiles, salary, skills, applicant insights, and official-source contact enrichment. Deep pagination captures 100% of results.", "version": "1.0", "x-build-id": "fGC4UK8LXgvcdQTj9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yesh_boi~linkedin-jobs-scraper-pro/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yesh_boi-linkedin-jobs-scraper-pro", "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/yesh_boi~linkedin-jobs-scraper-pro/runs": { "post": { "operationId": "runs-sync-yesh_boi-linkedin-jobs-scraper-pro", "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/yesh_boi~linkedin-jobs-scraper-pro/run-sync": { "post": { "operationId": "run-sync-yesh_boi-linkedin-jobs-scraper-pro", "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": { "searchUrls": { "title": "🔗 LinkedIn job-search URLs", "type": "array", "description": "Paste any LinkedIn job-search URL — keep all your filters in it. Works with /jobs/search/, /jobs/search-results/ and /jobs/collections/ URLs. This is the recommended way to run the Actor: filter on LinkedIn, then paste the URL here. You can add several URLs and they will all be scraped.", "items": { "type": "string" } }, "keywords": { "title": "🔎 Keywords", "type": "string", "description": "Job title / keywords to search for. Used only when no search URL is supplied above." }, "location": { "title": "📍 Location (free text)", "type": "string", "description": "Location name as you would type it on LinkedIn, e.g. \"Australia\", \"Sydney, New South Wales, Australia\", \"Remote\". Used when building a search from keywords." }, "country": { "title": "🌏 Region / Country (precise)", "enum": [ "", "au", "us", "gb", "in", "ca", "de", "fr", "nl", "sg", "ae", "custom" ], "type": "string", "description": "Optional convenience selector that targets an entire country by its LinkedIn geoId — more reliable than free text. Overrides the free-text location when set. Choose \"Custom geoId\" to enter your own below.", "default": "" }, "geoId": { "title": "🌐 Custom geoId", "type": "string", "description": "LinkedIn geoId for precise region targeting. Find it in a LinkedIn search URL after filtering by a place. Example: Australia = 101452733. Used when Region/Country is set to \"Custom geoId\"." }, "datePosted": { "title": "🗓️ Date posted", "enum": [ "any", "past24h", "pastWeek", "pastMonth" ], "type": "string", "description": "Restrict to recently posted jobs. Applied only when building a search from keywords; if your pasted URL already has an f_TPR filter, that is respected.", "default": "any" }, "experienceLevels": { "title": "🎯 Experience levels", "type": "array", "description": "Filter by seniority. Applied when building a search from keywords.", "items": { "type": "string", "enum": [ "internship", "entry", "associate", "midSenior", "director", "executive" ], "enumTitles": [ "Internship", "Entry level", "Associate", "Mid-Senior level", "Director", "Executive" ] } }, "jobTypes": { "title": "💼 Job types", "type": "array", "description": "Filter by employment type. Applied when building a search from keywords.", "items": { "type": "string", "enum": [ "fullTime", "partTime", "contract", "temporary", "internship", "volunteer", "other" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Temporary", "Internship", "Volunteer", "Other" ] } }, "workplaceTypes": { "title": "🏢 Workplace types", "type": "array", "description": "Filter by on-site / remote / hybrid. Applied when building a search from keywords.", "items": { "type": "string", "enum": [ "onSite", "remote", "hybrid" ], "enumTitles": [ "On-site", "Remote", "Hybrid" ] } }, "sortBy": { "title": "↕️ Sort by", "enum": [ "date", "relevance" ], "type": "string", "description": "Result ordering when building a search from keywords.", "default": "date" }, "easyApplyOnly": { "title": "⚡ Easy Apply only", "type": "boolean", "description": "Only include jobs with LinkedIn Easy Apply. Applied when building a search from keywords.", "default": false }, "maxItems": { "title": "🔢 Max jobs (0 = all)", "minimum": 0, "type": "integer", "description": "Hard cap on the number of jobs scraped across all search URLs. Set 0 to scrape every result (recommended with Deep pagination on). Prefilled to 10 for a fast first run — raise or set 0 for full runs.", "default": 0 }, "deepPagination": { "title": "🧭 Deep pagination (capture 100%)", "type": "boolean", "description": "LinkedIn's guest search returns at most ~1000 results per query. When on, the Actor automatically slices any search that hits the cap into smaller posting-date windows so no listing is missed. This is the feature that lets it scrape *everything*.", "default": true }, "scrapeJobDetails": { "title": "📄 Scrape full job details", "type": "boolean", "description": "Fetch each job's detail page for description, seniority, employment type, job function, industries, applicant count, salary and skills. Turn off for a fast listing-only crawl.", "default": true }, "scrapeCompanyDetails": { "title": "🏦 Scrape company details", "type": "boolean", "description": "Also fetch each company's page for official website, industry, size, headquarters, followers and specialties. Companies are cached so each is fetched only once.", "default": true }, "includeDescriptionHtml": { "title": "🧩 Include description HTML", "type": "boolean", "description": "Include the raw HTML of the job description in addition to clean text.", "default": true }, "includeDescriptionMarkdown": { "title": "📝 Include description Markdown", "type": "boolean", "description": "Also include a Markdown version of the job description.", "default": false }, "useLoginSession": { "title": "🔐 Use logged-in session (richer data)", "type": "boolean", "description": "When on, the Actor uses your LinkedIn session cookies to fetch data that is ONLY visible when logged in: the hiring team / job poster and their profile, applicant insights, and skill-match details. ⚠️ Scraping while authenticated can violate LinkedIn's Terms of Service and carries account risk — use a dedicated account. Leave off for the safe, public-only crawl.", "default": false }, "liAtCookie": { "title": "li_at cookie", "type": "string", "description": "Value of the `li_at` cookie from a logged-in LinkedIn session. Stored as a secret. Only used when 'Use logged-in session' is on." }, "jsessionidCookie": { "title": "JSESSIONID cookie", "type": "string", "description": "Value of the `JSESSIONID` cookie (used as the CSRF token for LinkedIn's internal API). Include the surrounding quotes exactly as shown in the cookie. Stored as a secret." }, "linkedinHiringTeamQueryId": { "title": "Hiring-team GraphQL queryId (advanced)", "type": "string", "description": "Optional but recommended for hiring-team data. LinkedIn's internal GraphQL query id for the 'Meet the hiring team' card (looks like `voyagerJobsDashJobPostingDetailSections.`). Because LinkedIn rotates it, you paste a current value: open a job while logged in, DevTools → Network → filter `graphql`, and copy the `queryId` from the hiring-team request. See the README → Hiring team." }, "enrichContacts": { "title": "📧 Enrich recruiter email & company phone", "type": "boolean", "description": "Fill recruiter email and company phone from OFFICIAL sources only: the company's own website first (published tel:/mailto:/schema.org data), then a reputable provider you supply a key for. If nothing legitimate is found for a job, the fields are left empty — no guessed or scraped-list data.", "default": false }, "scrapeCompanyWebsiteForContacts": { "title": "Pull contacts from the company's official website", "type": "boolean", "description": "First-party, fully legitimate: read tel:, mailto: and schema.org Organization data published on the company's own website. No third-party key needed.", "default": true }, "contactProvider": { "title": "Email/phone provider", "enum": [ "none", "hunter", "apollo" ], "type": "string", "description": "Reputable enrichment provider used as a fallback when the company website has nothing. Requires the matching API key below.", "default": "none" }, "hunterApiKey": { "title": "Hunter.io API key", "type": "string", "description": "API key from hunter.io. Used to find a recruiter's professional email from their name + the company domain. Stored as a secret." }, "apolloApiKey": { "title": "Apollo.io API key", "type": "string", "description": "API key from apollo.io. Used to enrich company phone and, optionally, recruiter email. Stored as a secret." }, "renderJs": { "title": "🖥️ JavaScript-render fallback", "type": "boolean", "description": "Use a real browser (Playwright) for pages that need JS rendering. Requires deploying with the Playwright base image (see Dockerfile comment). Off by default because the guest endpoints are static HTML.", "default": false }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of parallel requests. Lower it if you see blocking; raise it for speed on residential proxies.", "default": 8 }, "minDelayMs": { "title": "Min delay between requests (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Politeness delay applied per session to look human and avoid rate limits.", "default": 400 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "maximum": 30, "type": "integer", "description": "How many times to retry a blocked or failed request (with a fresh proxy/session) before giving up on it.", "default": 8 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxies are strongly recommended for LinkedIn. Datacenter proxies get blocked quickly.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }