LinkedIn Profiles
공개 LinkedIn 프로필에는 전문가의 신원, 현재 직무, 지역, 경력, 학력, 스킬, 공개된 오디언스 규모가 담겨 있습니다. 이러한 정보는 연락처 정보 보강, 커리어 경로 조사, 신원 확인, 시간에 따른 공개 프로필 변화 비교에 활용할 수 있습니다.
LinkedIn Profiles API 주요 기능
- 공개 프로필 URL 입력LinkedIn /in/{slug} URL을 하나 이상 처리하며, 회사 페이지·게시물·채용 공고는 섞어 넣지 않습니다.
- 현재 전문 분야 정보공개된 이름, 소개 텍스트, 아바타, 지역, 직책, 현재 회사를 하나의 정규화된 레코드로 반환합니다.
- 구조화된 경력 이력경력, 학력, 스킬을 별도 섹션으로 보존해 필터링, 인덱싱, 레코드 보강에 사용할 수 있습니다.
- 공개된 오디언스 지표사용 가능한 팔로워 수와 커넥션 수를 전문가 프로필 필드와 함께 별도 지표로 반환합니다.
LinkedIn Profiles API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 공개 LinkedIn 프로필 URL의 목록으로, 필수 값입니다. 모든 URL은 linkedin.com 또는 LinkedIn 서브도메인의 /in/{slug} 경로를 사용해야 합니다. |
LinkedIn Profiles API 사용 방법
알고 있는 프로필 링크로 시작해 프로필 작업이 끝나기를 기다린 뒤, 경력 레코드를 페이지 단위로 가져옵니다.
- 경로가 /in/{slug} 형식과 일치하는 공개 LinkedIn 링크만 남깁니다.
- 해당 링크를 urls에 담아 /v1/linkedin/profiles로 보내고, task_id를 보관합니다.
- 프로필 처리가 succeeded 또는 failed 상태가 될 때까지 /v1/tasks/{task_id}를 확인합니다.
- 성공하면 data.results.items를 읽고, has_more가 true일 때마다 next_cursor로 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/linkedin/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/in/satyanadella"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueLinkedIn Profiles API 추천 활용 사례
- 연락처·후보자 정보 보강: 알고 있는 프로필 URL과 연결된 레코드에 현재 직무, 회사, 지역, 경력, 학력, 스킬을 추가합니다.
- 커리어 경로 조사: 구조화된 경력·학력 섹션을 활용해 직무 변화 과정과 전문적 배경을 살펴봅니다.
- 공개 프로필 모니터링: 저장해 둔 프로필 스냅샷을 비교해 직책, 현재 회사, 스킬, 공개된 오디언스 수의 변화를 파악합니다.
LinkedIn Profiles API 활용 팁
- URL 형태가 달라도 같은 프로필 레코드가 반복 생성되지 않도록, 제출 전에 /in/ URL을 정규화하고 중복을 제거하세요.
- 반환된 id가 있으면 프로필 키로 사용하고, 식별자가 없는 레코드는 url을 대체 키로 사용하세요.
- 공개 프로필에서는 경력, 학력, 스킬, 오디언스 수가 생략될 수 있으므로 이 값들은 선택 사항으로 취급하세요.
- 시간에 따른 직무나 오디언스 변화를 비교하려면 저장하는 스냅샷마다 collected_at을 함께 보관하세요.
관련 API
LinkedIn Profiles API 외에 LinkedIn의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- LinkedIn Companies API — 공개 회사 소개, 웹사이트, 로고, 공개된 팔로워 및 직원 수, 산업, 위치, 전문 분야를 정규화합니다.
- LinkedIn Posts API — 지원되는 URL에서 공개 게시물 텍스트, 작성자, 공개된 참여도, 미디어, 게시 시각, 유형, 해시태그를 수집합니다.
- LinkedIn Jobs API — 공개 채용 공고의 직무명, 회사, 설명, 위치, 자격 요건, 고용 정보, 지원 링크, 확인 가능한 연봉 필드를 정규화합니다.
- LinkedIn Company Jobs API — 준비된 LinkedIn /jobs/ URL에서 공개 채용 공고를 찾으며, 정규화된 직무, 회사, 위치, 고용 형태, 경력, 원격 근무, 연봉, 게시 시점 필드를 포함합니다.
- LinkedIn Company Posts API — LinkedIn 회사 페이지 URL에서 공개 게시물을 찾으며, 텍스트, 작성자 맥락, 미디어, 해시태그, 타임스탬프, 공개된 참여도를 포함합니다.
- LinkedIn Profile Posts API — LinkedIn 프로필 URL과 연결된 공개 게시물을 찾으며, 작성자 맥락, 미디어, 해시태그, 타임스탬프, 공개된 참여도를 포함합니다.