> ## Documentation Index > Fetch the complete documentation index at: https://docs.socq.ai/llms.txt > Use this file to discover all available pages before exploring further. # LinkedIn 职位搜索 > 搜索并标准化公开的 LinkedIn 职位数据。 # LinkedIn 职位搜索 ```json theme={"system"} { "location": "Seattle", "keyword": "Python", "country": "US", "results_limit": 20 } ``` ## 结果字段 任务结果使用下列稳定的 SocQ 字段。来源特有的字段名称和格式会被规范化，但不会推断或补充来源未提供的值。如需请求更小的字段集，MCP 查询请使用 `fields`，Typed 工具请使用 `_result_fields`，CLI 请使用 `--result-fields`。即使值为 `null`，已声明的字段仍会保留。 | 字段 | 类型 | 可空 | 说明 | | -------------------- | --------- | -- | ---------------------------------------- | | `id` | `string` | 是 | 当前结果项的唯一标识。 | | `platform` | `string` | 否 | 结果所属的平台，例如 `instagram` 或 `linkedin`。 | | `resource` | `string` | 否 | 该结果对应的 SocQ 资源，例如 `videos` 或 `comments`。 | | `type` | `string` | 否 | 结果项的类别，例如 `video`、`post` 或 `comment`。 | | `url` | `string` | 是 | 结果项的公开访问地址（如可获得）。 | | `published_at` | `string` | 是 | 源内容的发布时间（如可获得），使用 ISO 8601 格式。 | | `collected_at` | `string` | 否 | SocQ 采集或处理该结果的时间，使用 ISO 8601 格式。 | | `title` | `string` | 是 | 职位名称。 | | `company` | `object` | 是 | 职位所属公司。 | | `company.id` | `string` | 是 | 公司的唯一标识。 | | `company.name` | `string` | 是 | 公司的显示名称。 | | `company.url` | `string` | 是 | 公司的公开访问地址（如可获得）。 | | `company.logo_url` | `string` | 是 | 公司或广告主徽标的地址。 | | `location` | `object` | 是 | 结果关联的地理位置信息。 | | `location.name` | `string` | 是 | 便于阅读的地点名称。 | | `location.city` | `string` | 是 | 城市名称。 | | `location.region` | `string` | 是 | 地区、州或省份名称。 | | `location.country` | `string` | 是 | 国家或地区名称或代码。 | | `location.latitude` | `number` | 是 | 十进制度格式的纬度。 | | `location.longitude` | `number` | 是 | 十进制度格式的经度。 | | `text` | `string` | 是 | 职位描述。 | | `employment_type` | `string` | 是 | 雇佣类型，例如全职、兼职或合同制。 | | `experience_level` | `string` | 是 | 职位要求的经验或职级。 | | `is_remote` | `boolean` | 是 | 职位是否标记为远程工作。 | | `salary` | `object` | 是 | 职位标注的薪酬信息。 | | `salary.amount` | `number` | 是 | 货币金额的数值。 | | `salary.currency` | `string` | 是 | 货币金额所使用的币种代码或符号。 | | `salary.formatted` | `string` | 是 | 便于阅读的价格或薪酬文本。 | | `expires_at` | `string` | 是 | 职位或条目的到期时间（如可获得），使用 ISO 8601 格式。 | ## 任务完成响应 ```json theme={"system"} { "code": 200, "data": { "task_id": "KH66AAF39JDV50DF", "status": "succeeded", "public_id": "linkedin/search-jobs", "result_count": 1, "credits_amount": 0.5, "results": { "limit": 50, "next_cursor": null, "has_more": false, "schema_id": "job", "schema_version": "1.0", "items": [ { "id": "4378399183", "platform": "linkedin", "resource": "search-jobs", "type": "job", "url": "https://www.linkedin.com/jobs/view/python-automation-developer-onsite-at-veridian-tech-solutions-inc-4378399183", "published_at": null, "collected_at": "2026-08-11T03:03:36.519621Z", "title": "Python Automation Developer (Onsite)", "company": null, "location": null, "text": "Python Automation Developer in Renton, WA / Everett, WA.", "employment_type": null, "experience_level": null, "is_remote": null, "salary": null, "expires_at": null } ] } } } ``` ## 与 MCP 和 CLI 一起使用 | 接口 | 值 | | ----------- | --------------------------------------------------- | | REST | `POST /v1/linkedin/search-jobs` | | Compact MCP | `socq_execute` 与 `endpoint: "linkedin/search-jobs"` | | Typed MCP | `socq_linkedin_search_jobs` | | CLI | `socq linkedin search-jobs` | 该接口使用异步任务流程并返回 `task_id`。轮询任务接口以读取标准化结果。 ## OpenAPI ````yaml zh/api-manual/agent-api/agent-api.json POST /v1/linkedin/search-jobs openapi: 3.1.0 info: title: SocQ Agent API 中文版 version: v1-c051f5df2885 description: 根据 SocQ 能力目录生成的异步社交数据 API。 servers: - url: https://api.socq.ai security: [] paths: /v1/linkedin/search-jobs: post: tags: - linkedin summary: LinkedIn 职位搜索 description: 搜索并标准化公开的 LinkedIn 职位数据。 operationId: socq_linkedin_search_jobs requestBody: required: true content: application/json: schema: $schema: https://json-schema.org/draft/2020-12/schema type: object additionalProperties: false properties: company: type: string minLength: 1 description: 请求参数。 country: type: string minLength: 1 description: 国家或地区筛选条件。 experience_level: type: string minLength: 1 description: 请求参数。 job_type: type: string minLength: 1 description: 请求参数。 jobs_to_not_include: type: array items: type: string minLength: 1 description: 请求参数。 keyword: type: string minLength: 1 description: 请求参数。 location: type: string minLength: 1 description: 请求参数。 location_radius: type: string minLength: 1 description: 请求参数。 remote: type: string minLength: 1 description: 请求参数。 results_limit: type: integer minimum: 1 maximum: 2000 default: 100 description: 最多保存的结果数，实际结果可能少于该值。 selective_search: type: boolean description: 请求参数。 time_range: type: string minLength: 1 description: 请求参数。 required: - location responses: '200': description: 任务已受理 content: application/json: schema: $ref: '#/components/schemas/AgentSubmitResponse' security: - bearerAuth: [] - apiKeyAuth: [] components: schemas: AgentSubmitResponse: type: object properties: code: type: integer const: 200 description: HTTP 业务状态码。 data: type: object properties: task_id: type: string description: 任务 ID，用于查询任务状态和结果。 status: type: string description: 任务当前状态。 created_time: type: - string - 'null' description: 任务创建时间。 idempotent_replay: type: boolean description: 是否复用了由相同 Idempotency-Key 创建的已有任务。false 表示新任务，true 表示重复提交返回原任务。 required: - task_id - status securitySchemes: bearerAuth: type: http scheme: bearer description: '使用 `Authorization: Bearer ` 请求头进行身份验证。' apiKeyAuth: type: apiKey in: header name: x-api-key description: 也可以通过 `x-api-key` 请求头提供 API Key。 ````