linkedin-realtime-jobs

Real-time LinkedIn job search — jobs appear within minutes of posting, before Google-for-Jobs-indexed aggregators and hourly-refresh databases can see them. Pure LinkedIn, structured minutesAgo freshness. Free tier shows the 3 freshest real-time jobs; PRO unlocks the full sub-day firehose.

原始信息汇总

数据集概述：LinkedIn Realtime Jobs

该数据集提供实时 LinkedIn 职位信息，通过直接抓取 LinkedIn 访客搜索页面获取数据，职位在发布后几分钟内即可出现在数据集中，速度优于依赖 Google for Jobs 索引（延迟 15 分钟至数小时）或每小时刷新（最多 60 分钟盲区）的聚合器和数据库。

核心特性

• 结构化新鲜度：每个职位返回原始文本 posted、ISO 8601 格式的 postedAt 以及整数形式的 minutesAgo，支持按最新排序、筛选“刚刚发布”的职位，以及构建实时提醒。
• 透明限制：API 响应的 meta 字段始终包含 freshnessRestricted、excludedFresh 和 upgradeNote，清晰显示配额限制，不会静默返回空结果。

免费版（BASIC）与付费版（PRO）功能对比

• 免费版 (BASIC)：可搜索1 天前及更早的全部职位，并提供过去 24 小时内最新发布的 3 个职位作为预览。其余当天内发布的职位被隐藏。
• 付费版 (PRO)：无限制访问所有当天内发布的职位，即完整的实时数据流。此外，/api/recent 端点（用于毫秒级新鲜度的快速通道）仅限 PRO 级别使用。

可用端点

• POST /api/search：按技能（最多 5 个）、地点、工作类型（现场/远程/混合）、发布时间窗口搜索职位。可通过可选参数 enrich 获取每个职位的详细信息（描述、EasyApply 状态、资历级别、雇佣类型、职位职能、行业、申请链接）。
• POST /api/recent：获取最近 N 分钟内发布的职位，为搜索卡级别信息，响应时间低于 1 秒。仅限 PRO 使用。
• GET /api/health：检查服务覆盖率和运行状态。
• GET /api/docs：获取机器可读的元数据。

应用场景

• 首发求职提醒
• 招聘人员寻源工具
• Discord/Slack 职位推送机器人
• “谁在招聘”仪表板
• 离职再就业通知

数据说明

• 数据来源于公共 LinkedIn 访客页面。
• 部分详情字段在不可用时可能为 null，使用者需设计处理空值的逻辑。