logo

Himalayas 远程职位采集

从 Himalayas 官方公开接口抓远程职位:职位名、公司、用工类型、薪资区间与周期、职级、地区与时区限制、岗位分类、发布时间、投递链接,并带来源与请求地址便于溯源

发布者
价格
¥0.007 / 条
最近更新
2026-11-18

概览

从 Himalayas 的公开接口抓远程职位,一个职位一行,共 21 列。

数据说明

数据来自 Himalayas 公开的职位接口,按搜索词逐页取。每条记录是一个职位:职位名、公司、用工类型、薪资、职级、地区与时区限制、分类、发布时间与过期时间、投递链接。

几列容易看错:「薪资下限」「薪资上限」为 0、币种与周期为空串,表示公司没有披露,不是「真给 0」。「时区限制」是 UTC 偏移数组(如 [-5, -4, 9.5]),空数组表示不限时区,不是在排除。「地区限制」为空也很常见,含义是没写明地区要求,要结合「是否全球可投」这类筛选条件一起判断。

「公司别名」是 Himalayas 站内的公司短名,和公司名不是一回事,按公司统计时用别名聚合更稳。这一版不含职位描述正文:接口虽然给了摘要与描述,本包没有输出,需要正文请在结果里点开「职位链接」。

覆盖范围只含 Himalayas 公开展示的职位:不含应聘者信息,不代为投递,不绕过登录或付费限制。接口每页固定 20 条,翻页只有页码、没有游标,翻到第 100 页(约第 2000 条)之后再往后没有意义。

结果长什么样

每条记录是一个职位:

职位名称公司名用工类型薪资职级地区限制
Senior Software EngineerExample CompanyFull Time120000 / 150000(yearly)SeniorGermany

此外还有数据来源、来源站首页、实际请求地址、采集时间、职位 GUID、公司别名、币种、时区限制、职位分类与上级分类、发布时间、过期时间、投递链接等列。

应用场景

按国家找可投的岗位,看「地区限制」和「时区限制」:地区为空的多半不限地域,时区数组里包含你所在偏移的才实际可协作;这两列比「工作地点」这类自由文本更靠得住。

判断薪资水平,用「薪资下限」「薪资上限」加「薪资周期」:先剔掉为 0 的记录,再按周期分组比较;同一职位在不同公司的披露比例差别很大,样本少时别急着下结论。

做岗位供给监控,看「发布时间」和「过期时间」:同一个搜索词每周跑一次,新增与下架的数量能反映这个岗位的冷热;过期时间临近的职位说明挂很久了。

筛公司,用「公司别名」:同一个集团常以多个公司名出现,别名能合并;配合「职位分类」可以看出这家公司主要在招什么方向的人。

适用边界

只采集 Himalayas 公开发布的职位信息,不含应聘者个人信息,不代为投递,不绕过登录或付费限制

  • 适合用于
  • 要看某个岗位/技能在海外远程市场的在招情况与薪资分布
  • 按国家、全球可投、职级、用工类型等维度切片,做岗位地图
  • 给求职者做远程岗位清单,保留 Himalayas 原始投递链接
  • 和 Jobicy/RemoteOK 的数据放在一起对比不同平台的岗位供给
  • 不要用于
  • 要岗位的完整职位描述正文(Actor 契约的 21 个字段不含 description,本包严格对齐,所以也没输出;需要的话可以加)
  • 要按公司批量抓某个企业官网的岗位(应走企业的 ATS)
  • 要国内招聘平台的职位

失败处理

开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。

  1. 1报 no-records 时先看是不是筛太多:职级/用工类型/公司别名/时区这四项接口不认,全靠本地筛,一页 20 条很容易筛空
  2. 2每页固定 20 条且只有 page 翻页,没有 cursor;把「最多采集条数」调大或换 page 再试
  3. 3薪资为空是公司没披露(minSalary/maxSalary 记 0,不是真发 0);timezoneRestrictions 为空数组表示不限时区
  4. 4worldwide 与 excludeWorldwide 同时开会直接报 invalid-input;excludeWorldwide 必须配 country

输入参数

调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。

  • 搜索词query选填string
    岗位名、技能或短语,1~120 字,服务端检索。留空按默认 software engineer
    默认值software engineer示例software engineer
  • 国家country选填string
    国家名、代码或别名(如 Germany / DE),服务端过滤。留空=不限国家
    默认值
  • 只要全球职位worldwide选填boolean
    只保留允许全球远程的职位(实测约 240 条),服务端过滤。不能与「排除全球职位」同时开
    默认值false
  • 排除全球职位excludeWorldwide选填boolean
    必须配合「国家」使用:只留明确限定该国、非全球可投的职位
    默认值false
  • 职级seniority选填array<string>
    本地过滤(接口不认这个参数,传了也不生效)。可多选,最多 6 个。留空=不限
    示例[]
  • 用工类型employmentTypes选填array<string>
    本地过滤(接口不认这个参数)。可多选,留空=不限
    示例[]
  • 公司别名companySlugs选填array<string>
    本地过滤,填公司在 Himalayas 的别名(如 linear),最多 10 个。留空=不限
    示例[]
  • 时区timezone选填string
    本地过滤,形如 UTC-5 或 UTC+05:30。填了只会保留时区限制里包含该偏移的职位(没写时区限制的职位不受影响)
    默认值
  • 排序sort选填string(enum)
    服务端排序。relevant 相关度(默认)、recent 最新、salaryAsc 薪资升序、salaryDesc 薪资降序
    可选值相关度relevant最新recent薪资从低到高salaryAsc薪资从高到低salaryDesc公司名 A→ZnameAToZ公司名 Z→AnameZToA按职位jobs默认值relevant
  • 起始页page选填integer
    从第几页开始取(1~100,每页固定 20 条)。翻页靠它,没有 cursor
    范围1–100默认值1
  • 最多采集条数maxItems选填integer
    默认 20(一页的量);填 0 或不填表示按上限 200 连续翻页。职级/类型/公司/时区在本地筛,所以实际条数常少于这个值
    范围0–200默认值20

输出数据

单条记录的字段结构,与 manifest.json 的 output.schema 同源。

  • 数据来源sourcestring
    固定为 Himalayas,用于和其他职位源拼接后区分出处
    示例Himalayas
  • 来源站首页attributionUrlstring
    固定为 https://himalayas.app,按 Himalayas 的署名要求随数据保留
    示例https://himalayas.app
  • 实际请求地址sourceRequestUrlstring
    本次抓取实际发出的接口地址(含全部查询参数),便于复现同一页结果
    示例https://himalayas.app/jobs/api/search?q=software+engineer&sort=recent&page=1
  • 采集时间fetchedAtstring
    抓取时刻,UTC,ISO 8601;同一次运行内所有行相同
    示例2026-11-18T02:00:00Z

示例数据

以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。

output.example
{
  "source": "Himalayas",
  "attributionUrl": "https://himalayas.app",
  "sourceRequestUrl": "https://himalayas.app/jobs/api/search?q=software+engineer&sort=recent&page=1",
  "fetchedAt": "2026-11-18T02:00:00Z",
  "guid": "himalayas-8f2c1d",
  "title": "Senior Software Engineer",
  "companyName": "Example Company",
  "companySlug": "example-company",
  "employmentType": "Full Time",
  "minSalary": 120000,
  "maxSalary": 150000,
  "salaryPeriod": "yearly",
  "currency": "USD",
  "seniority": "[\"Senior\"]",
  "locationRestrictions": "[\"Worldwide\"]",
  "timezoneRestrictions": "[]",
  "categories": "[\"Software Development\"]",
  "parentCategories": "[\"Engineering\"]",
  "publishedAt": "2026-08-25T10:00:00.000Z",
  "expiresAt": "<expiresAt>",
  "applicationLink": "https://himalayas.app/companies/example-company/jobs/senior-software-engineer"
}

调用方式

本 Data App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 Data App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。

通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 Data App。选择你的客户端与认证方式,复制下方配置即可接入。

客户端配置

把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。

mcpServers 配置
{
  "mcpServers": {
    "bazhuayu_datahub": {
      "type": "http",
      "url": "https://mcp-v2.bazhuayu.com?pin=slzc81gz/himalayas-jobs",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

让 AI 自己完成配置

不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。

如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。

价格

每次运行

每提交一次任务计费一次,与返回条数无关。

¥0.077/ 次
按条计费

按实际成功返回的数据条数计费,任务失败不计费。

¥0.007/ 条

多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。

立即体验

填写参数直接运行,结果来自真实调用。

示例
参数按 input.schema 校验后提交
¥0.007 / 条