linkedin/
company-posts

회사 페이지 URL에서 공개 LinkedIn 게시물을 찾아, 게시물 텍스트, 작성자 정보, 미디어, 해시태그, 타임스탬프, 공개된 참여 수치를 정규화된 레코드로 반환합니다.

LinkedIn Company Posts API

회사 페이지 기반 탐색
선택 날짜 값
공개 게시물 레코드
결과당 1 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

LinkedIn Company Posts

LinkedIn 회사 게시물은 조직 페이지를 중심으로 노출되는 공개 업데이트로, 텍스트, 게시자 정보, 미디어, 게시 시각, 주제, 공개된 참여 수치를 담고 있습니다. 이러한 레코드는 커뮤니케이션 모니터링, 콘텐츠 검토, 미디어 분석, 선택한 조직과 기간 간의 비교에 활용할 수 있습니다.

LinkedIn Company Posts API 주요 기능

  • 회사 페이지 기반 탐색공개 LinkedIn /company/ URL을 하나 이상 지정하면, 선택한 조직 페이지와 연관된 게시물을 찾아 줍니다.
  • 게시자 정보정규화된 author 객체를 반환하므로, 회사와의 연관성과 개별 게시물에 표시된 사람 또는 게시자를 구분할 수 있습니다.
  • 콘텐츠와 미디어 신호게시물 텍스트, 첨부 미디어, 해시태그, 멘션, 게시 시각, 원본 게시물 URL을 레코드 하나에 함께 담습니다.
  • 공개된 참여 수치 스냅샷좋아요, 댓글, 공유, 조회수를 수집 시점의 카운터로 제공하며, 도달 범위나 비즈니스 성과를 추정한 값이 아닙니다.
  • 선택 날짜 값 전달비어 있지 않은 start_date, end_date 문자열을 입력 URL마다 그대로 전달하며, 형식·순서·포함 여부·시간대는 자체적으로 해석하지 않습니다.

LinkedIn Company Posts API 매개변수

매개변수필수설명
urls필수공개 http 또는 https LinkedIn 회사 페이지 URL의 목록으로, 필수 값입니다. 각 호스트는 linkedin.com 또는 LinkedIn 서브도메인이어야 하며, 경로는 /company/로 시작해야 합니다.
start_date선택각 URL에 그대로 전달되는 선택 날짜 값으로, 비어 있지 않은 문자열이어야 합니다. YYYY-MM-DD가 문서화된 예시이지만, 서비스는 형식·포함 여부·시간대를 해석하지 않습니다.
end_date선택각 URL에 그대로 전달되는 선택 날짜 값으로, 비어 있지 않은 문자열이어야 합니다. 서비스는 형식을 검사하지 않으며 start_date보다 뒤여야 한다는 조건도 확인하지 않습니다.
results_limit선택입력 URL마다 따로 적용되는 선택 정수 상한입니다. 기본값은 100, 최솟값은 1, 최댓값은 2000입니다.

LinkedIn Company Posts API 사용 방법

회사 페이지 URL을 선택 날짜 값과 함께 제출하고, 비동기 작업을 폴링한 뒤 커서 페이지를 하나씩 읽습니다.

  1. 경로가 /company/로 시작하는 공개 LinkedIn URL을 준비합니다.
  2. urls, 선택 사항인 start_date와 end_date 문자열, results_limit을 /v1/linkedin/company-posts로 POST하고, task_id를 저장합니다.
  3. 작업이 succeeded 또는 failed 상태가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽고, has_more가 true이면 next_cursor로 다음 페이지를 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/linkedin/company-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.linkedin.com/company/microsoft/"],"start_date":"2026-01-01","end_date":"2026-06-30","results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

LinkedIn Company Posts API 추천 활용 사례

  • 공개 커뮤니케이션 타임라인: 선택한 회사 페이지의 게시물 텍스트, 게시 시각, 원본 URL, 게시자 정보를 검토하기 쉬운 타임라인으로 정리합니다.
  • 주제·미디어 검토: 해시태그, 멘션, 텍스트, 미디어 참조를 활용해 반환된 표본에서 반복되는 공개 주제와 콘텐츠 형식을 살펴봅니다.
  • 비교 가능한 참여 수치 스냅샷: 날짜, 건수 제한, 수집 시점을 동일하게 맞춘 상태에서 반환된 게시물의 좋아요, 댓글, 공유, 조회수를 비교합니다.
  • 후속 분석용 콘텐츠 선별: 게시물 ID, URL, 작성자, 텍스트, 카운터를 바탕으로 이후 댓글 분석이나 크리에이티브 분석에 사용할 레코드를 골라냅니다.

LinkedIn Company Posts API 활용 팁

  • 여러 페이지를 한 번에 요청하기 전에, 모든 입력이 완전한 LinkedIn /company/ URL인지 검증하세요.
  • start_date와 end_date는 제공자가 정의하는 문자열로 취급하세요. YYYY-MM-DD를 일관되게 쓰되, 자체 검증·포함 여부·순서를 가정하지 마세요.
  • 여러 회사 페이지를 비교할 때는 날짜, results_limit, 수집 시점을 동일하게 유지하세요.
  • 회사 페이지와 연관되어 있다고 해서 회사가 직접 작성했다는 뜻은 아니므로, 모든 레코드의 author와 게시물 URL을 확인하세요.
  • 페이지가 겹치거나 반복 실행으로 같은 게시물이 나타날 수 있으니, 고정된 게시물 id 또는 URL로 중복을 제거하세요.
  • 공개 자산은 수집 후 리디렉션되거나 만료되거나 사용할 수 없게 될 수 있으므로, 미디어 링크는 방어적으로 저장하세요.

LinkedIn Company Posts API 외에 LinkedIn의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • LinkedIn Profiles API — 프로필 URL에서 공개 프로필 정보, 직무, 위치, 공개된 오디언스 수, 경력, 학력, 스킬을 정규화합니다.
  • LinkedIn Companies API — 공개 회사 소개, 웹사이트, 로고, 공개된 팔로워 및 직원 수, 산업, 위치, 전문 분야를 정규화합니다.
  • LinkedIn Posts API — 지원되는 URL에서 공개 게시물 텍스트, 작성자, 공개된 참여도, 미디어, 게시 시각, 유형, 해시태그를 수집합니다.
  • LinkedIn Post Comments API — 알고 있는 LinkedIn 게시물에 노출된 공개 댓글을 수집하며, 텍스트, 작성자 맥락, 타임스탬프, 관계 ID, 공개된 좋아요 및 답글 수를 포함합니다.
  • LinkedIn Profile Posts API — LinkedIn 프로필 URL과 연결된 공개 게시물을 찾으며, 작성자 맥락, 미디어, 해시태그, 타임스탬프, 공개된 참여도를 포함합니다.
  • LinkedIn Video Transcript API — 동영상이 담긴 게시물 URL로 LinkedIn 동영상의 자막을 일반 텍스트로 변환합니다.

다른 플랫폼 둘러보기

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

LinkedIn Company Posts API — 자주 묻는 질문

LinkedIn Company Posts API는 LinkedIn /company/ 페이지 URL에서 공개 게시물을 찾는 프로그래밍 인터페이스입니다. 정규화된 텍스트, 작성자 정보, 미디어, 해시태그, 멘션, 게시 시각, 공개된 참여 수치를 반환합니다.

각 값은 linkedin.com 또는 LinkedIn 서브도메인의 완전한 http 또는 https URL이어야 하며, 경로가 /company/로 시작해야 합니다. 개인 /in/ 프로필과 개별 게시물 URL은 이 엔드포인트의 URL 검증을 통과하지 못합니다.

비어 있지 않은 start_date, end_date 문자열은 모든 URL에 대해 탐색 제공자에게 그대로 전달됩니다. 서비스는 형식을 해석하거나 순서를 검사하지 않고 포함 여부와 시간대 동작도 정의하지 않으므로, YYYY-MM-DD 값을 일관되게 사용하고 결과는 신중하게 해석하세요.

아니요. 결과는 제출한 회사 페이지의 탐색 피드와 연관되어 있지만, 정규화된 author는 개인, 회사, 기타 게시자일 수 있습니다. 작성 주체를 판단하기 전에 author와 url을 확인하세요.

results_limit은 회사 URL마다 독립적으로 적용되며 1부터 2000까지의 정수를 받습니다. 따라서 URL 3개에 제한 20을 지정하면 공개 여부와 제공자 동작에 따라 최대 60개의 게시물이 저장될 수 있습니다.

해당 작업에서 그 URL과 날짜 입력에 대해 지원되는 공개 게시물이 반환되지 않았다는 뜻입니다. 조직이 한 번도 게시한 적이 없다는 증거는 아니며, 잘못된 입력이나 작업 실패와 구분해서 다뤄야 합니다.

반환된 게시물 1건당 1 SocQ 크레딧이 차감되며 기본 요금은 없습니다. 빈 결과에는 결과 요금이 없고, 허용되는 경우 실제 사용량이 예상치를 넘을 수 있습니다.