{ "openapi": "3.0.1", "info": { "title": "LinkedIn Jobs API | Search Job Listings & Salaries", "description": "Search public LinkedIn job listings as clean, structured JSON. Find jobs by keyword, location, seniority, and job type, or fetch specific job URLs. Get title, company, location, salary, description, and apply links. Pay per job, MCP-ready for Claude and AI agents.", "version": "0.0", "x-build-id": "uRrFL83zqwOZamfNP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/johnvc~linkedin-jobs-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-johnvc-linkedin-jobs-api", "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/johnvc~linkedin-jobs-api/runs": { "post": { "operationId": "runs-sync-johnvc-linkedin-jobs-api", "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/johnvc~linkedin-jobs-api/run-sync": { "post": { "operationId": "run-sync-johnvc-linkedin-jobs-api", "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": { "keyword": { "title": "Keyword", "type": "string", "description": "Job title or keyword to search for, e.g. 'python developer'. Combine with Location and filters." }, "location": { "title": "Location", "type": "string", "description": "Location to search within, e.g. 'New York' or 'United Kingdom'." }, "country": { "title": "Country code", "type": "string", "description": "Two-letter country code to scope the search, e.g. 'US', 'GB', 'DE'." }, "jobType": { "title": "Job type", "enum": [ "full-time", "part-time", "contract", "temporary", "internship", "volunteer" ], "type": "string", "description": "Employment type filter. LinkedIn's public search no longer applies this filter itself, so it is applied after fetching: each job's listed employment type must match. Jobs that do not match are skipped and not charged." }, "experienceLevel": { "title": "Experience level", "enum": [ "internship", "entry", "associate", "mid-senior", "director", "executive" ], "type": "string", "description": "Seniority filter. LinkedIn's public search no longer applies this filter itself, so it is applied after fetching: each job's listed seniority level must match. Jobs that do not match are skipped and not charged." }, "remote": { "title": "Remote only", "type": "boolean", "description": "Return only remote jobs. Applied after fetching as a text match: a job qualifies when the word 'remote' appears in its title, location, or the first 2,000 characters of its description, and is not negated ('not remote', 'no remote'). Jobs that do not match are skipped and not charged.", "default": false }, "company": { "title": "Company", "type": "string", "description": "Filter to a specific company name. The name is matched to LinkedIn's company list; if no close match is found, the name is added to the keyword search instead." }, "timeRange": { "title": "Date posted", "enum": [ "past-day", "past-week", "past-month" ], "type": "string", "description": "Only jobs posted within this window." }, "jobUrls": { "title": "Job URLs", "maxItems": 1000, "type": "array", "description": "One or more specific LinkedIn job posting URLs, e.g. https://www.linkedin.com/jobs/view/4286961888. Each returns one row. Use instead of, or in addition to, the keyword search above. Up to 1000 per run. Need larger batches? Contact us and we can raise this limit for your account.", "items": { "type": "string" } }, "maxJobs": { "title": "Max jobs per search", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of jobs to return for each keyword search or search URL. Caps upstream cost. Ignored for specific job URLs.", "default": 25 } } }, "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 } } } } } } } } } }