调用LinkedIn API发贴后外部URL缩略图不显示，Post Inspector可正常加载

调用LinkedIn API发布包含外部文章链接的帖子后，链接对应的缩略图始终无法加载，但Post Inspector工具能够正常识别并显示该缩略图。测试所用链接为CNBC的一篇文章，同时尝试过YouTube、StackOverflow等不同域名的链接，问题均存在。

已尝试的解决方法：

• 在URL末尾添加额外参数清除LinkedIn缓存
• 使用Post Inspector工具检测
• 查阅相关资料未找到有效方案
• 确认目标页面包含完整的Open Graph（OG）meta标签

API请求示例（基于官方文档）：

{
    "author": "urn:li:person:{ID}",
    "lifecycleState": "PUBLISHED",
    "specificContent": {
        "com.linkedin.ugc.ShareContent": {
            "shareCommentary": {
                "text": "Learning more about LinkedIn by reading the LinkedIn Blog!"
            },
            "shareMediaCategory": "ARTICLE",
            "media": [
                {
                    "status": "READY",
                    "description": {
                        "text": "Official LinkedIn Blog - Your source for insights and information about LinkedIn."
                    },
                    "originalUrl": "https://www.cnbc.com/2022/10/28/more-than-40percent-of-us-households-will-owe-no-federal-income-tax-for-2022.html",
                    "title": {
                        "text": "Official LinkedIn Blog"
                    }
                }
            ]
        }
    },
    "visibility": {
        "com.linkedin.ugc.MemberNetworkVisibility": "PUBLIC"
    }
}

可行解决建议 #

1. 手动指定缩略图URL #

在API请求的media对象中添加thumbnails字段，直接传入从Post Inspector获取的缩略图URL，强制LinkedIn使用该图片，绕过自动抓取逻辑。修改后的请求示例：

{
    "author": "urn:li:person:{ID}",
    "lifecycleState": "PUBLISHED",
    "specificContent": {
        "com.linkedin.ugc.ShareContent": {
            "shareCommentary": {
                "text": "Learning more about LinkedIn by reading the LinkedIn Blog!"
            },
            "shareMediaCategory": "ARTICLE",
            "media": [
                {
                    "status": "READY",
                    "description": {
                        "text": "Official LinkedIn Blog - Your source for insights and information about LinkedIn."
                    },
                    "originalUrl": "https://www.cnbc.com/2022/10/28/more-than-40percent-of-us-households-will-owe-no-federal-income-tax-for-2022.html",
                    "title": {
                        "text": "Official LinkedIn Blog"
                    },
                    "thumbnails": [
                        {
                            "resolvedUrl": "替换为Post Inspector中显示的缩略图URL"
                        }
                    ]
                }
            ]
        }
    },
    "visibility": {
        "com.linkedin.ugc.MemberNetworkVisibility": "PUBLIC"
    }
}

2. 检查API权限与版本 #

确保你的应用已获得w_member_social权限，并且使用的是v2版本的UGC Post API。旧版API可能存在媒体抓取的兼容性问题，建议升级到最新稳定版。

3. 触发二次抓取机制 #

将帖子先以DRAFT状态保存，间隔数分钟后再更新为PUBLISHED状态；或者在发布帖子后，用Post Inspector重新检测该帖子的链接，强制LinkedIn重新抓取媒体资源。

4. 验证OG标签细节 #

即使页面存在OG标签，也需确认以下细节：

• og:image必须是绝对路径URL，且无防盗链限制（直接在浏览器中打开该URL能正常显示图片）
• 图片尺寸建议符合LinkedIn要求：至少1200x627像素，比例接近1.91:1
• 目标页面的robots.txt未禁止LinkedInBot抓取内容

内容的提问来源于stack exchange，提问作者Caio Chami