{
  "spec_version": "0.2",
  "namespace": "SpiderKing999",
  "app_name": "linkedin-position-detail",
  "app_id": "app_ff74fec14246",
  "status": "published",
  "open_to": "public",
  "accepting_runs": true,
  "source_locale": "zh-CN",
  "identity": {
    "app_name": "linkedin-position-detail",
    "name": "领英职位详情",
    "summary": "批量提交 LinkedIn 职位 ID，获取职位、公司、申请与招聘信息明细",
    "type": "data",
    "version": "0.1.0"
  },
  "discovery": {
    "capability": "data-acquisition",
    "keywords": [
      "领英职位",
      "LinkedIn职位详情",
      "职位信息",
      "招聘信息"
    ],
    "boundary": "单次任务提交 1–200 个职位 ID；每个任务项最多返回一条职位详情，未采集到的任务项返回无数据标识。"
  },
  "input": {
    "schema": {
      "type": "object",
      "properties": {
        "items": {
          "type": "array",
          "title": "职位任务清单",
          "description": "一次提交 1–200 个职位任务项；实际返回数量不超过提交数量，未采集到的任务项仍会返回一条带无数据标识的结果。",
          "items": {
            "type": "object",
            "title": "职位任务项",
            "description": "每个任务项填写一个职位 ID；可一次提交 1–200 个任务项。职位 ID 无效或未采集到时，该项会返回空业务字段并以无数据标识。",
            "properties": {
              "kw": {
                "type": "string",
                "title": "职位 ID",
                "description": "LinkedIn 职位 ID，必须填写；优先使用职位页中的数字 ID。",
                "pattern": "^[0-9]{1,20}$"
              }
            },
            "additionalProperties": false
          },
          "minItems": 1,
          "maxItems": 200,
          "prefill": [
            {
              "kw": "4456878340"
            }
          ]
        }
      },
      "required": [
        "items"
      ],
      "additionalProperties": false
    }
  },
  "output": {
    "id_field": "task_item",
    "schema": {
      "type": "object",
      "properties": {
        "application_count": {
          "type": "string",
          "title": "申请人数",
          "description": "职位页面展示的申请人数信息",
          "prefill": "Over 200 applicants"
        },
        "application_type": {
          "type": "string",
          "title": "申请方式",
          "description": "职位申请方式",
          "prefill": "EASY_APPLY"
        },
        "application_url": {
          "type": "string",
          "title": "申请链接",
          "description": "职位申请入口链接",
          "prefill": "https://www.linkedin.com/jobs/view/4456878340"
        },
        "benefits": {
          "type": "string",
          "title": "福利信息",
          "description": "职位页面中的福利描述"
        },
        "company_id": {
          "type": "string",
          "title": "公司 ID",
          "description": "LinkedIn 公司标识",
          "prefill": "1441"
        },
        "company_name": {
          "type": "string",
          "title": "公司名称",
          "description": "发布职位的公司名称",
          "prefill": "Google"
        },
        "company_url": {
          "type": "string",
          "title": "公司主页",
          "description": "公司主页链接",
          "prefill": "https://www.linkedin.com/company/google?trk=public_jobs_topcard-org-name"
        },
        "crawl_time": {
          "type": "string",
          "title": "采集时间",
          "description": "职位详情被采集的时间，按接口返回的 ISO 8601 形态记录",
          "prefill": "2026-10-10T14:59:54"
        },
        "description": {
          "type": "string",
          "title": "职位描述",
          "description": "职位描述纯文本内容；未采集到时为空",
          "prefill": "Applications will be reviewed on a rolling basis and it’s in the candidate’s best interest to apply early."
        },
        "description_html": {
          "type": "string",
          "title": "职位描述 HTML",
          "description": "职位描述的 HTML 内容；未采集到时为空",
          "prefill": "<div class=\"description__text description__text--rich\">…</div>"
        },
        "experience_level": {
          "type": "string",
          "title": "经验要求",
          "description": "职位经验级别",
          "prefill": "Internship"
        },
        "industry": {
          "type": "string",
          "title": "所属行业",
          "description": "职位所属行业",
          "prefill": "Information Services and Technology, Information and Internet"
        },
        "job_function": {
          "type": "string",
          "title": "职能类别",
          "description": "职位职能类别；未采集到时为空"
        },
        "job_id": {
          "type": "string",
          "title": "职位 ID",
          "description": "结果中的 LinkedIn 职位 ID",
          "prefill": "4456878340"
        },
        "job_title": {
          "type": "string",
          "title": "职位标题",
          "description": "职位名称",
          "prefill": "Research Intern, PhD, Summer 2027"
        },
        "job_type": {
          "type": "string",
          "title": "工作类型",
          "description": "职位工作类型",
          "prefill": "Internship"
        },
        "job_url": {
          "type": "string",
          "title": "职位链接",
          "description": "LinkedIn 职位页面链接",
          "prefill": "https://www.linkedin.com/jobs/view/4456878340"
        },
        "keyword": {
          "type": "string",
          "title": "搜索关键词",
          "description": "该职位任务使用的搜索关键词",
          "prefill": "python engineer"
        },
        "location": {
          "type": "string",
          "title": "工作地点",
          "description": "职位工作地点",
          "prefill": "Mountain View, CA"
        },
        "publish_time": {
          "type": "string",
          "title": "发布时间",
          "description": "职位发布时间，按接口返回的 ISO 8601 形态记录",
          "prefill": "2026-09-10T14:59:54"
        },
        "raw_publish_time": {
          "type": "string",
          "title": "原始发布时间",
          "description": "职位页面展示的原始发布时间文本",
          "prefill": "1 month ago"
        },
        "recruiter_name": {
          "type": "string",
          "title": "招聘者姓名",
          "description": "职位页面中的招聘者姓名；未采集到时为空"
        },
        "recruiter_profile_url": {
          "type": "string",
          "title": "招聘者主页",
          "description": "招聘者个人主页链接；未采集到时为空"
        },
        "salary": {
          "type": "string",
          "title": "薪资信息",
          "description": "职位页面中的薪资信息；未采集到时为空"
        },
        "task_item": {
          "type": "string",
          "title": "任务项 ID",
          "description": "对应提交任务项的职位 ID；无数据结果也会保留该标识。",
          "prefill": "4456878340"
        },
        "no_data": {
          "type": "boolean",
          "title": "无数据标识",
          "description": "为真表示该职位任务项已完成但没有采集到职位详情。",
          "prefill": false
        }
      },
      "required": [],
      "additionalProperties": false
    }
  },
  "execution": {
    "mode": "async",
    "timeout_seconds": 900,
    "cancel_notify": false,
    "recovers_partial_on_cancel": false
  },
  "knowledge": {
    "when_to_use": [
      "需要批量获取 LinkedIn 公开职位的职位标题、公司、地点、描述和申请信息",
      "需要把多个职位任务项的结果统一整理成表格进行招聘市场或岗位对比分析"
    ],
    "when_not_to_use": [
      "只需要即时查询单个职位且不需要异步任务处理时"
    ],
    "failure_handling": [
      "任务进入失败或过期状态时，检查职位 ID 后重新提交；不要重复提交同一批次以避免产生重复任务",
      "无数据标识为真表示该职位项已完成但没有可返回的职位详情，应与真实职位记录区分处理"
    ]
  },
  "pricing": {
    "events": [
      {
        "event": "start",
        "label": "提交一次职位详情任务",
        "unit_price": 0.001,
        "qty_from": "",
        "unit_size": null
      },
      {
        "event": "record",
        "label": "返回一条职位结果",
        "unit_price": 0.012,
        "qty_from": "",
        "unit_size": 1
      }
    ]
  },
  "examples": [
    {
      "id": "basic",
      "goal": "获取一个 LinkedIn 职位的详情",
      "input": {
        "items": [
          {
            "kw": "4456878340"
          }
        ]
      },
      "use_as_test": true
    }
  ],
  "published_at": "2026-10-12T03:28:11.293109+00:00",
  "publisher": {
    "id": "SpiderKing999",
    "name": "SpiderKing999"
  },
  "maintainers": [
    {
      "id": "SpiderKing999",
      "name": "SpiderKing999"
    }
  ],
  "trust_tier": "community",
  "readme": "LinkedIn 职位详情数据把公开职位页面中的岗位信息、公司信息、申请信息和招聘者信息整理到一张可分析的结果表中。对于需要同时比较多个职位、识别岗位画像或持续沉淀招聘市场样本的团队，这些字段可以作为统一的基础数据。\r\n\r\n每个职位任务项都会对应一个结果项。即使某个职位暂时没有采集到详情，也会保留对应的任务项标识并给出无数据标识，方便区分“没有结果”和“任务遗漏”。\r\n\r\n## 数据说明\r\n\r\n数据覆盖 LinkedIn 公开职位页面中可获得的职位、公司、地点、描述、申请、薪资和招聘者信息。每个职位任务项最多对应一条职位详情；结果中的公司信息、申请信息和招聘者信息来自该职位页面在采集时可见的内容。职位描述同时提供纯文本和 HTML 形态，便于阅读或保留原始排版。时间字段按返回值保留 ISO 8601 形式；接口没有进一步说明具体时区，因此使用时应结合原始数据环境判断。\r\n\r\n部分职位页面可能缺少薪资、福利、招聘者或职能信息，这些字段会为空。已下架、受限或无法公开访问的职位可能只有任务项标识和无数据标识。\r\n\r\n## 结果长什么样\r\n\r\n每条记录代表一个职位任务项对应的 LinkedIn 职位详情；无数据项也会保留任务项 ID，便于批量核对。\r\n\r\n| 职位 ID | 职位标题 | 公司名称 | 工作地点 | 工作类型 | 无数据标识 |\r\n|---|---|---|---|---|---|\r\n| 4456878340 | Research Intern, PhD, Summer 2027 | Google | Mountain View, CA | Internship | 否 |\r\n\r\n## 应用场景\r\n\r\n- 用职位标题、经验要求、工作类型和地点汇总岗位画像，比较不同职位的招聘要求。\r\n- 用公司名称、公司 ID、所属行业和职位链接整理目标公司的公开招聘分布。\r\n- 用职位描述、职位描述 HTML 和薪资信息提取技能要求、福利线索与薪资披露情况。\r\n- 用申请人数、发布时间、原始发布时间和无数据标识分析职位热度及数据覆盖情况。\r\n",
  "favorite_count": 0,
  "labels": {
    "industry": [
      {
        "slug": "jobs_talent",
        "label": "招聘人才"
      }
    ],
    "platform": [
      {
        "slug": "linkedin",
        "label": "LinkedIn"
      }
    ],
    "content": [
      {
        "slug": "job",
        "label": "职位"
      }
    ]
  },
  "display_locale": "zh-CN",
  "translation_origin": null,
  "version": "0.1.0"
}