LinkedIn Profile Posts
LinkedIn 프로필과 연관된 피드에는 회원 페이지에서 공개된 직접 작성 게시물, 리포스트, 아티클, 이미지, 동영상, 문서 등의 활동이 포함될 수 있습니다. 반환된 레코드는 콘텐츠 조사용 수집 시점 표본일 뿐, 전체 활동 내역이나 비공개 분석 자료, 1촌에게만 공개된 게시물을 나타내지 않습니다.
LinkedIn Profile Posts API 주요 기능
- 프로필 URL 기반 탐색공개 LinkedIn /in/ URL을 하나 이상 받아, 제출한 프로필마다 연관된 게시물을 찾아 줍니다.
- 직접 작성한 게시물 필터(선택)only_authored_posts를 전달하면, 연관된 활동을 제공자가 대상 프로필이 직접 작성했다고 식별한 게시물로 좁힙니다.
- 제공자 날짜 구간선택 사항인 start_date, end_date 문자열을 제공자 측 필터링용으로 그대로 전달하며, 형식·순서·포함 여부·시간대 규칙은 자체적으로 적용하지 않습니다.
- 정규화된 콘텐츠 정보사용 가능한 게시물 텍스트, 작성자 필드, 게시 시각, 미디어, 해시태그, 멘션, 원본 URL을 안정적인 게시물 스키마로 반환합니다.
- 공개된 참여 수치 스냅샷사용 가능한 좋아요, 댓글, 공유, 조회수를 collected_at과 함께 보관해 측정값이 관찰 시점에 묶여 있도록 합니다.
LinkedIn Profile Posts API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | LinkedIn 호스트에서 경로가 /in/으로 시작하는 공개 LinkedIn 프로필 URL의 목록으로, 필수 값입니다. |
start_date | 선택 | 모든 입력 프로필에 그대로 전달되는 선택 사항의 제공자 날짜 필터 문자열로, 비어 있지 않아야 합니다. SocQ는 형식이나 포함 여부를 해석하거나 검증하지 않습니다. |
end_date | 선택 | 모든 입력 프로필에 그대로 전달되는 선택 사항의 제공자 날짜 필터 문자열로, 비어 있지 않아야 합니다. SocQ는 start_date와의 순서를 검사하지 않습니다. |
only_authored_posts | 선택 | 모든 프로필에 그대로 전달되는 선택 사항의 불리언 값입니다. true이면 제공자가 식별한 직접 작성 게시물을 요청하지만, SocQ 측에서 작성자 신원을 확인하는 것은 아닙니다. |
results_limit | 선택 | 1부터 2000까지의 선택 정수로, 모든 프로필 URL에 따로 적용되며 기본값은 프로필당 100입니다. |
LinkedIn Profile Posts API 사용 방법
프로필 URL과 탐색 옵션을 제출하고, 비동기 작업을 따라간 뒤, 저장된 정규화 게시물을 페이지 단위로 읽습니다.
- 경로가 /in/으로 시작하는 공개 LinkedIn 프로필 URL을 하나 이상 준비합니다.
- 프로필마다 only_authored_posts와 1부터 2000까지의 results_limit을 정하고, 제공자 날짜 문자열은 필요할 때만 추가합니다.
- 요청을 /v1/linkedin/profile-posts로 POST하고, 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽고, has_more가 true인 동안 next_cursor로 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/linkedin/profile-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/in/satyanadella/"],"only_authored_posts":true,"results_limit":20}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueLinkedIn Profile Posts API 추천 활용 사례
- 공개 커뮤니케이션 검토: 선택한 전문가 프로필과 연관되어 반환된 게시물에서 주제, 주장, 링크, 반복되는 표현을 살펴봅니다.
- 직접 작성 콘텐츠 표본 추출: only_authored_posts로 범위를 좁힌 표본을 요청하고, 작성 주체가 중요할 때는 반환된 author 필드를 확인합니다.
- 형식·미디어 조사: 정해 둔 반환 레코드 집합 안에서 이미지, 동영상, 문서, 아티클, 해시태그, 멘션 패턴을 비교합니다.
- 기간별 참여 수치 스냅샷: 제공자 날짜 문자열을 적용하고 수집된 표본 안에서만 공개된 참여 수치를 비교하되, published_at과 collected_at을 함께 보관합니다.
LinkedIn Profile Posts API 활용 팁
- results_limit은 프로필별 상한으로 보세요. URL 5개에 제한 20을 지정하면 최대 100개의 게시물이 저장될 수 있습니다.
- SocQ는 날짜의 형식, 순서, 경계, 시간대를 검증하지 않으므로, 날짜 입력은 제공자 문자열로 두고 직접 정한 규칙을 문서화하세요.
- only_authored_posts가 중요하다면 반환된 author를 확인하세요. 이 플래그는 제공자 측 필터링을 요청할 뿐 신원을 증명하지는 않습니다.
- 공개된 수치는 실행마다 달라질 수 있으므로, 참여 지표 옆에 collected_at을 함께 보존하세요.
- 타임스탬프와 지표에서는 null과 0을 구분하고, 미디어·해시태그·멘션은 비어 있을 수 있다고 보세요.
- 정규화된 표본만으로 전문성, 재직 여부, 감정, 리드 품질, 영향력, 콘텐츠 효과를 추론하지 마세요.
관련 API
LinkedIn Profile Posts API 외에 LinkedIn의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- LinkedIn Profiles API — 프로필 URL에서 공개 프로필 정보, 직무, 위치, 공개된 오디언스 수, 경력, 학력, 스킬을 정규화합니다.
- LinkedIn Companies API — 공개 회사 소개, 웹사이트, 로고, 공개된 팔로워 및 직원 수, 산업, 위치, 전문 분야를 정규화합니다.
- LinkedIn Posts API — 지원되는 URL에서 공개 게시물 텍스트, 작성자, 공개된 참여도, 미디어, 게시 시각, 유형, 해시태그를 수집합니다.
- LinkedIn Company Posts API — LinkedIn 회사 페이지 URL에서 공개 게시물을 찾으며, 텍스트, 작성자 맥락, 미디어, 해시태그, 타임스탬프, 공개된 참여도를 포함합니다.
- LinkedIn Post Comments API — 알고 있는 LinkedIn 게시물에 노출된 공개 댓글을 수집하며, 텍스트, 작성자 맥락, 타임스탬프, 관계 ID, 공개된 좋아요 및 답글 수를 포함합니다.
- LinkedIn Video Transcript API — 동영상이 담긴 게시물 URL로 LinkedIn 동영상의 자막을 일반 텍스트로 변환합니다.