linkedin/
profile-posts

LinkedIn 프로필 URL과 연관된 공개 게시물을 찾아, 정규화된 텍스트, 작성자 정보, 미디어, 해시태그, 타임스탬프, 공개된 참여 수치를 반환합니다.

LinkedIn Profile Posts API

프로필 URL 기반 탐색
직접 작성한 게시물 필터
프로필별 건수 제한
결과당 1 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

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과 탐색 옵션을 제출하고, 비동기 작업을 따라간 뒤, 저장된 정규화 게시물을 페이지 단위로 읽습니다.

  1. 경로가 /in/으로 시작하는 공개 LinkedIn 프로필 URL을 하나 이상 준비합니다.
  2. 프로필마다 only_authored_posts와 1부터 2000까지의 results_limit을 정하고, 제공자 날짜 문자열은 필요할 때만 추가합니다.
  3. 요청을 /v1/linkedin/profile-posts로 POST하고, 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 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 true

LinkedIn 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을 구분하고, 미디어·해시태그·멘션은 비어 있을 수 있다고 보세요.
  • 정규화된 표본만으로 전문성, 재직 여부, 감정, 리드 품질, 영향력, 콘텐츠 효과를 추론하지 마세요.

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 동영상의 자막을 일반 텍스트로 변환합니다.

다른 플랫폼 둘러보기

LinkedIn 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

LinkedIn Profile Posts API — 자주 묻는 질문

LinkedIn Profile Posts API는 제출한 LinkedIn 프로필 URL과 연관된 공개 게시물을 찾아, 정규화된 콘텐츠, 작성자 정보, 미디어, 타임스탬프, 공개된 참여 수치를 반환하는 프로그래밍 인터페이스입니다.

linkedin.com 또는 LinkedIn 서브도메인에서 경로가 /in/으로 시작하는 http 또는 https URL을 하나 이상 제출하세요. 회사 페이지와 게시물 URL은 이 엔드포인트의 입력 사양에 해당하지 않습니다.

true이면 제공자가 대상 프로필이 직접 작성했다고 식별한 게시물을 요청하도록 값이 전달됩니다. SocQ가 따로 신원을 확인하는 것은 아니므로, 작성 주체가 중요하다면 반환된 author 필드를 확인하세요.

아니요. SocQ는 비어 있지 않은 문자열을 형식 해석이나 순서 비교 없이 그대로 전달하며 포함 경계와 시간대도 정의하지 않습니다. 필터링은 제공자의 동작에 따릅니다.

아니요. 기본값은 100이며 URL마다 따로 1부터 2000까지 적용되므로, 작업 전체 합계는 프로필별 제한에 프로필 수를 곱한 값까지 될 수 있습니다.

아니요. 해당 실행에서 제출한 프로필과 필터에 대해 사용할 수 있는 공개 게시물 레코드가 노출되지 않았다는 뜻이며, 공개 범위와 제공자 상황에 따라 수집 범위가 달라질 수 있습니다.

저장에 성공한 게시물 1건당 1 SocQ 크레딧이 차감되며 기본 요금은 없습니다. 예상치는 프로필별 결과 상한을 기준으로 하고 최종 요금은 실제 저장된 결과를 따르며, 빈 결과에는 결과 요금이 없습니다.