如何搜索最近一周的远程职位并保存可追溯结果?
要整理最近的远程 LinkedIn 职位候选表,用 linkedin.web_v2.search_jobs 查一页,用 save_jobs.py 归档响应,在 mapping.json 里确认字段映射后,用 export_jobs.py 导出可筛选的 jobs.csv。只为选中的职位用 linkedin.web_v2.get_job_detail 查技能或招聘团队。整个流程只读取职位,不申请职位,也不联系任何人。
1. 确定范围和成本
示例读取一页全球远程软件工程职位,并把响应保存为证据。先在免费的 /v1/capabilities/inspect 查看 data:linkedin.web_v2.search_jobs 当前的输入与价格。默认只查一页,每多一页、每次详情都是另一次收费调用。
2. 发出明确筛选请求
geo_code=92000000 表示全球;城市筛选要用该城市的整数地区码,不能填城市名字符串。筛选值与类型见FAQ。
查“Remote 或 Hybrid”时,不要在 onsite_remotes 里放两个值,实际只有第一个值生效。改用两份独立请求示例,分别保留每份请求的来源,并按两次调用做预算。title_ids、functions 虽在允许输入的结构里,但不会筛选结果。
3. 检查状态并保存证据
HTTP 失败时先保留错误信息,不继续导出。把下面的脚本存为 save_jobs.py;save_jobs.py 检查业务状态和 data 之后才写新文件,不猜列表路径,也不覆盖已有归档。
linkedin-jobs-verified-0.json 保留 request_id、action 和完整的 data,供人工筛选和后续字段映射。归档保存原始结果,不是标准化的职位 CSV:BeatAPI 直接清洗并透传 data,没有统一的 jobs[] 字段。
4. 有界翻页与去重
获准继续翻页时,保持相同筛选,把 start 依次改为 25、50,每页存成新文件。每取一页先和上一页比对,出现重复或错误就停止。按实际职位 URL 或稳定 ID 去重,不按标题去重,因为不同公司可能用同一个职位名。记录检索时间和筛选条件;一页结果不代表全部职位。
5. 只对选定职位查询详情
从结果里取选中职位的完整 URL,调用 linkedin.web_v2.get_job_detail。需要技能时传 include_skills=true;需要招聘团队时传 include_hiring_team=true。不要默认给所有结果都查详情,也不要把返回的联系方式自动用于外联。
6. 验收和失败恢复
确认 linkedin-jobs-verified-0.json 可读、保留了 request_id、筛选条件一致。业务失败时不会生成归档,save_jobs.py 也不会覆盖已有归档,所以重复运行要换新的目标文件,或直接复用已存文件。保留源 JSON 便于查错;本地转换出错时从已存 JSON 重做,不要为此再次收费查询。
7. 交付可筛选岗位表:先人工确认映射,再离线导出
原始 JSON 归档不是最终岗位清单。最终交付 jobs.csv,列为岗位、公司、地区、工作模式、发布时间、职位链接、是否入选、理由、request_id、来源文件。「是否入选」和「理由」两列留空,由读者按自己的需求填写。
先用一条实际职位确认字段映射,再导出整页。每一行至少要有岗位、公司和职位链接。搜索结果只给地区、没给工作模式或发布时间时,这两格留空,审阅时打开职位页面确认后再填。
打开原始 linkedin-jobs-page-0.json,选一条确实包含岗位信息的职位对象,对照原职位页面确认标题、公司与职位链接。把岗位数组的 JSON Pointer 写入 mapping.json 的 rows,把职位对象内部的字段路径写入 fields。指针以 / 开头,数组下标写 /0,字段名里的 ~ 和 / 分别转义为 ~0 与 ~1。title、company、url 必填;location、work_mode、published_at 没有对应数据时设为 null,不能用搜索筛选反推每个岗位的工作模式。
下面只展示映射文件的结构,YOUR_* 是占位路径,不是 BeatAPI 的真实字段。把所有 YOUR_* 换成你核对过的路径:
把下面的脚本存为 export_jobs.py。export_jobs.py 在打开目标文件前校验整个集合;映射错误、必填数据缺失、该填标量的位置是嵌套对象、链接不是职位链接,都会报错。脚本按职位 URL 路径去重,保留同名但链接不同的岗位,防止公式注入,并且不覆盖已有表格。
在表格软件里按公司、地区、工作模式筛选,打开职位链接后填写 shortlist 与 reason 两列。至少抽查两行,对照原始职位对象。空结果只输出表头,不代表“所有公司都没有岗位”。核对 exported_rows 与去重后的实际记录数一致。保留 mapping.json 和源响应,之后修正映射时可以直接重新导出,不必再付费查询。导出过程不申请职位、不联系招聘者,不估算薪酬,也不补造未提供的信息。

