{ "openapi": "3.0.1", "info": { "title": "LinkedIn Jobs by Company", "description": "Scrape LinkedIn jobs for specific companies. Search by company name, URL, or numeric ID. Filter by location, employment type, seniority, remote, and more. Get detailed job descriptions, salary info, and applicant counts.", "version": "1.0", "x-build-id": "1BoILWAv8G5E91bbz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/burbn~linkedin-company-jobs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-burbn-linkedin-company-jobs", "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/burbn~linkedin-company-jobs/runs": { "post": { "operationId": "runs-sync-burbn-linkedin-company-jobs", "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/burbn~linkedin-company-jobs/run-sync": { "post": { "operationId": "run-sync-burbn-linkedin-company-jobs", "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": { "company": { "title": "🏢 Company Name or URL", "type": "string", "description": "Enter LinkedIn company vanity slugs or company page URLs, comma-separated (up to 10). Examples: 'microsoft', '/company/google', 'https://www.linkedin.com/company/apple'. Either this or Company ID is required.", "default": "google" }, "company_id": { "title": "🔢 Company ID", "type": "string", "description": "LinkedIn company numeric IDs (f_C), comma-separated (up to 10). Example: '1441' for Google. You can find the numeric company ID (job_linkedin_company_id) by using the [LinkedIn Jobs Search](https://apify.com/burbn/linkedin-jobs-search) actor. Either this or Company Name/URL is required." }, "query": { "title": "🔍 Keyword Filter", "type": "string", "description": "Optional free-form keyword filter applied within the selected companies. Example: 'Software Engineer', 'Data Scientist'. Leave empty to get the company's entire job list." }, "location": { "title": "📍 Location", "type": "string", "description": "Free-text location filter (e.g., 'London, United Kingdom', 'Berlin, Germany', 'New York, US'). Leave empty for worldwide search." }, "page": { "title": "📄 Start Page", "minimum": 1, "maximum": 100, "type": "integer", "description": "Starting page number (1-based). Each page returns 10 jobs. Max: 100.", "default": 1 }, "num_pages": { "title": "📑 Number of Pages", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many consecutive pages to fetch (each page = 10 jobs). Max: 20 pages = 200 jobs.", "default": 1 }, "geo_id": { "title": "🌐 LinkedIn Geo ID", "type": "string", "description": "LinkedIn numeric geo ID (e.g., '102571732' for New York City). Required if you want radius search to work." }, "radius": { "title": "📏 Search Radius (km)", "minimum": 1, "type": "integer", "description": "Search radius in kilometres around the geo_id location. Requires geo_id to be set." }, "country": { "title": "🏳️ Country Code", "type": "string", "description": "2-letter country code (e.g., 'us', 'uk', 'de', 'in'). Selects proxy exit market.", "default": "us" }, "sort_by": { "title": "📊 Sort By", "enum": [ "relevance", "date" ], "type": "string", "description": "Sort order for job results.", "default": "relevance" }, "date_posted": { "title": "📅 Date Posted", "enum": [ "all", "today", "3days", "week", "month" ], "type": "string", "description": "Filter jobs by how recently they were posted.", "default": "all" }, "employment_types": { "title": "💼 Employment Type", "enum": [ "", "FULLTIME", "PARTTIME", "CONTRACTOR", "INTERN" ], "type": "string", "description": "Filter jobs by employment type.", "default": "" }, "seniority_levels": { "title": "📈 Seniority Level", "enum": [ "", "Internship", "Entry level", "Associate", "Mid-Senior level", "Director", "Executive", "Not Applicable" ], "type": "string", "description": "Filter jobs by seniority level.", "default": "" }, "remote_jobs_only": { "title": "🏠 Remote Jobs Only", "type": "boolean", "description": "If enabled, returns only jobs with an explicit remote marker.", "default": false }, "include_details": { "title": "📝 Include Job Details", "type": "boolean", "description": "Fetch each job's detail page (description, salary, seniority, applicants count). Set to false for ~3x faster response but less data.", "default": true }, "fields": { "title": "📋 Custom Fields", "type": "string", "description": "Comma-separated list of specific fields to return (e.g., 'job_title,employer_name,job_location'). Leave empty for all fields." } } }, "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 } } } } } } } } } }