领英 LinkedIn 数据 API

name 姓名关键词为必填项，可用 current_company、past_company、title、geocode_location、school、industry 或 profile_language 进一步筛选。公司、地区等部分条件接受逗号分隔的 ID。已验证的成功响应包含 id、urn、public_identifier、full_name、title、location、url、avatar 和资料标记，并提供 page、total、has_more。选中结果后，用 public_identifier 查询个人资料；仅姓名相同不能确认是同一个人。

传入 LinkedIn /in/ 个人主页链接中的公开用户名，不要传完整 URL 或展示姓名。已验证的成功查询返回 data.id、urn、public_identifier、full_name、headline、location、avatar、cover、资料标记、网站和语言地区字段。可选的 include_* 布尔参数用于追加资料分项，可能增加请求消耗。无法访问或不存在的主页曾返回 HTTP 200、success:false、data:null 和 status_code:403，早期 HTTP 202 响应也出现过业务失败。读取 data 前务必检查 success 与 message。

通过公开用户名读取可获取的职业联系信息。文档中的 data 对象含 first_name、last_name、public_identifier、urn、email、phone_numbers、websites、twitter、address 和 wechat，部分字段可能为 null 或空数组。字段可用性因资料而异；返回邮箱不代表地址已验证，也不表示号主同意被联系。仅在经过授权与同意管理的流程中使用许可范围内的字段，并落实适当的保存期限与删除管理。

传入 username 获取仅包含数量的受众信息。文档中的常规 success/message 响应在 data 下提供 follower_count 和 connection_count，不包含关注者或人脉名单、关系明细与历史增长。若参与创作者需要趋势报告，应由应用自行保存带日期的观察记录。

使用个人资料查询返回的 urn 获取账号背景时间信息。文档中的 data 含 joined、profile_photo 和 contact_information，值为可读的日期或相对时间文字。这里对应“关于此个人资料”，不是职业简介，也不能证明身份。值可能采用相对时间表述，应保留原文，不要自行转换为没有依据的精确时间戳。

输入 username，为有权限的审核流程获取个人资料 PDF。文档中的成功响应是以 %PDF 开头的 PDF 文档，不是常规 JSON success/data 对象。应按文件处理返回的文档载荷，不要假定能从 JSON 中解析个人资料字段。文档示例只能说明存在文档响应形式，不保证每个账号都可下载，也不保证导出文件包含当前全部资料分项。

company 可填写公司名称或公开主页短名，也可改用数字 company_id。两项至少提供一项；由于是替代输入，两者各自标记为可选。已验证的 Google 查询返回 data.id、name、universal_name、description、linkedin_url、website_url、active、employee_count、employee_count_range、follower_count、headquarter、locations、industries、specialities、logo 和 cover。人数仅为公司资料中报告的数值，不是经核实的实际雇员数。使用 company_id 可能增加请求消耗；遇到限流或不可访问结果时检查业务状态。

使用 company_id 与 page 查询可获取的公司关联人员摘要。文档中的 data 数组包含 full_name、title、location、services、is_premium 和可选头像信息；部分条目的姓名为 LinkedIn Member，id、url、urn 均为 null。响应附带 page、total、has_more。应保留匿名记录和空标识；这不是保证完整或经过核实的员工花名册。

输入 company_id 查询可获取的关联主页或展示主页。文档中的 data 数组包含 id、name、type、universal_name、linkedin_url、speciality、follower_count，以及带尺寸和过期信息的 logo 变体。与母公司关联时应保留主页类型；展示主页不一定是独立法人实体。

使用 company_id 查询关联成员的聚合分类。文档中的 data 数组由 title 与 insights 组成，每条 insight 含 name 和 count。示例分类包括地区、学校、当前职能、明确列出的技能及服务类别。这些是资料关联分布，不是经过核实的人事统计。分类可能重叠，尤其是地理区域，不能将各项计数相加当成员工总数。

keyword 为必填项，可叠加 geocode、公司 ID、date_posted、remote、experience_level、job_type 等筛选。已验证的首页响应包含 25 条 data 记录，字段有 id、title、url、listed_at、location、is_easy_apply、is_promote，以及含 id、name、url、verified、logo 的 company 对象。响应还提供 page、total、has_more 和回显关键词、地区条件的 metadata。按页读取，用岗位 id 去重，并根据返回的续页信号停止；报告的 total 不保证所有职位都可取回。

使用职位搜索或企业职位结果中的 job_id。文档中的 data 对象含 id、title、description、company、country_code、location、location_geocode、employment_status、level、listed_at、expire_at、job_url、workplace_types、work_remote_allowed 及薪资信息。include_skills 可请求附加技能，可能增加请求消耗。salary 对象含 salary_exists，不一定提供可用薪资区间。本接口仅查询岗位，不提交求职申请。

传入 company_id，可选 page。用 date_posted、remote、experience_level、job_type 及布尔筛选收窄该公司的职位列表。文档响应包含岗位 id、title、url、listed_at、location、is_easy_apply、is_promote、company 信息，以及 page、total、has_more、metadata.companyId。这是限定雇主的岗位读取，不会投递申请，也不保证覆盖企业全部空缺。

输入 company_id 获取该公司报告的岗位数量。文档 JSON 响应包含 success、message、process_time、cost 和 data.total。这个仅返回数量的接口不提供职位条目或内置历史。跨时点比较时应自行保存采集时间，不要将职位数量的变化等同于实际录用人数变化。

使用个人资料 urn 与可选 page 查询可获取的工作经历。文档中的 data 数组包含 title、employment_type、date.start、date.end，以及含 id、name、url、logo 的 company 对象。响应附带 page、total、has_more。应保留返回的日期措辞和缺失值；主页上的任职记录是个人填报的职业背景，不是经过独立核实的雇佣记录。

传入个人资料 urn 与 page 查询可获取的教育记录。文档中的 data 数组包含 school、degree、date.start 和 date.end，数组外提供 page、total、has_more。这些字段是可编辑、由个人填报的教育背景，不验证就读、毕业或学校认证情况。

使用个人资料 urn 与可选 page 读取可获取的技能列表。文档中的条目包含 skill、num_endorsements，并提供 page、total、has_more。这些是主页列出的技能及认可次数，不是标准化能力测评。应用中应提供可编辑、需人工审阅的技能清单，不将其直接作为自动招聘资格判定。

使用选中个人资料的 urn 与可选 page 读取可获取的资质条目。文档中的 data 记录包含 title、authority、issued_at、credential_url，并有 page、total、has_more。主页列出的证书不是独立验证结果，也不一定仍有效；在可用时，通过返回的 credential_url 进行适当的颁发机构核验或人工核对。

使用个人资料 urn 与可选 page 查询可获取的荣誉奖项。文档中的 data 数组含 title、issued_by、issued_at、associated_with，并附 page、total、has_more。这些条目描述主页列出的荣誉，不独立证明奖项确已授予，也不建立权威排名。

输入个人资料 urn 与可选 page 读取可获取的出版物记录。文档中的 data 数组含 title、publication、publication_url、description、date，page、total、has_more 描述后续分页。这是个人主页的出版物分项，不是完整的学术引文索引，也不保证作品经过同行评审。

使用个人资料 urn 与可选 page 查询可获取的志愿经历。文档中的 data 数组含 title、organization、cause、description、duration、date.start、date.end，以及 page、total、has_more。志愿服务议题可能涉及敏感背景。用途应限于用户同意的作品集或社区贡献展示，避免敏感兴趣画像和自动化雇佣决策。

传入 urn、可选 page，以及 type=received 或 given。有续页数据时可传 pagination_cursor。文档中的 data 数组包含 date、text、type 和推荐者资料背景，包括姓名、description、public_identifier、url、avatar；示例还提供 page、total、has_more。推荐语是主页文字，不是独立核实的证明人意见；应保留实际 type，不能假定所有记录都是收到的推荐。

传入个人资料 urn 与可选 page，查询可获取的公司关注条目。文档中的 data 数组包含 id、title、url、follower_count、logo。分页使用 page、total 和驼峰形式的 hasMore。关注公司不能证明任职、购买意向或同意被联系，仅应在具备适当治理的职业兴趣流程中使用。

使用 urn 与可选 page 查询可获取的群组兴趣条目。文档中的 data 数组包含 id、title、url、member_count、logo，并提供 page、total、hasMore。返回的群组 ID 可用于进一步查询群组资料，但兴趣条目不授予成员身份，也不提供私密讨论访问权。

keyword 为必填项，可配合 page、sort_by、date_posted、content_type、from_company、from_member。文档记录包含 id、title、url、created_at、author 和互动数量，以及 page、total、has_more。帖子日期的最近 24 小时选项是 past_24h，不同于招聘接口的 past_24_hours。如需更完整正文或附件信息，应单独查询选中帖子的详情。

传入 post_id 查询选中帖子。文档中的 data 对象含 id、text、created_at、url、author、content、activity。content 内是可能为 null 的格式专属附件字段；activity 含 num_comments、num_likes、num_shares、reaction_counts。这些是查询时观察到的互动值，不是展示量、触达人数、情绪分析或内置历史序列。

传入 company_id、可选 page 和 sort_by=top 或 recent。文档中的 data 数组含帖子 id、text、created_at、url、share_urn、author、content、activity，以及 page、total、has_more。author 描述公司主页，各帖子的附件和反应数量可用性不同。文档默认排序为 top，需要按时间监测时应明确选择 recent。

使用个人资料 urn、可选 page 和 pagination_cursor。文档中的 data 数组含 id、text、created_at、url、share_urn、author、content、activity，响应还包含 page、pagination_token。将返回的 pagination_token 填入公开参数 pagination_cursor 以继续读取。此示例没有建立企业帖子那样的 has_more/total 约定，不要假设各动态列表的分页方式相同。

提供个人资料 urn、可选 page、pagination_cursor，读取可获取的评论动态。文档条目含 comment、created_at、is_edited、urn、activity，以及带自身 id、text、author、content、url 的关联 post 对象。响应提供 page、pagination_token。个人发表的评论动态与关联帖子下的完整评论区应分开处理。

使用个人资料 urn 与可选 page 或 pagination_cursor，读取可获取的已互动帖子记录。文档条目含 reaction_type 及嵌套 post，后者含 id、text、url、author、content、created_at、activity。响应提供 page、pagination_token。反应只是互动记录，不是联系许可，也不能可靠证明敏感兴趣。

传入个人资料 urn 与可选 page、pagination_cursor。文档中的 data 数组包含 id、created_at、url，以及带媒体变体、尺寸和过期信息的 images。响应提供 page、pagination_token。这些是可用的图片帖子记录，不是个人头像接口，也不保证媒体 URL 永久有效。

使用 urn 与可选 page 或 pagination_cursor，查询可用视频帖子记录。文档条目含 id、created_at、duration、thumbnail、url 和互动计数，示例中的 duration 为字符串。page、pagination_token 用于续页。文档没有证明提供视频下载、观看时长或展示量分析。

传入 post_id，可选 post_type、page、sort_order。文档条目含 id、urn、comment、commenter、created_at、num_replies、replies、previous_replies_token、reaction_counts，以及编辑、置顶或作者标记。page、total、has_more 描述评论页。如需另行获取更多回复，应保留父评论 ID 和返回的回复续页数据。

提供 post_id、comment_id，以及从父评论 previous_replies_token 复制的 replies_cursor，三项均为必填。游标是线程续页数据，不是账号登录令牌。文档中的 data 数组含 comment、commenter、created_at、urn、num_replies、reaction_counts，以及编辑、置顶或作者标记，并附 page、total、has_more。应将回复归到来源父评论，不要合并无关讨论线程。

使用 post_id、可选 page 和 type 查询可获取的反应记录。type 支持 all、like、praise、empathy、appreciation、interest。文档条目含 reaction_type，以及含 id、name、description、url、urn、avatar 的 user 背景，并提供 page、total、has_more。反应记录不授予联系对方的许可，也不能证明购买意向。

使用 post_id、可选 page 与 pagination_cursor。文档条目包含 id、author、activity、is_repost_quote、text、created_at，其中 text 与 created_at 可能为 null。列表附带 page、total、has_more、pagination_token，续页时将返回的 pagination_token 传入 pagination_cursor。这里只提供可获取的转发记录，不是完整传播网络，也不能证明每次转发均有评论文字。

keyword 与 advertiser_name 至少提供一项，虽然两项分别标记为可选。可加 country、date、pagination_cursor 缩小范围或续页。文档中的 data 数组包含 id、ad_url、advertiser、content_preview、image，并有 has_more、pagination_token。通过 pagination_cursor 回传返回的 pagination_token。这些记录用于创意研究，不提供花费、定向、触达或转化衡量。

传入广告库搜索得到的 ad_id。文档中的 data 对象含 id、ad_type、ad_url、content、image、advertiser、publisher、paid_for_by，示例中的 advertiser 与 publisher 含 name、url。广告主、发布方、付款方应分别保存；结果是可用创意记录，不是广告账户报告，也不能证明花费或转化。

传入 group_id 查询可获取的群组资料。文档中的 data 对象含 id、urn、name、description、industries、member_count、is_public、is_active、created_at、activity、rules、post_approval_enabled、owners、logo、cover。能读取资料不等于成员身份，也不代表可以查看私密帖子。请使用应用已知或已适当选择的群组标识。

使用 group_id 与可选 page 查询可获取的群组讨论。文档中的 data 数组包含帖子 id、text、created_at、url、share_urn、author、content、activity，page、total、has_more 描述续页。部分附件字段可能为 null。可用范围以实际响应为准，不代表可以访问私密群组或全部历史讨论。

keyword 接受城市或国家等可读名称。文档 JSON 响应含 success、message、process_time，以及含 location、geocode 的 data 条目。应从可能的匹配项中确认目标地点后再使用代码。职位搜索的参数是 geocode，人才搜索的地区参数是 geocode_location，不要用展示名称代替代码。

使用 keyword 与可选 page 查找学校记录。文档中的 data 数组含 id、name、universal_name、location、students、url、logo，并有 page、total、has_more。确认匹配学校后，再将其 ID 用作人才搜索的 school 条件。示例中的 students 是展示字符串，不是经过核实的在校人数。

输入行业 keyword 获取可用行业建议。文档响应包含带 name、industry_id 的 data 记录，以及 success、message、process_time、cost。选中 ID 在人才搜索中作为 industry，在职位搜索中作为 industry_ids。本查询本身不返回公司、人员或岗位，也没有约定分页列表。