---
document_id: agent.collection.task.linkedin_search_jobs_v1
schema_version: 2
parent_document_id: agent.querying
section: querying
---

<!-- Generated by scripts.build_agent_guide; do not edit. -->

# Search jobs / 搜索职位

Search LinkedIn jobs by keyword, paged by page number (25 per page).

按关键词搜索 LinkedIn 职位，按页码翻页（每页 25 条）。

Task / 任务: `linkedin_search_jobs_v1`
Platform / 平台: LinkedIn / 领英
Billing / 计费: 84 Credits per successful task / 每个成功任务 84 Credits
Estimate / 估价: call `estimate_collection`; start directly when `approval_required=false`, otherwise obtain approval for `upper_bound_credits`.
估价：调用 `estimate_collection`；`approval_required=false` 时直接启动，否则请用户确认 `upper_bound_credits`。

## Limitations / 限制

- keywords 必填：上游 14 个入参全部选填，不传不报错但会返回泛化职位列表且照样计费。
- page 从 1 开始，每页 25 条；上限 40 页，到达上限后 has_more 为 false。
- 返回 total（真机约 27.7 万），has_more 由它推出而不是恒为 false。
- sort_by 只接受 Most relevant 与 Most recent。

## Inputs / 输入

- `keywords` — Job keywords / 职位关键词; kind=text; required=True; default=''; bounds=min_length=1, max_length=100
- `geo_code` — Geo code / 地区代码; kind=text; required=False; default='92000000'; bounds=min_length=0, max_length=2000
- `page` — Page / 页码; kind=integer; required=False; default=1; bounds=min=1, max=40
- `sort_by` — Sort by / 排序; kind=select; required=False; default='Most relevant'; allowed=Most relevant, Most recent

## Minimal call / 最小调用

`estimate_collection`

```json
{
  "task_query": "搜索 LinkedIn 上的数据工程师职位",
  "task_code": "linkedin_search_jobs_v1",
  "input": {
    "keywords": "data engineer"
  }
}
```


## Result and pagination / 结果与分页

- mode=page
- current page: `data.page`; page bound: `data.next_page`; next page: `data.next_page` → `page` (null means stop). / 下一页使用 `data.next_page`，为 null 时结束；总页数未知不代表没有下一页。

Only the fields listed below are part of the stable result contract. /
只有下方列出的字段属于稳定结果契约。

## Result fields / 结果字段

- `meta.request_id` — type=string; Asklear request identifier for tracing. / 用于追踪的 Asklear 请求 ID。
- `meta.api_name` — type=string; Executed collection operation name. / 实际执行的采集操作名称。
- `meta.latency_ms` — type=integer; Collection execution latency in milliseconds. / 采集执行耗时（毫秒）。
- `meta.credits_charged` — type=integer; Asklear user-side Credits settled for this task after completion. / 任务完成后 Asklear 用户侧实际结算的 Credits。
- `data.items` — type=array<object>; Projected public items for this task. / 本任务投影后的公开条目。
- `data.item_count` — type=integer; Number of returned items. / 本次返回的条目数。
- `data.items[].job_id` — type=scalar|null; Job identifier, when available. / 职位 ID（如有）。
- `data.items[].job_title` — type=scalar|null; Job title, when available. / 职位名称（如有）。
- `data.items[].company_name` — type=scalar|null; Company name, when available. / 公司名称（如有）。
- `data.items[].company_url` — type=scalar|null; Company url, when available. / 公司链接（如有）。
- `data.items[].job_url` — type=scalar|null; Job url, when available. / 职位链接（如有）。
- `data.items[].location` — type=scalar|null; Location, when available. / 地点（如有）。
- `data.items[].remote` — type=scalar|null; Remote, when available. / 远程（如有）。
- `data.items[].published_at` — type=integer|null; Publication time, when available. / 发布时间（如有）。
- `data.items[].salary` — type=scalar|null; Salary, when available. / 薪资（如有）。
- `data.page` — type=integer; Current page number. / 当前页码。
- `data.next_page` — type=integer|null; Next page, or null when finished. / 下一页页码；结束时为 null。
- `data.has_more` — type=boolean; Whether another job page is available. / 是否还有下一页职位。
- `data.next_cursor` — type=null; Not used for page-number pagination. / 页码分页不使用游标。
- `data.total` — type=integer|null; Total matching jobs when supplied. / 如提供则为匹配职位总数。

Use `list_collection_tasks` as the runtime authority, then `describe_collection_task` for one task's full input contract, examples and limits. Collection access is entitlement-gated. /
以 `list_collection_tasks` 返回为运行时准据，再用 `describe_collection_task` 取单个任务的完整入参契约、示例与限制；采集能力受 entitlement 控制。