LinkedIn

💼 LinkedIn API 一站式代理服务

社交媒体榜 #1

LinkedIn官方API代理网关,支持OAuth托管、内容发布、广告管理和公开数据查询,适合社媒自动化与B2B营销。

收藏
34.2k
安装
10.2k
版本
1.0.1
CLS 安全性认证2026-05-14
点击查看完整报告 >

使用说明

核心用法

LinkedIn Skill 是 Maton 平台提供的官方 API 代理服务,通过单一 Maton API Key 即可调用 LinkedIn 的全部功能,无需自行处理 OAuth 流程。核心能力分为四大模块:

1. 身份与档案管理:通过 /v2/me/v2/userinfo 获取用户基本信息、邮箱、头像等 OpenID Connect 标准字段。

2. 内容发布(UGC Posts):支持纯文本、文章链接、图片、视频等多形态内容发布。图片/视频需经过「注册上传→二进制上传→创建帖子」三步流程。

3. 广告营销 API:完整覆盖广告账户(Ad Accounts)、广告系列组(Campaign Groups)、广告系列(Campaigns)的 CRUD 操作,支持预算管理、投放排期、目标受众定位(31 个维度包括技能、行业、职位、学历、雇主等)。

4. 公开数据查询:Ad Library 和 Job Library 无需用户 OAuth,可直接查询平台公开的广告素材和职位信息,支持关键词、广告主、地域、日期等多维度筛选。

显著优点

  • OAuth 托管:用户无需自建授权服务器,通过 ctrl.maton.ai 可视化界面完成 LinkedIn 账号绑定,支持多账号切换。
  • 协议兼容:自动处理 X-Restli-Protocol-Version: 2.0.0 等 LinkedIn 特有协议头,降低接入门槛。
  • 双版本支持:同时兼容 Legacy UGC API 和现代 REST API(202502 版本),满足不同场景需求。
  • 丰富的代码示例:提供 Bash、Python、JavaScript 完整调用示例,覆盖从认证到发布的全流程。

潜在缺点与局限性

  • 严格的速率限制:成员级别仅 150 请求/天,应用级别 10 万/天,高频自动化场景易触发限流。
  • 三步上传繁琐:图片/视频发布流程复杂,需自行管理 upload URL 有效期和 asset URN。
  • Person ID 隔离:用户 ID 按应用隔离,无法跨应用复用,迁移成本较高。
  • 地域合规风险:Ad Library 等公开数据接口需关注 GDPR 等数据隐私法规的合规使用。

适合人群

  • B2B 营销人员:需批量管理 LinkedIn 企业主页内容、广告投放和数据分析。
  • 招聘科技公司:通过 Job Library 监控竞品职位动态,或同步发布职位信息。
  • 社媒自动化开发者:构建跨平台内容分发工具,降低多账号 OAuth 维护成本。

常规风险

  • 权限泄露w_member_social scope 可删除帖子,需严格控制 API Key 的分发范围。
  • 内容合规:自动化发布若涉及敏感行业(金融、医疗),需遵守 LinkedIn 广告政策避免封号。
  • 数据缓存风险:Profile 图片 URL 会过期,长期缓存可能导致链接失效。

安全解读

核心用法

LinkedIn Skill是Maton平台官方提供的API集成解决方案,通过托管OAuth认证简化LinkedIn企业级功能的调用流程。核心功能覆盖四大模块:

身份与连接管理:通过Maton网关自动注入OAuth令牌,支持多账户连接切换(Maton-Connection头),用户仅需配置MATON_API_KEY环境变量即可调用全部接口。

内容发布(UGC Posts):支持文本、图文、文章链接、视频四种内容类型的程序化发布。发布流程遵循LinkedIn API规范——需先获取person URN(通过/v2/me),再构造符合RESTli协议标准的请求体。媒体上传采用"注册-上传-发布"三步流程,支持图片、视频、PDF文档。

广告管理(Marketing API):完整支持广告账户(Ad Accounts)、广告系列组(Campaign Groups)、广告系列(Campaigns)的三级架构CRUD操作。提供12种营销目标类型(品牌认知、网站访问、线索收集等),支持预算控制、投放排期、受众定位等高级功能。定位系统覆盖31个维度(技能、行业、职级、学历、雇主等)。

公开数据洞察:Ad Library API无需OAuth即可查询广告主公开投放数据,支持按关键词、广告主、国家、时间范围筛选,返回展示量范围、投放周期等竞争情报;Job Library支持职位投放数据分析。

显著优点

1. 认证简化:托管OAuth模式消除了开发者自行维护令牌的复杂度,支持多账户无缝切换
2. 协议兼容:自动处理LinkedIn特有的RESTli 2.0.0协议版本头和版本化API路径(LinkedIn-Version: 202502

3. 功能完整度:覆盖消费者API(分享、资料)与企业级Marketing API(广告、组织分析)双栈

4. 媒体处理现代化:REST API版本的上传端点支持预签名URL直传,比旧版资产注册流程更可靠

5. 竞争情报能力:Ad Library是唯一官方广告透明度接口,支持合规获取竞品投放策略

局限性与注意事项

速率限制严格:成员级配额仅150次/天,企业级批量操作需实施指数退避和请求队列。应用级10万次/天的配额对SaaS产品可能吃紧。

URN格式敏感:所有资源标识符(person、organization、image等)必须严格使用urn:li:{type}:{id}格式,422错误常见源于格式错误。

媒体上传时序复杂:视频/文档上传需等待处理完成才能关联到帖子,实际生产需轮询状态或实现Webhook回调(当前文档未覆盖异步状态查询)。

定位实体编码不透明:Ad Targeting Facet的实体值(如特定技能ID)需通过LinkedIn的typeahead接口预查询,文档未提供实体编码映射表。

组织数据权限壁垒:获取组织帖子、分享统计需组织管理员ACL,普通开发者常遇到403权限不足。

适合人群

  • B2B营销团队:需要批量发布 thought leadership 内容、管理多账号内容日历
  • 广告投放专员:程序化调整Campaign出价、预算、排期,或批量创建A/B测试组
  • 竞争情报分析师:监控行业竞品广告素材、投放时段、受众定向策略
  • HR科技产品:对接Job Library构建职位市场分析工具
  • SaaS集成商:为客户嵌入LinkedIn发布功能,避免自建OAuth基础设施

常规风险

  • OAuth范围过度授权w_member_social权限涉及写入操作,建议最小权限原则,定期审计已授权应用
  • API密钥泄露MATON_API_KEY为Maton平台全局密钥,泄露可能导致所有连接账户被滥用
  • 内容合规风险:自动化发布需配置内容审核流程,避免触发LinkedIn垃圾信息检测
  • 数据驻留:Ad Library数据可能涉及GDPR管辖区域用户信息,分析用途需合规评估

LinkedIn 内容

手动下载zip · 7.8 kB
LICENSE.txttext/plain
请选择文件