{ "openapi": "3.0.1", "info": { "title": "Linkedin Jobs API", "description": "Search real time LinkedIn job listings with hourly updates. Filter by title, company, location, salary, and AI insights. Retrieve structured job data, company details, and enriched metadata for job boards, recruitment and analytics.", "version": "0.0", "x-build-id": "99UjU8ATU4nlZIgBp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/greatdatacompany~linkedin-jobs-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-greatdatacompany-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/greatdatacompany~linkedin-jobs-api/runs": { "post": { "operationId": "runs-sync-greatdatacompany-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/greatdatacompany~linkedin-jobs-api/run-sync": { "post": { "operationId": "run-sync-greatdatacompany-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", "required": [ "limit", "offset" ], "properties": { "title": { "title": "Job Title(s)", "type": "array", "description": "Filter by one or more job titles.\n\n**Example**: Software Engineer\n\n**NOTE**: Use \"\" for exact match.\nExample: `\"Software Engineer\"` will return jobs with title exactly `\"Software Engineer\"` while `Software Engineer` will return jobs with title containing `Software Engineer` (```Senior Software Engineer```, `Junior Software Engineer`, etc.)", "items": { "type": "string" } }, "company": { "title": "Companies", "type": "array", "description": "Filter by one or more companies.\n\n**Example**: Google\n\n**NOTE**: Use \"\" for exact match.\nExample: `\"Google\"` will return jobs with company exactly `\"Google\"` while `Google` will return jobs with company containing `Google` (```Google Cloud```, `Google DeepMind`, etc.)", "items": { "type": "string" } }, "location": { "title": "Location(s)", "type": "array", "description": "Filter by one or more locations.\n\n**Example**: New York, London, etc.\n\n**NOTE**: For precise searches use the full location (eg: New York, NY, United States). You can refer to https://location.aws.com/demo to find the precise location strings to use", "items": { "type": "string" } }, "timeframe": { "title": "Timeframe", "enum": [ "1h", "24h", "7d", "30d" ], "type": "string", "description": "Only return jobs posted within the selected timeframe.", "default": "7d" }, "posted_after": { "title": "Posted After", "type": "integer", "description": "Only return jobs posted after the specified timestamp." }, "posted_before": { "title": "Posted Before", "type": "integer", "description": "Only return jobs posted before the specified timestamp." }, "created_after": { "title": "Created After", "type": "integer", "description": "Only return jobs indexed in our system after the specified timestamp." }, "created_before": { "title": "Created Before", "type": "integer", "description": "Only return jobs indexed in our system before the specified timestamp." }, "offset": { "title": "Offset", "minimum": 0, "type": "integer", "description": "Number of matching jobs to skip.\nUse alongside limit to paginate through search results. Continue increasing the offset until fewer jobs than the requested limit are returned.", "default": 0 }, "limit": { "title": "Limit", "minimum": 100, "maximum": 1000, "type": "integer", "description": "Maximum number of jobs to return (default: 100, max: 1000).\nUse alongside offset to paginate through search results. Continue increasing the offset until fewer jobs than the requested limit are returned.", "default": 100 }, "li_company_slug": { "title": "LinkedIn Company Slug(s)", "type": "array", "description": "Filter by one or more LinkedIn company slugs.\n\n**Example**: google, jpmorganchase, etc", "items": { "type": "string" } }, "li_company_id": { "title": "LinkedIn Company ID(s)", "type": "array", "description": "Filter by one or more LinkedIn company IDs.\n\n**Example**: 1068, 1035, etc", "items": { "type": "string" } }, "ai_industries": { "title": "AI Industries", "type": "array", "description": "Filter by one or more AI Derived industries.\n\n**NOTE**: by default it will return jobs that have any of the selected industries. If you want to return jobs that have all of the selected industries, enable the `match_all_ai_industries` parameter.", "items": { "type": "string", "enum": [ "artificial intelligence and machine learning", "cybersecurity", "data science and analytics", "engineering", "information technology", "software engineering", "account management and customer success", "administration and office support", "banking, investment and insurance", "business development and partnerships", "business operations and strategy", "compliance, risk and audit", "construction and skilled trades", "content, communications and public relations", "customer service and support", "design and user experience", "education and training", "finance and accounting", "financial planning and analysis", "general operations", "growth and performance marketing", "healthcare", "human resources", "legal", "logistics and warehousing", "manufacturing and production", "marketing", "product management", "project and programme management", "quality assurance and testing", "recruitment and talent acquisition", "sales", "social care and community services", "supply chain and procurement" ], "enumTitles": [ "Artificial Intelligence and Machine Learning", "Cybersecurity", "Data Science and Analytics", "Engineering", "Information Technology", "Software Engineering", "Account Management and Customer Success", "Administration and Office Support", "Banking, Investment and Insurance", "Business Development and Partnerships", "Business Operations and Strategy", "Compliance, Risk and Audit", "Construction and Skilled Trades", "Content, Communications and Public Relations", "Customer Service and Support", "Design and User Experience", "Education and Training", "Finance and Accounting", "Financial Planning and Analysis", "General Operations", "Growth and Performance Marketing", "Healthcare", "Human Resources", "Legal", "Logistics and Warehousing", "Manufacturing and Production", "Marketing", "Product Management", "Project and Programme Management", "Quality Assurance and Testing", "Recruitment and Talent Acquisition", "Sales", "Social Care and Community Services", "Supply Chain and Procurement" ] } }, "match_all_ai_industries": { "title": "Match All AI Industries", "type": "boolean", "description": "Require jobs to match all selected AI industries. When disabled, jobs matching any selected AI Industry are returned.", "default": false }, "ai_experience_levels": { "title": "AI Experience Levels", "type": "array", "description": "Filter by one or more AI Derived experience levels.\n\n**NOTE**: by default it will return jobs that have any of the selected experience levels. If you want to return jobs that have all of the selected experience levels, enable the `match_all_ai_experience_levels` parameter.", "items": { "type": "string", "enum": [ "entry-level", "junior (1-3 years)", "intermediate (4-7 years)", "experienced (8-12 years)", "expert & leadership (13+ years)" ], "enumTitles": [ "Entry-Level", "Junior (1-3 years)", "Intermediate (4-7 years)", "Experienced (8-12 years)", "Expert & Leadership (13+ years)" ] } }, "match_all_ai_experience_levels": { "title": "Match All AI Experience Levels", "type": "boolean", "description": "Require jobs to match all selected AI experience levels. When disabled, jobs matching any selected AI Experience Level are returned.", "default": false }, "ai_contract_types": { "title": "AI Contract Types", "type": "array", "description": "Filter by one or more AI Derived contract types.", "items": { "type": "string", "enum": [ "full time", "contractor", "part time", "apprenticeship", "internship" ], "enumTitles": [ "Full Time", "Contractor", "Part Time", "Apprenticeship", "Internship" ] } }, "ai_work_environments": { "title": "AI Work Environments", "type": "array", "description": "Filter by one or more AI Derived work environments.", "items": { "type": "string", "enum": [ "hybrid", "office full-time", "remote", "onsite", "field" ], "enumTitles": [ "Hybrid", "Office Full-Time", "Remote", "Onsite", "Field" ] } }, "industries": { "title": "Industries", "type": "array", "description": "Filter by one or more industries as mentioned in the job page.", "items": { "type": "string" } }, "experience_levels": { "title": "Experience Levels", "type": "array", "description": "Filter by one or more experience levels as mentioned in the job page.", "items": { "type": "string" } }, "contract_types": { "title": "Contract Types", "type": "array", "description": "Filter by one or more contract types as mentioned in the job page.", "items": { "type": "string" } }, "work_environments": { "title": "Work Environments", "type": "array", "description": "Filter by one or more work environments as mentioned in the job page.", "items": { "type": "string" } }, "salary_min": { "title": "Minimum Salary", "type": "integer", "description": "Minimum acceptable salary." }, "salary_max": { "title": "Maximum Salary", "type": "integer", "description": "Maximum acceptable salary." }, "query": { "title": "Search Query", "type": "string", "description": "Full-text search query." }, "include_fields": { "title": "Include Heavy Fields", "type": "array", "description": "Additional heavy fields to include in the response such as the description in html or text format.", "items": { "type": "string", "enum": [ "description_html", "description_text" ], "enumTitles": [ "Description HTML", "Description Text" ] } } } }, "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 } } } } } } } } } }