LinkedIn Posts
공개 LinkedIn 게시물은 작성자의 메시지에 미디어, 게시 정보, 해시태그, 콘텐츠 유형, 공개된 좋아요·댓글·리포스트 수가 결합된 형태입니다. 이러한 신호는 콘텐츠 아카이빙, 주제·형식 조사, 선택한 게시물 간의 공개 참여도 비교에 활용할 수 있습니다.
LinkedIn Posts API 주요 기능
- 지원되는 LinkedIn 게시물 URL공개 /posts/ 및 /pulse/ 링크와 activity 또는 share 식별자를 포함한 /feed/update/ URL을 처리합니다.
- 게시물 텍스트와 작성자 정보공개 게시물 텍스트, 원본 URL, 정규화된 작성자 정보를 하나의 콘텐츠 레코드에 연결해 유지합니다.
- 미디어와 게시 정보사용 가능한 미디어 참조, 게시 시각, 제목, 헤드라인, 게시물 유형, 해시태그를 게시물 텍스트에 합치지 않고 따로 반환합니다.
- 공개된 참여 지표사용 가능한 좋아요, 댓글, 리포스트 수를 게시물 레코드마다 별도 지표로 반환합니다.
LinkedIn Posts API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | /posts/, /pulse/ 또는 지원되는 /feed/update/urn:li:activity, /feed/update/urn:li:share 경로를 사용하는 공개 LinkedIn 게시물 URL의 목록으로, 필수 값입니다. |
LinkedIn Posts API 사용 방법
보존하려는 게시물을 정확히 지정하고, 처리 작업을 따라간 뒤, 구조화된 콘텐츠 결과를 읽습니다.
- 각 공개 링크가 /posts/, /pulse/ 또는 지원되는 /feed/update/ URN을 사용하는지 확인합니다.
- 링크를 urls로 /v1/linkedin/posts에 제출하고, task_id를 저장합니다.
- 게시물 처리가 성공하거나 실패를 반환할 때까지 /v1/tasks/{task_id}를 확인합니다.
- 첫 번째 data.results.items를 읽은 뒤, has_more가 true인 동안 next_cursor로 다음 페이지로 넘어갑니다.
curl -X POST "https://api.socq.ai/v1/linkedin/posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/posts/microsoft_were-more-than-a-single-story-at-microsoft-activity-7401349457478569985-pp34"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueLinkedIn Posts API 추천 활용 사례
- 캠페인 콘텐츠 아카이빙: 정해 둔 캠페인 게시물의 텍스트, 작성자, 미디어, 게시 시각, 원본 URL을 보존합니다.
- 주제·메시지 조사: 게시물 텍스트, 헤드라인, 해시태그를 분석해 선택한 LinkedIn 콘텐츠의 주제를 비교합니다.
- 콘텐츠 형식 분석: post_type과 미디어 필드를 활용해 선택한 콘텐츠에 나타나는 형식을 비교합니다.
- 공개 참여도 비교: 저장해 둔 게시물 중 선택한 집합의 공개된 좋아요, 댓글, 리포스트 수를 비교합니다.
LinkedIn Posts API 활용 팁
- 하위 레코드를 원래 입력까지 추적할 수 있어야 한다면, 제출한 URL을 반환된 url 옆에 함께 보관하세요.
- 게시물 링크 집합을 처리하기 전에는 URL 문자열 전체만이 아니라 activity 또는 share 식별자를 기준으로 중복을 제거하세요.
- 모든 공개 게시물에 미디어, 해시태그, 제목, 헤드라인, 게시물 유형이 있는 것은 아니므로 이 값들은 선택 사항으로 취급하세요.
- 같은 게시물도 이후 실행에서 수치가 달라질 수 있으니, 공개된 참여 지표와 함께 collected_at을 보관하세요.
- 반환된 게시물 텍스트를 하위 애플리케이션에서 HTML로 렌더링하기 전에 이스케이프하거나 정화하세요.
관련 API
LinkedIn Posts API 외에 LinkedIn의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- LinkedIn Profiles API — 프로필 URL에서 공개 프로필 정보, 직무, 위치, 공개된 오디언스 수, 경력, 학력, 스킬을 정규화합니다.
- LinkedIn Companies API — 공개 회사 소개, 웹사이트, 로고, 공개된 팔로워 및 직원 수, 산업, 위치, 전문 분야를 정규화합니다.
- LinkedIn Company Posts API — LinkedIn 회사 페이지 URL에서 공개 게시물을 찾으며, 텍스트, 작성자 맥락, 미디어, 해시태그, 타임스탬프, 공개된 참여도를 포함합니다.
- LinkedIn Post Comments API — 알고 있는 LinkedIn 게시물에 노출된 공개 댓글을 수집하며, 텍스트, 작성자 맥락, 타임스탬프, 관계 ID, 공개된 좋아요 및 답글 수를 포함합니다.
- LinkedIn Profile Posts API — LinkedIn 프로필 URL과 연결된 공개 게시물을 찾으며, 작성자 맥락, 미디어, 해시태그, 타임스탬프, 공개된 참여도를 포함합니다.
- LinkedIn Video Transcript API — 동영상이 담긴 게시물 URL로 LinkedIn 동영상의 자막을 일반 텍스트로 변환합니다.