{ "openapi": "3.1.0", "info": { "title": "LinkedIn职位搜索 API (V1)", "version": "v0", "description": "按关键词搜索 LinkedIn 职位发布，可按地点、发布时长、公司、雇佣类型、资历和分页进行筛选。用于发现招聘机会和研究招聘活动。" }, "servers": [ { "url": "https://api.justoneapi.com", "description": "全球生产 API（默认）" } ], "tags": [ { "name": "LinkedIn", "description": "LinkedIn专业资料、用户活动帖子和帖子评论，用于专业研究和内容分析。", "x-platform-id": "linkedin", "x-platform-aliases": [ "LinkedIn", "领英" ], "x-platform-detection-aliases": [ "LinkedIn", "领英" ] } ], "paths": { "/api/linkedin/search-job/v1": { "get": { "tags": [ "LinkedIn" ], "summary": "职位搜索", "description": "按关键词搜索 LinkedIn 职位发布，可按地点、发布时长、公司、雇佣类型、资历和分页进行筛选。用于发现招聘机会和研究招聘活动。", "operationId": "getApiLinkedinSearchJobV1", "parameters": [ { "name": "token", "in": "query", "description": "此 API 服务的访问令牌。", "required": true, "schema": { "type": "string" } }, { "name": "keyword", "in": "query", "description": "自由格式的职位搜索关键词。", "required": true, "schema": { "type": "string" } }, { "name": "location", "in": "query", "description": "自由文本地点，例如英国伦敦。", "required": false, "schema": { "type": "string", "default": "" } }, { "name": "page", "in": "query", "description": "要获取的第一页，范围从 1 到 100。每页最多包含 10 个职位。", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "numPages", "in": "query", "description": "要获取的连续页数，范围从 1 到 20。最后请求的页码不得超过 100。", "required": false, "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "geoId", "in": "query", "description": "LinkedIn 地理位置的数字 ID。当提供半径时必需。", "required": false, "schema": { "type": "string", "default": "" } }, { "name": "sortBy", "in": "query", "description": "排序顺序。日期排序应用于此响应中返回的职位。\n\n可用值：\n- `relevance`：保持相关性排序\n- `date`：将返回的职位从最新到最旧排序", "required": false, "schema": { "type": "string", "default": "relevance", "description": "LinkedIn 职位结果排序顺序", "enum": [ "relevance", "date" ] } }, { "name": "datePosted", "in": "query", "description": "职位发布时长筛选。\n\n可用值：\n- `all`：所有发布日期\n- `today`：最近 24 小时内发布\n- `3days`：最近 72 小时内发布\n- `week`：最近 7 天内发布\n- `month`：最近 30 天内发布", "required": false, "schema": { "type": "string", "default": "all", "description": "LinkedIn 职位发布时长筛选", "enum": [ "all", "today", "3days", "week", "month" ] } }, { "name": "employmentTypes", "in": "query", "description": "逗号分隔的雇佣类型。应用此筛选会启用职位详情，并可能返回比请求页面大小更少的职位。", "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string", "description": "LinkedIn 雇佣类型筛选", "enum": [ "FULLTIME", "PARTTIME", "CONTRACTOR", "INTERN" ] } } }, { "name": "seniorityLevels", "in": "query", "description": "逗号分隔的资历级别。应用此筛选会启用职位详情，并可能返回比请求页面大小更少的职位。", "required": false, "explode": false, "schema": { "type": "array", "items": { "type": "string", "description": "LinkedIn 职位资历筛选", "enum": [ "Internship", "Entry level", "Associate", "Mid-Senior level", "Director", "Executive", "Not Applicable" ] } } }, { "name": "companyId", "in": "query", "description": "用于将搜索限制为一家公司的 LinkedIn 公司数字 ID。", "required": false, "schema": { "type": "string", "default": "" } }, { "name": "remoteJobsOnly", "in": "query", "description": "仅返回带有明确远程标记的职位。此尽力而为的筛选可能会遗漏远程职位。", "required": false, "schema": { "type": "boolean", "default": false } }, { "name": "includeDetails", "in": "query", "description": "除搜索卡片外，每次请求最多可获取 100 个职位的详情。雇佣和资历筛选无论此值如何都会启用详情。", "required": false, "schema": { "type": "boolean", "default": true } }, { "name": "radius", "in": "query", "description": "搜索半径（公里），至少为 1。需要 geoId。", "required": false, "schema": { "type": "integer", "format": "int32" } }, { "name": "fields", "in": "query", "description": "要包含的职位字段，以逗号分隔。始终包含 job_id 和 job_title。", "required": false, "schema": { "type": "string", "default": "" } } ], "responses": { "200": { "description": "好的", "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": "请求参数或请求体无效", "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": "访问令牌无效或未激活", "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": "权限不足", "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": "请求速率或每日配额已超限", "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": "服务器内部错误", "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": "服务暂时不可用", "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" } } } }