LinkedIn Companies
공개 LinkedIn 회사 페이지는 조직의 소개, 웹사이트, 업종, 규모, 본사, 위치, 전문 분야와 공개된 팔로워 수 및 직원 수를 보여 줍니다. 이러한 속성은 계정 정보 보강, 회사 세분화, 시장 매핑, 공개 회사 정보의 시간에 따른 비교에 활용할 수 있습니다.
LinkedIn Companies API 주요 기능
- 공개 회사 페이지 입력개인 프로필, 게시물, 채용 공고를 섞지 않고 LinkedIn /company/{slug} URL을 하나 이상 처리합니다.
- 회사 정보와 웹 존재감공개된 회사 이름, 소개, 웹사이트, 로고, LinkedIn 페이지 URL을 하나의 정규화된 레코드로 반환합니다.
- 구조화된 회사 속성업종, 회사 규모, 본사, 설립 연도, 위치, 전문 분야를 필터링과 비교에 바로 쓸 수 있는 필드로 제공합니다.
- 공개된 팔로워·직원 수확인 가능한 팔로워 수와 직원 수를 회사 속성과 함께 별도의 지표로 반환합니다.
LinkedIn Companies API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 공개 LinkedIn 회사 페이지 URL의 필수 목록입니다. 모든 URL은 linkedin.com 또는 LinkedIn 하위 도메인에서 /company/{slug} 경로를 사용해야 합니다. |
LinkedIn Companies API 사용 방법
알고 있는 회사 페이지를 제출하고, 데이터셋 작업이 끝나기를 기다린 뒤, 생성된 기업 속성 레코드를 페이지 단위로 읽습니다.
- /company/{slug} 패턴을 따르는 공개 회사 링크를 준비합니다.
- urls 목록을 /v1/linkedin/companies로 POST하고, task_id를 보관합니다.
- 회사 처리가 끝나거나 실패할 때까지 /v1/tasks/{task_id}로 작업을 확인합니다.
- data.results.items를 사용하고, 추가 결과 페이지는 next_cursor로 가져옵니다.
curl -X POST "https://api.socq.ai/v1/linkedin/companies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/company/microsoft/"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueLinkedIn Companies API 추천 활용 사례
- 계정·CRM 정보 보강: 알고 있는 회사 페이지와 연결된 레코드에 회사 소개, 웹사이트, 로고, 업종, 규모, 본사를 추가합니다.
- 회사 세분화: 리서치나 계정 기획을 위해 업종, 회사 규모, 위치, 전문 분야별로 조직을 묶습니다.
- 시장·위치 매핑: 본사와 위치 배열을 활용해 선택한 회사들이 어디에서 사업을 하는지 비교합니다.
- 공개 회사 모니터링: 저장해 둔 회사 레코드를 비교해 소개, 위치, 전문 분야, 공개된 규모 지표의 변화를 파악합니다.
LinkedIn Companies API 활용 팁
- /company/ URL의 다른 형식 때문에 중복 레코드가 생기지 않도록, 제출 전에 회사 slug를 정규화하고 중복을 제거하세요.
- 여러 값을 가진 회사 속성이 그대로 유지되도록 업종, 위치, 전문 분야는 배열로 보관하세요.
- 시간에 따른 회사 속성이나 공개된 수치를 비교할 때는 저장하는 레코드마다 collected_at을 함께 보관하세요.
관련 API
LinkedIn Companies API 외에 LinkedIn의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- LinkedIn Profiles API — 프로필 URL에서 공개 프로필 정보, 직무, 위치, 공개된 오디언스 수, 경력, 학력, 스킬을 정규화합니다.
- LinkedIn Posts API — 지원되는 URL에서 공개 게시물 텍스트, 작성자, 공개된 참여도, 미디어, 게시 시각, 유형, 해시태그를 수집합니다.
- LinkedIn Jobs API — 공개 채용 공고의 직무명, 회사, 설명, 위치, 자격 요건, 고용 정보, 지원 링크, 확인 가능한 연봉 필드를 정규화합니다.
- LinkedIn Company Jobs API — 준비된 LinkedIn /jobs/ URL에서 공개 채용 공고를 찾으며, 정규화된 직무, 회사, 위치, 고용 형태, 경력, 원격 근무, 연봉, 게시 시점 필드를 포함합니다.
- LinkedIn Company Posts API — LinkedIn 회사 페이지 URL에서 공개 게시물을 찾으며, 텍스트, 작성자 맥락, 미디어, 해시태그, 타임스탬프, 공개된 참여도를 포함합니다.
- LinkedIn Post Comments API — 알고 있는 LinkedIn 게시물에 노출된 공개 댓글을 수집하며, 텍스트, 작성자 맥락, 타임스탬프, 관계 ID, 공개된 좋아요 및 답글 수를 포함합니다.