LinkedIn Post Comments
LinkedIn 게시물 댓글은 알고 있는 게시물 하나에 달린 공개 반응이며, 이 엔드포인트는 해당 게시물과 함께 노출되는 댓글을 텍스트, 공개 작성자 필드, 게시·수집 시각, 원본 관계, 좋아요 수, 답글 수를 담은 개별 레코드로 변환합니다. 반환 순서는 원본에 따라 달라지며, 답글 수가 보인다고 해서 답글 본문까지 포함된 것은 아닙니다.
LinkedIn Post Comments API 주요 기능
- 알고 있는 게시물 하나를 기준으로지원되는 /posts/, /pulse/, /feed/update/ URL 하나를 받아, 바로 그 게시물과 함께 노출되는 공개 댓글을 조회합니다.
- 정규화된 댓글 레코드댓글 텍스트와 함께 사용 가능한 ID, 공개 URL, 게시 시각, 수집 시각, 공개 작성자 필드를 안정적인 댓글 스키마로 반환합니다.
- 사용 가능한 관계 정보원본이 제공하면 parent_id와 post_id를 보존하고, 제공하지 않으면 선언된 해당 필드를 null로 둡니다.
- 공개된 반응 카운터likes_count와 replies_count를 null 허용 측정값으로 유지하며, 확인할 수 없는 카운터를 0으로 바꾸지 않습니다.
LinkedIn Post Comments API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
url | 필수 | /posts/, /pulse/, /feed/update/urn:li:activity 또는 /feed/update/urn:li:share를 사용하는 공개 LinkedIn 게시물 URL로, 필수 값입니다. |
LinkedIn Post Comments API 사용 방법
지원되는 공개 게시물 URL을 제출하고, 비동기 작업을 따라간 뒤, 완료된 작업에 저장된 댓글을 페이지 단위로 읽습니다.
- 경로가 /posts/, /pulse/ 또는 activity나 share URN이 포함된 /feed/update/인 공개 LinkedIn URL 하나를 고릅니다.
- 해당 URL을 url로 /v1/linkedin/post-comments에 보내고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패를 반환할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽고 has_more가 true인 동안 next_cursor를 따라가세요. 이 커서는 저장된 SocQ 결과를 넘기는 것이며, LinkedIn 원본 댓글 피드를 넘기는 것이 아닙니다.
curl -X POST "https://api.socq.ai/v1/linkedin/post-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.linkedin.com/posts/aagupta_what-you-need-to-know-ai-agents-activity-7354600338621906944-RvXR"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueLinkedIn Post Comments API 추천 활용 사례
- 특정 게시물의 반응 검토: 광범위한 계정 탐색 없이, 선택한 공지·아티클·캠페인 게시물에 달린 공개 댓글 텍스트를 읽습니다.
- 질문·피드백 분류: 반환된 텍스트를 질문, 이의 제기, 제품 피드백을 사람이 검토할 수 있도록 분류하되, 원본 링크와 작성자 정보는 함께 유지합니다.
- 공개 참여 스냅샷: 반환된 댓글 간의 좋아요·답글 수를 비교하고, 그 관찰 결과를 collected_at 기준으로 고정합니다.
- 원본 링크가 있는 댓글 아카이브: 정규화된 댓글 레코드를 제출한 게시물 URL, 사용 가능한 post_id 또는 parent_id와 함께 저장해 이후 감사와 조회에 활용합니다.
LinkedIn Post Comments API 활용 팁
- 같은 게시물의 URL 변형을 반복해서 제출하기 전에 activity 또는 share 식별자의 중복을 제거하세요.
- results_limit, 정렬, 답글 확장 필드는 보내지 마세요. 허용되는 요청 속성은 url뿐입니다.
- 반환 순서는 시간순이나 관련도순이 아니라 원본에 따라 달라진다고 보세요.
- 확인할 수 없는 카운터가 참여가 없다는 증거는 아니므로, likes_count와 replies_count에서 null과 0을 구분해 두세요.
- 정규화된 필드만으로 감정, 의도, 직급, 리드 품질, 자동화 여부를 추론하지 마세요.
- next_cursor는 완료된 작업에 이미 저장된 댓글을 모두 읽는 용도로만 이어서 사용하세요. LinkedIn 댓글의 다음 페이지를 요청하지는 않습니다.
관련 API
LinkedIn Post Comments API 외에 LinkedIn의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- LinkedIn Profiles API — 프로필 URL에서 공개 프로필 정보, 직무, 위치, 공개된 오디언스 수, 경력, 학력, 스킬을 정규화합니다.
- LinkedIn Companies API — 공개 회사 소개, 웹사이트, 로고, 공개된 팔로워 및 직원 수, 산업, 위치, 전문 분야를 정규화합니다.
- LinkedIn Posts API — 지원되는 URL에서 공개 게시물 텍스트, 작성자, 공개된 참여도, 미디어, 게시 시각, 유형, 해시태그를 수집합니다.
- LinkedIn Jobs API — 공개 채용 공고의 직무명, 회사, 설명, 위치, 자격 요건, 고용 정보, 지원 링크, 확인 가능한 연봉 필드를 정규화합니다.
- LinkedIn Company Jobs API — 준비된 LinkedIn /jobs/ URL에서 공개 채용 공고를 찾으며, 정규화된 직무, 회사, 위치, 고용 형태, 경력, 원격 근무, 연봉, 게시 시점 필드를 포함합니다.
- LinkedIn Company Posts API — LinkedIn 회사 페이지 URL에서 공개 게시물을 찾으며, 텍스트, 작성자 맥락, 미디어, 해시태그, 타임스탬프, 공개된 참여도를 포함합니다.