{ "openapi": "3.0.1", "info": { "title": "LinkedIn Jobs Scraper — Pay only for new or changed listings", "description": "Scrape linkedin.com jobs — title, company, location, salary, full description, apply URL, contact email — with state-keyed delta pricing. Recurring runs only charge for new or changed listings; already-seen jobs are skipped. Telegram/Discord/Slack/WhatsApp/webhook notifications.", "version": "0.1", "x-build-id": "0kXxC6VN7a3a5DTnQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/blackfalcondata~linkedin-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-blackfalcondata-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/blackfalcondata~linkedin-jobs-scraper/runs": { "post": { "operationId": "runs-sync-blackfalcondata-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/blackfalcondata~linkedin-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-blackfalcondata-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": { "keywords": { "title": "🔍 Search keywords", "type": "string", "description": "Job search keywords (e.g. \"software engineer\", \"nurse\"). Leave blank to browse all jobs in the selected location." }, "location": { "title": "📍 Location", "type": "string", "description": "Free-text location (e.g. \"Copenhagen, Denmark\", \"United States\"). Use geoIds for higher precision." }, "geoIds": { "title": "🌍 LinkedIn geoIds", "type": "array", "description": "Numeric LinkedIn geoIds (e.g. \"103644278\" = United States). Each geoId becomes a separate query, deduped on jobId.", "default": [], "items": { "type": "string" } }, "regions": { "title": "🗺 ISO-2 region codes", "type": "array", "description": "Two-letter country codes (e.g. \"US\", \"GB\", \"DE\"). Resolved to LinkedIn country geoIds. Use geoIds[] for unsupported markets.", "default": [], "items": { "type": "string" } }, "regionPresets": { "title": "🌐 Region preset", "enum": [ "nordic", "dach", "benelux", "uk-ireland", "eu-27", "gcc", "mena", "asean", "anglosphere", "latam", "nordics-extended" ], "type": "string", "description": "Pre-defined country grouping. Combined with regions[] if both are set." }, "datePosted": { "title": "🗓 Date posted", "enum": [ "anytime", "lastHour", "last24h", "last7d", "last30d" ], "type": "string", "description": "Filter by posting recency. \"lastHour\" is unique to this scraper.", "default": "anytime" }, "jobType": { "title": "💼 Job type", "type": "array", "description": "Multi-select employment type filter.", "items": { "type": "string", "enum": [ "fulltime", "parttime", "contract", "temporary", "internship", "volunteer", "other" ] }, "default": [] }, "experienceLevel": { "title": "📈 Experience level", "type": "array", "description": "Multi-select seniority filter.", "items": { "type": "string", "enum": [ "internship", "entry", "associate", "mid_senior", "director", "executive" ] }, "default": [] }, "workType": { "title": "🏠 Work type", "type": "array", "description": "Multi-select onsite/remote/hybrid filter.", "items": { "type": "string", "enum": [ "onsite", "remote", "hybrid" ] }, "default": [] }, "salaryMin": { "title": "💰 Salary min", "minimum": 0, "type": "integer", "description": "Minimum annual salary (USD). Mapped to LinkedIn's nearest f_SB2 bucket. Post-filtered exactly." }, "salaryMax": { "title": "💰 Salary max", "minimum": 0, "type": "integer", "description": "Maximum annual salary. Post-filtered (LinkedIn has no native max filter)." }, "salaryIncludeUnknown": { "title": "Include jobs without salary", "type": "boolean", "description": "When salaryMin/Max set, include jobs with no salary data.", "default": true }, "companies": { "title": "🏢 Company IDs to include", "type": "array", "description": "Numeric LinkedIn companyIds (filter at API level).", "default": [], "items": { "type": "string" } }, "excludeCompanies": { "title": "🚫 Exclude companies", "type": "array", "description": "Company-name substrings to exclude (case-insensitive post-filter).", "default": [], "items": { "type": "string" } }, "excludeKeywords": { "title": "🚫 Exclude keywords", "type": "array", "description": "Title substrings to exclude (case-insensitive post-filter).", "default": [], "items": { "type": "string" } }, "easyApply": { "title": "⚡ Easy Apply only", "type": "boolean", "description": "Restrict results to LinkedIn Easy Apply postings.", "default": false }, "removeAgency": { "title": "🚫 Remove staffing agencies", "type": "boolean", "description": "Heuristic post-filter on company name (\"recruitment\", \"staffing\", etc.).", "default": false }, "distance": { "title": "📏 Distance (km/mi)", "minimum": 0, "type": "integer", "description": "Search radius around location. LinkedIn auto-detects unit (miles in US/UK/CA/AU/NZ; km elsewhere)." }, "sortBy": { "title": "📊 Sort", "enum": [ "recent", "relevant" ], "type": "string", "description": "Sort order. \"recent\" is recommended for incremental feeds.", "default": "recent" }, "startUrls": { "title": "🔗 Advanced: start URLs", "type": "array", "description": "Direct LinkedIn job-search URLs. Supersedes structured query when set. Deferred to v0.5 — currently logged but not crawled.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "proxyConfiguration": { "title": "🛡 Proxy", "type": "object", "description": "Network egress configuration. The default auto-selects whatever group your plan has available — switch to residential if you observe blocks.", "default": { "useApifyProxy": true } }, "linkedinHost": { "title": "🌐 LinkedIn host", "type": "string", "description": "Subdomain (e.g. \"www\", \"de\"). Affects default geo-routing + UI labels.", "default": "www" }, "outputLanguage": { "title": "🗣 Accept-Language", "type": "string", "description": "HTTP Accept-Language header. Default en-US for parsing-cleanliness.", "default": "en-US,en;q=0.9" }, "incrementalMode": { "title": "🔁 Incremental mode", "type": "boolean", "description": "Persist seen-jobIds across runs; emit only NEW + UPDATED. Requires stateKey.", "default": false }, "stateKey": { "title": "🔑 State key", "type": "string", "description": "Unique key for cross-run state. Required when incrementalMode=true." }, "outputMode": { "title": "📤 Output mode", "enum": [ "all", "new-only", "changed-only" ], "type": "string", "description": "Which items to emit when in incrementalMode.", "default": "all" }, "emitUnchanged": { "title": "♻️ Emit UNCHANGED items", "type": "boolean", "description": "Include items that haven't changed since last run.", "default": false }, "emitExpired": { "title": "⚰️ Emit EXPIRED items", "type": "boolean", "description": "Include items that disappeared from search results.", "default": false }, "skipReposts": { "title": "Skip detected reposts", "type": "boolean", "description": "Suppress jobs with the same content as a previously-seen but inactive listing.", "default": false }, "enrichDetails": { "title": "🔬 Enrich with detail page", "type": "boolean", "description": "Fetch each job's detail page for full description, seniorityLevel, employmentType, jobFunction, industry, and applicantCount. Adds 1 HTTP request per job.", "default": false }, "scopePerQuery": { "title": "Scope state per query", "type": "boolean", "description": "Reserved — currently no-op (state is per-stateKey).", "default": false }, "discoverRelated": { "title": "🔭 Expand via relatedJobs", "type": "boolean", "description": "After the main SERP, fetch LinkedIn's relatedJobs feed for the first N results to discover jobs that don't surface on the keyword search. Useful for thin markets.", "default": false }, "relatedSeedCount": { "title": "relatedJobs seed count", "minimum": 0, "maximum": 100, "type": "integer", "description": "How many of the first SERP results are used as seeds for relatedJobs expansion. Each seed yields up to 10 candidates.", "default": 5 }, "telegramToken": { "title": "Telegram bot token", "type": "string", "description": "Bot token from @BotFather. Leave empty to disable Telegram notifications." }, "telegramChatId": { "title": "💬 Telegram chat ID", "type": "string", "description": "Numeric chat or channel ID where notifications should be sent." }, "discordWebhookUrl": { "title": "Discord webhook URL", "type": "string", "description": "Channel webhook URL. Leave empty to disable Discord notifications." }, "slackWebhookUrl": { "title": "Slack webhook URL", "type": "string", "description": "Incoming webhook URL. Leave empty to disable Slack notifications." }, "whatsappAccessToken": { "title": "WhatsApp Cloud API access token", "type": "string", "description": "Permanent System User token from Meta Business." }, "whatsappPhoneNumberId": { "title": "WhatsApp phone-number ID", "type": "string", "description": "Numeric phone-number ID from the Meta dashboard." }, "whatsappTo": { "title": "WhatsApp recipient (E.164)", "type": "string", "description": "Recipient phone number in E.164 format (e.g. \"4561234567\")." }, "webhookUrl": { "title": "Generic webhook URL (n8n / Make / Zapier)", "type": "string", "description": "Receives a JSON POST of {metadata, items} for each batch." }, "webhookHeaders": { "title": "Webhook headers", "type": "object", "description": "Additional HTTP headers to include with the generic webhook (e.g. Authorization)." }, "notificationLimit": { "title": "Max items per notification batch", "minimum": 1, "maximum": 50, "type": "integer", "description": "Cap on items included in each notification message.", "default": 5 }, "notifyOnlyChanges": { "title": "Notify only NEW/UPDATED", "type": "boolean", "description": "When in incrementalMode, suppress notifications for UNCHANGED items.", "default": false }, "compact": { "title": "Compact output", "type": "boolean", "description": "Emit only core fields (keeps cost the same; reduces dataset size).", "default": false }, "descriptionMaxLength": { "title": "Description max length", "minimum": 0, "type": "integer", "description": "Truncate description (0 = no truncation). Only relevant when enrichDetails=true.", "default": 0 }, "phoneExtractionMode": { "title": "Phone-extraction mode", "enum": [ "strict", "lenient" ], "type": "string", "description": "\"strict\" requires Tel:/+CC prefix; \"lenient\" also picks up bare local-format numbers.", "default": "strict" }, "maxResults": { "title": "💯 Max results", "minimum": 0, "type": "integer", "description": "Cap on emitted items (0 = unlimited).", "default": 100 } } }, "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 } } } } } } } } } }