{ "openapi": "3.0.1", "info": { "title": "LinkedIn Jobs & Hiring Signals Scraper", "description": "Scrape LinkedIn job listings by keyword, location, or search URL and turn them into clean, CSV-ready hiring-signal data - no LinkedIn login or cookies required.", "version": "1.0", "x-build-id": "dmBdTQmIYYFe0y9x0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/coregent~linkedin-jobs-hiring-signals-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-coregent-linkedin-jobs-hiring-signals-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/coregent~linkedin-jobs-hiring-signals-scraper/runs": { "post": { "operationId": "runs-sync-coregent-linkedin-jobs-hiring-signals-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/coregent~linkedin-jobs-hiring-signals-scraper/run-sync": { "post": { "operationId": "run-sync-coregent-linkedin-jobs-hiring-signals-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": { "searchQueries": { "title": "Search keywords", "type": "array", "description": "Job keywords to search, for example \"data engineer\", \"sales manager\". Each keyword is combined with every location below. Provide at least one of Search keywords or LinkedIn jobs search URLs.", "default": [ "data engineer" ], "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Search locations, for example \"Australia\", \"Sydney\", \"United States\". Each keyword is paired with each location. Leave empty to search without a location filter.", "default": [], "items": { "type": "string" } }, "jobSearchUrls": { "title": "LinkedIn jobs search URLs", "type": "array", "description": "Paste LinkedIn jobs search result URLs directly (must start with https://www.linkedin.com/jobs/). Each URL's filters are preserved; the actor paginates them for you.", "default": [], "items": { "type": "string" } }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of saved unique jobs across the whole run (not per query). Range 1-10000.", "default": 100 }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "recent" ], "type": "string", "description": "Result ordering where supported. Relevance or most recent.", "default": "relevance" }, "datePosted": { "title": "Date posted", "enum": [ "any", "past24h", "pastWeek", "pastMonth" ], "type": "string", "description": "Filter jobs by posting recency. Applied at the LinkedIn source where possible.", "default": "any" }, "workplaceTypes": { "title": "Workplace types", "type": "array", "description": "Filter by workplace type. Leave empty for all.", "items": { "type": "string", "enum": [ "remote", "hybrid", "onsite" ], "enumTitles": [ "Remote", "Hybrid", "On-site" ] }, "default": [] }, "employmentTypes": { "title": "Employment types", "type": "array", "description": "Filter by employment type. Leave empty for all.", "items": { "type": "string", "enum": [ "full_time", "part_time", "contract", "temporary", "internship", "volunteer", "other" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Temporary", "Internship", "Volunteer", "Other" ] }, "default": [] }, "includeDescription": { "title": "Include job descriptions", "type": "boolean", "description": "Visit each job's detail page to extract the full description plus employment type, seniority, job function, industries, and applicants count. Turning this off makes runs faster (cards only) but returns fewer fields.", "default": true }, "includeCompanySignals": { "title": "Compute company hiring signals", "type": "boolean", "description": "Add per-run company hiring counts (company_jobs_in_run) and the hiring-signal score/label/reason tags. Uses only jobs collected in this run; no deep company crawl.", "default": true }, "companyIncludeKeywords": { "title": "Company include keywords", "type": "array", "description": "Keep only jobs from companies whose name contains one of these terms (case-insensitive). Leave empty to keep all.", "default": [], "items": { "type": "string" } }, "companyExcludeKeywords": { "title": "Company exclude keywords", "type": "array", "description": "Exclude jobs from companies whose name contains one of these terms (case-insensitive), for example \"recruitment agency\".", "default": [], "items": { "type": "string" } }, "titleIncludeKeywords": { "title": "Title include keywords", "type": "array", "description": "Keep only jobs whose title contains one of these terms (case-insensitive). Leave empty to keep all.", "default": [], "items": { "type": "string" } }, "titleExcludeKeywords": { "title": "Title exclude keywords", "type": "array", "description": "Exclude jobs whose title contains one of these terms (case-insensitive), for example \"intern\".", "default": [], "items": { "type": "string" } }, "saveOnlyUniqueItems": { "title": "Save only unique items", "type": "boolean", "description": "Deduplicate jobs by job ID and canonical job URL so you are not charged for duplicates across overlapping queries.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy configuration. Defaults to Apify Proxy enabled. Apify Residential is NOT supported and will fail the run at startup; if you need residential routing, supply your own provider via Custom proxy URLs (proxyUrls).", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }