Linkedin API

最近有在看 LinkedIn 的 API 文档，在这里记录一下：

用户文章 API

获取用户发布的文章

LinkedIn API 曾经是支持经过用户授权后获取发布的文章的，相关的 OAuth scope 是 r_member_social ，但是 LinkedIn 移除了相关的 scope 和 API，就再也无法获取用户的文章了。

r_member_social is a closed permission

how to get r_member_social permission with linkedIn share api

I need use Share API to get read shares or comments, the documents says I need r_member_social permission, how can I get the permission?

https://stackoverflow.com/a/77059966/1776024

发布文章

需要的 scope w_member_social

Share on LinkedIn - LinkedIn

Learn how to leverage LinkedIn's Share API to share meaningful content to your LinkedIn network.

https://learn.microsoft.com/en-us/linkedin/consumer/integrations/self-serve/share-on-linkedin#creating-a-share-on-linkedin

公司组织 API

获取用户管理的公司组织

Organization Access Control by Role - LinkedIn

Documentation for LinkedIn's APIs controlling access to Organizations

https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-access-control-by-role?view=li-lms-2024-08&tabs=http#find-organization-administrators

处理返回结果的时候要注意下 "state": "APPROVED" 才算是用户有权限管理的公司

获取公司组织详情

Organization Lookup - LinkedIn

LinkedIn API for looking up organizations.

https://learn.microsoft.com/en-us/linkedin/marketing/community-management/organizations/organization-lookup-api?view=li-lms-2024-08&tabs=http#retrieve-an-administered-organization

注意 URL 当中的公司组织 ID 是数字，比如 79988552

获取公司组织文章

需要的 scope r_organization_social

Posts API - LinkedIn

Create and Manage posts

https://learn.microsoft.com/en-us/linkedin/marketing/community-management/shares/posts-api?view=li-lms-2024-08&tabs=curl#find-posts-by-authors

Sample Request

## Get Organization Posts By Organization
curl "https://api.linkedin.com/rest/posts?author=urn%3Ali%3Aorganization%3A104928924&q=author&count=10&sortBy=LAST_MODIFIED" \
     -H 'X-Restli-Protocol-Version: 2.0.0' \
     -H 'Linkedin-Version: 202408' \
     -H 'Authorization: Bearer Token'

OAuth 权限说明

上面那些 API 主要用到下面几个权限

openid email profile w_member_social r_organization_social w_organization_social r_organization_admin

Permission	Description
openid
email
profile
w_member_social	发布用户文章
r_organization_social	获取公司组织的文章
w_organization_social	发布公司组织的文章
r_organization_admin	获取用户管理的公司组织

其他

新版本 API

LinkedIn 在 2022 年的时候将 API 地址从 https://api.linkedin.com/v2/ 变更成了 https://api.linkedin.com/rest/ , 详情如下：

LMS API Documentation Versioning Preview - LinkedIn

LinkedIn API

https://learn.microsoft.com/en-us/linkedin/marketing/versioning?view=li-lms-2024-08#why-are-our-apis-versioned

token 缓存 bug

LinkedIn 的 OAuth token 有个 5 分钟的缓存问题，即使你更换了新的 token，LinkedIn 后端仍然使用旧的 token，新 token 必须等待 5 分钟才能生效。例如，你新 token 添加了一些新的权限，但你请求相关权限 API 时仍然会提示权限不足，过了 5 分钟后就可以成功调用了。

相关链接

LinkedIn API postman

Postman

https://www.postman.com/linkedin-developer-apis/linkedin-marketing-solutions-versioned-apis/collection/5e45ld6/content-apis?ctx=info

官方文档

LinkedIn API Documentation - LinkedIn

Explore LinkedIn API documentation for Compliance, Consumer, Learning, Marketing, Sales, and Talent Solutions

https://learn.microsoft.com/en-us/linkedin/?view=li-lms-2024-08

Developer Apps

Developers | LinkedIn

https://www.linkedin.com/developers/apps

更新历史

• 2024-09-06 首次更新