{ "openapi": "3.1.0", "info": { "title": "LinkedIn Job Search API (V1)", "version": "v0", "description": "Searches LinkedIn job postings by keyword with location, posting age, company, employment type, seniority, and pagination filters. Use it to discover recruitment opportunities and research hiring activity." }, "servers": [ { "url": "https://api.justoneapi.com", "description": "Global production API (default)" } ], "tags": [ { "name": "LinkedIn", "description": "LinkedIn professional profiles, user activity posts, and post comments for professional research and content analysis.", "x-platform-id": "linkedin", "x-platform-aliases": [ "LinkedIn", "领英" ], "x-platform-detection-aliases": [ "LinkedIn", "领英" ] } ], "paths": { "/api/linkedin/search-job/v1": { "get": { "tags": [ "LinkedIn" ], "summary": "Job Search", "description": "Searches LinkedIn job postings by keyword with location, posting age, company, employment type, seniority, and pagination filters. Use it to discover recruitment opportunities and research hiring activity.", "operationId": "getApiLinkedinSearchJobV1", "parameters": [ { "name": "token", "in": "query", "description": "Access token for this API service.", "required": true, "schema": { "type": "string" } }, { "name": "keyword", "in": "query", "description": "Free-form job search keyword.", "required": true, "schema": { "type": "string" } }, { "name": "location", "in": "query", "description": "Free-text location, such as London, United Kingdom.", "required": false, "schema": { "type": "string", "default": "" } }, { "name": "page", "in": "query", "description": "First page to fetch, from 1 to 100. Each page contains up to 10 jobs.", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "numPages", "in": "query", "description": "Number of consecutive pages to fetch, from 1 to 20. The last requested page must not exceed 100.", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "geoId", "in": "query", "description": "Numeric LinkedIn geographic location ID. Required when radius is supplied.", "required": false, "schema": { "type": "string", "default": "" } }, { "name": "sortBy", "in": "query", "description": "Sort order. Date sorting applies to the jobs returned in this response.\n\nAvailable Values:\n- `relevance`: Keep relevance ordering\n- `date`: Sort the returned jobs from newest to oldest", "required": false, "schema": { "type": "string", "default": "relevance", "description": "LinkedIn job result sort order", "enum": [ "relevance", "date" ] } }, { "name": "datePosted", "in": "query", "description": "Job posting age filter.\n\nAvailable Values:\n- `all`: All posting dates\n- `today`: Posted within the last 24 hours\n- `3days`: Posted within the last 72 hours\n- `week`: Posted within the last 7 days\n- `month`: Posted within the last 30 days", "required": false, "schema": { "type": "string", "default": "all", "description": "LinkedIn job posting age filter", "enum": [ "all", "today", "3days", "week", "month" ] } }, { "name": "employmentTypes", "in": "query", "description": "Comma-separated employment types. Applying this filter enables job details and may return fewer jobs than the requested page size.", "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string", "description": "LinkedIn employment type filter", "enum": [ "FULLTIME", "PARTTIME", "CONTRACTOR", "INTERN" ] } } }, { "name": "seniorityLevels", "in": "query", "description": "Comma-separated seniority levels. Applying this filter enables job details and may return fewer jobs than the requested page size.", "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string", "description": "LinkedIn job seniority filter", "enum": [ "Internship", "Entry level", "Associate", "Mid-Senior level", "Director", "Executive", "Not Applicable" ] } } }, { "name": "companyId", "in": "query", "description": "Numeric LinkedIn company ID to restrict the search to one company.", "required": false, "schema": { "type": "string", "default": "" } }, { "name": "remoteJobsOnly", "in": "query", "description": "Return only jobs with an explicit remote marker. This best-effort filter may omit remote jobs.", "required": false, "schema": { "type": "boolean", "default": false } }, { "name": "includeDetails", "in": "query", "description": "Fetch details for up to 100 jobs per request in addition to search cards. Employment and seniority filters enable details regardless of this value.", "required": false, "schema": { "type": "boolean", "default": true } }, { "name": "radius", "in": "query", "description": "Search radius in kilometres, at least 1. Requires geoId.", "required": false, "schema": { "type": "integer", "format": "int32" } }, { "name": "fields", "in": "query", "description": "Comma-separated job fields to include. job_id and job_title are always included.", "required": false, "schema": { "type": "string", "default": "" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" }, "requestParams": { "type": "object", "properties": { "query": { "type": "object", "additionalProperties": { "type": "object" } }, "body": { "type": "object", "properties": { "empty": { "type": "boolean" }, "array": { "type": "boolean" }, "null": { "type": "boolean" }, "object": { "type": "boolean" }, "float": { "type": "boolean" }, "integralNumber": { "type": "boolean" }, "nodeType": { "type": "string", "enum": [ "ARRAY", "BINARY", "BOOLEAN", "MISSING", "NULL", "NUMBER", "OBJECT", "POJO", "STRING" ] }, "string": { "type": "boolean" }, "floatingPointNumber": { "type": "boolean" }, "missingNode": { "type": "boolean" }, "valueNode": { "type": "boolean" }, "container": { "type": "boolean" }, "pojo": { "type": "boolean" }, "short": { "type": "boolean" }, "int": { "type": "boolean" }, "long": { "type": "boolean" }, "double": { "type": "boolean" }, "bigDecimal": { "type": "boolean" }, "bigInteger": { "type": "boolean" }, "textual": { "type": "boolean", "deprecated": true }, "boolean": { "type": "boolean" }, "binary": { "type": "boolean" }, "number": { "type": "boolean" }, "embeddedValue": { "type": "boolean" } } } } } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "400": { "description": "Invalid request parameters or body", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" }, "requestParams": { "type": "object", "properties": { "query": { "type": "object", "additionalProperties": { "type": "object" } }, "body": { "type": "object", "properties": { "empty": { "type": "boolean" }, "array": { "type": "boolean" }, "null": { "type": "boolean" }, "object": { "type": "boolean" }, "float": { "type": "boolean" }, "integralNumber": { "type": "boolean" }, "nodeType": { "type": "string", "enum": [ "ARRAY", "BINARY", "BOOLEAN", "MISSING", "NULL", "NUMBER", "OBJECT", "POJO", "STRING" ] }, "string": { "type": "boolean" }, "floatingPointNumber": { "type": "boolean" }, "missingNode": { "type": "boolean" }, "valueNode": { "type": "boolean" }, "container": { "type": "boolean" }, "pojo": { "type": "boolean" }, "short": { "type": "boolean" }, "int": { "type": "boolean" }, "long": { "type": "boolean" }, "double": { "type": "boolean" }, "bigDecimal": { "type": "boolean" }, "bigInteger": { "type": "boolean" }, "textual": { "type": "boolean", "deprecated": true }, "boolean": { "type": "boolean" }, "binary": { "type": "boolean" }, "number": { "type": "boolean" }, "embeddedValue": { "type": "boolean" } } } } } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "401": { "description": "Invalid or inactive access token", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" }, "requestParams": { "type": "object", "properties": { "query": { "type": "object", "additionalProperties": { "type": "object" } }, "body": { "type": "object", "properties": { "empty": { "type": "boolean" }, "array": { "type": "boolean" }, "null": { "type": "boolean" }, "object": { "type": "boolean" }, "float": { "type": "boolean" }, "integralNumber": { "type": "boolean" }, "nodeType": { "type": "string", "enum": [ "ARRAY", "BINARY", "BOOLEAN", "MISSING", "NULL", "NUMBER", "OBJECT", "POJO", "STRING" ] }, "string": { "type": "boolean" }, "floatingPointNumber": { "type": "boolean" }, "missingNode": { "type": "boolean" }, "valueNode": { "type": "boolean" }, "container": { "type": "boolean" }, "pojo": { "type": "boolean" }, "short": { "type": "boolean" }, "int": { "type": "boolean" }, "long": { "type": "boolean" }, "double": { "type": "boolean" }, "bigDecimal": { "type": "boolean" }, "bigInteger": { "type": "boolean" }, "textual": { "type": "boolean", "deprecated": true }, "boolean": { "type": "boolean" }, "binary": { "type": "boolean" }, "number": { "type": "boolean" }, "embeddedValue": { "type": "boolean" } } } } } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" }, "requestParams": { "type": "object", "properties": { "query": { "type": "object", "additionalProperties": { "type": "object" } }, "body": { "type": "object", "properties": { "empty": { "type": "boolean" }, "array": { "type": "boolean" }, "null": { "type": "boolean" }, "object": { "type": "boolean" }, "float": { "type": "boolean" }, "integralNumber": { "type": "boolean" }, "nodeType": { "type": "string", "enum": [ "ARRAY", "BINARY", "BOOLEAN", "MISSING", "NULL", "NUMBER", "OBJECT", "POJO", "STRING" ] }, "string": { "type": "boolean" }, "floatingPointNumber": { "type": "boolean" }, "missingNode": { "type": "boolean" }, "valueNode": { "type": "boolean" }, "container": { "type": "boolean" }, "pojo": { "type": "boolean" }, "short": { "type": "boolean" }, "int": { "type": "boolean" }, "long": { "type": "boolean" }, "double": { "type": "boolean" }, "bigDecimal": { "type": "boolean" }, "bigInteger": { "type": "boolean" }, "textual": { "type": "boolean", "deprecated": true }, "boolean": { "type": "boolean" }, "binary": { "type": "boolean" }, "number": { "type": "boolean" }, "embeddedValue": { "type": "boolean" } } } } } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "429": { "description": "Request rate or daily quota limit exceeded", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" }, "requestParams": { "type": "object", "properties": { "query": { "type": "object", "additionalProperties": { "type": "object" } }, "body": { "type": "object", "properties": { "empty": { "type": "boolean" }, "array": { "type": "boolean" }, "null": { "type": "boolean" }, "object": { "type": "boolean" }, "float": { "type": "boolean" }, "integralNumber": { "type": "boolean" }, "nodeType": { "type": "string", "enum": [ "ARRAY", "BINARY", "BOOLEAN", "MISSING", "NULL", "NUMBER", "OBJECT", "POJO", "STRING" ] }, "string": { "type": "boolean" }, "floatingPointNumber": { "type": "boolean" }, "missingNode": { "type": "boolean" }, "valueNode": { "type": "boolean" }, "container": { "type": "boolean" }, "pojo": { "type": "boolean" }, "short": { "type": "boolean" }, "int": { "type": "boolean" }, "long": { "type": "boolean" }, "double": { "type": "boolean" }, "bigDecimal": { "type": "boolean" }, "bigInteger": { "type": "boolean" }, "textual": { "type": "boolean", "deprecated": true }, "boolean": { "type": "boolean" }, "binary": { "type": "boolean" }, "number": { "type": "boolean" }, "embeddedValue": { "type": "boolean" } } } } } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" }, "requestParams": { "type": "object", "properties": { "query": { "type": "object", "additionalProperties": { "type": "object" } }, "body": { "type": "object", "properties": { "empty": { "type": "boolean" }, "array": { "type": "boolean" }, "null": { "type": "boolean" }, "object": { "type": "boolean" }, "float": { "type": "boolean" }, "integralNumber": { "type": "boolean" }, "nodeType": { "type": "string", "enum": [ "ARRAY", "BINARY", "BOOLEAN", "MISSING", "NULL", "NUMBER", "OBJECT", "POJO", "STRING" ] }, "string": { "type": "boolean" }, "floatingPointNumber": { "type": "boolean" }, "missingNode": { "type": "boolean" }, "valueNode": { "type": "boolean" }, "container": { "type": "boolean" }, "pojo": { "type": "boolean" }, "short": { "type": "boolean" }, "int": { "type": "boolean" }, "long": { "type": "boolean" }, "double": { "type": "boolean" }, "bigDecimal": { "type": "boolean" }, "bigInteger": { "type": "boolean" }, "textual": { "type": "boolean", "deprecated": true }, "boolean": { "type": "boolean" }, "binary": { "type": "boolean" }, "number": { "type": "boolean" }, "embeddedValue": { "type": "boolean" } } } } } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "503": { "description": "Service temporarily unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" }, "reason": { "type": "string" }, "requestParams": { "type": "object", "properties": { "query": { "type": "object", "additionalProperties": { "type": "object" } }, "body": { "type": "object", "properties": { "empty": { "type": "boolean" }, "array": { "type": "boolean" }, "null": { "type": "boolean" }, "object": { "type": "boolean" }, "float": { "type": "boolean" }, "integralNumber": { "type": "boolean" }, "nodeType": { "type": "string", "enum": [ "ARRAY", "BINARY", "BOOLEAN", "MISSING", "NULL", "NUMBER", "OBJECT", "POJO", "STRING" ] }, "string": { "type": "boolean" }, "floatingPointNumber": { "type": "boolean" }, "missingNode": { "type": "boolean" }, "valueNode": { "type": "boolean" }, "container": { "type": "boolean" }, "pojo": { "type": "boolean" }, "short": { "type": "boolean" }, "int": { "type": "boolean" }, "long": { "type": "boolean" }, "double": { "type": "boolean" }, "bigDecimal": { "type": "boolean" }, "bigInteger": { "type": "boolean" }, "textual": { "type": "boolean", "deprecated": true }, "boolean": { "type": "boolean" }, "binary": { "type": "boolean" }, "number": { "type": "boolean" }, "embeddedValue": { "type": "boolean" } } } } } }, "required": [ "code", "data", "message", "recordTime" ] } } } } }, "x-order": 31501500, "x-api-version": "v1", "x-docs-slug": "job-search-v1", "x-search-aliases": [ "LinkedIn job search", "领英职位搜索", "LinkedIn招聘岗位搜索" ], "x-highlights": [], "x-endpoint-family": "linkedin_search_job" } } } }