Publora — LinkedIn

Publora API 的 LinkedIn 平台技能。有关认证、核心调度、媒体上传以及工作区（workspace）/Webhook 文档，请参阅 publora 核心技能。

基础 URL： https://api.publora.com/api/v1
请求头（Header）： x-publora-key: sk_YOUR_KEY
平台 ID 格式： linkedin-{profileId}

平台限制（API）

⚠️ API 限制与原生应用不同，请基于这些限制进行设计。

前 210 个字符在“查看更多”之前可见。

常见错误：

• MEDIA_ASSET_PROCESSING_FAILED — 文件过大或格式不被支持
• Error 429 — 超出调用频率限制

发布纯文本动态

await fetch('https://api.publora.com/api/v1/create-post', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },
  body: JSON.stringify({
    content: '很高兴宣布我们最新的产品更新！#buildinpublic',
    platforms: ['linkedin-ABC123']
  })
});

@提及人员与组织

在 content 字段中使用以下语法：

@{urn:li:person:MEMBER_ID|Display Name}       # 人员
@{urn:li:organization:ORG_ID|Company Name}    # 公司

显示名称（Display Name）必须完全匹配 LinkedIn 个人资料中的名称（区分大小写）。

body: JSON.stringify({
  content: '与 @{urn:li:organization:107107343|Creative Content Crafts Inc} 的出色协作！',
  platforms: ['linkedin-ABC123']
})

定时发布动态

body: JSON.stringify({
  content: '您的 LinkedIn 动态内容',
  platforms: ['linkedin-ABC123'],
  scheduledTime: '2026-03-20T09:00:00.000Z'
})

数据分析（Analytics）

动态统计数据（Post Statistics）

⚠️ queryTypes 是一个数组 — 'ALL' 是非法值。若只需获取单个指标，请使用 queryType（字符串类型）；若需多个指标，请使用 queryTypes（数组类型）。二者至少需指定其一。

多个指标查询 — 返回格式为 { metrics: { IMPRESSION: 4521, ... }, cached: bool }：

const res = await fetch('https://api.publora.com/api/v1/linkedin-post-statistics', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },
  body: JSON.stringify({
    postedId: 'urn:li:share:7123456789',   // 或 urn:li:ugcPost:xxx
    platformId: 'linkedin-ABC123',
    queryTypes: ['IMPRESSION', 'MEMBERS_REACHED', 'RESHARE', 'REACTION', 'COMMENT']
  })
});

单个指标查询 — 返回格式为 { count: 4521, cached: bool }：

body: JSON.stringify({
  postedId: 'urn:li:share:7123456789',
  platformId: 'linkedin-ABC123',
  queryType: 'IMPRESSION'   // 单数形式；合法取值：IMPRESSION | MEMBERS_REACHED | RESHARE | REACTION | COMMENT
})

### 账户统计数据（Account Statistics）

```javascript
await fetch('https://api.publora.com/api/v1/linkedin-account-statistics', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },
  body: JSON.stringify({ platformId: 'linkedin-ABC123' })
});

关注者数量与增长趋势（Follower Count & Growth）

await fetch('https://api.publora.com/api/v1/linkedin-followers', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },
  body: JSON.stringify({ platformId: 'linkedin-ABC123' })
});

个人资料概览（Profile Summary，综合汇总）

await fetch('https://api.publora.com/api/v1/linkedin-profile-summary', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },
  body: JSON.stringify({ platformId: 'linkedin-ABC123' })
});

数据分析结果可能需要最多 24 小时才能在发布后完整填充。

互动反应（Reactions）

支持的反应类型：LIKE、PRAISE、EMPATHY、INTEREST、APPRECIATION、ENTERTAINMENT

创建反应

返回 HTTP 201（而非 200）。当发生 URN 转换时，响应中可能包含 urnTranslated: { from, to } 字段。

await fetch('https://api.publora.com/api/v1/linkedin-reactions', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },
  body: JSON.stringify({
    postedId: 'urn:li:ugcPost:7429953213384187904',
    reactionType: 'INTEREST',
    platformId: 'linkedin-ABC123'
  })
});
// 响应示例：{ success: true, reaction: { id: "urn:li:reaction:...", reactionType: "INTEREST" } }

删除反应

响应格式：{ success: true, reaction: null } — 删除操作响应中 reaction 字段始终为 null（不返回被删除的反应类型）。

await fetch('https://api.publora.com/api/v1/linkedin-reactions', {
  method: 'DELETE',
  headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },
  body: JSON.stringify({
    postedId: 'urn:li:ugcPost:7429953213384187904',
    platformId: 'linkedin-ABC123'
  })
});

评论（Comments）

创建评论

返回 HTTP 201（而非 200）。响应格式：{ success: true, comment: { id, commentUrn, message, ... } }

await fetch('https://api.publora.com/api/v1/linkedin-comments', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },
  body: JSON.stringify({
    postedId: 'urn:li:share:7434685316856377344',
    message: '很棒的动态！感谢分享。',  // 最多 1,250 字符
    platformId: 'linkedin-ABC123',
    // parentComment: 'urn:li:comment:(...)' ← 用于嵌套回复
  })
});

删除评论

commentId 可接受完整 URN（如 urn:li:comment:(...)）或纯数字 ID（如 7434695495614312448）。

await fetch('https://api.publora.com/api/v1/linkedin-comments', {
  method: 'DELETE',
  headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },
  body: JSON.stringify({
    postedId: 'urn:li:share:7434685316856377344',
    commentId: 'urn:li:comment:(urn:li:activity:xxx,7434695495614312448)',  // 或简写为：'7434695495614312448'
    platformId: 'linkedin-ABC123'
  })
});

平台特性说明（Platform Quirks）

• API 不支持加粗/斜体 — LinkedIn API 不提供富文本格式支持
• URN 格式说明：通过 Publora 创建的动态 → 使用 /get-post 接口返回的 postedId；外部发布的动态 → 需手动查找 urn:li:share:xxx 或 urn:li:ugcPost:xxx
• WebP 图片 将自动转为 JPEG 格式
• 话题标签（Hashtags） 以纯文本方式输入即可生效，并自动变为可点击链接
• 不支持通过 API 发布自然轮播图（organic carousels） — 仅支持多图网格布局（multi-image grid layout）