linkedin/
profiles

/in/{slug} URL에서 공개 LinkedIn 프로필을 조회하고, 정규화된 신원 정보와 현재 직무, 경력 이력, 스킬, 지역, 공개된 오디언스 수를 반환합니다.

LinkedIn Profiles API

프로필 URL 입력
경력 정보
공개 스냅샷
결과당 2.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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 사용 방법

알고 있는 프로필 링크로 시작해 프로필 작업이 끝나기를 기다린 뒤, 경력 레코드를 페이지 단위로 가져옵니다.

  1. 경로가 /in/{slug} 형식과 일치하는 공개 LinkedIn 링크만 남깁니다.
  2. 해당 링크를 urls에 담아 /v1/linkedin/profiles로 보내고, 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/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 true

LinkedIn Profiles API 추천 활용 사례

  • 연락처·후보자 정보 보강: 알고 있는 프로필 URL과 연결된 레코드에 현재 직무, 회사, 지역, 경력, 학력, 스킬을 추가합니다.
  • 커리어 경로 조사: 구조화된 경력·학력 섹션을 활용해 직무 변화 과정과 전문적 배경을 살펴봅니다.
  • 공개 프로필 모니터링: 저장해 둔 프로필 스냅샷을 비교해 직책, 현재 회사, 스킬, 공개된 오디언스 수의 변화를 파악합니다.

LinkedIn Profiles API 활용 팁

  • URL 형태가 달라도 같은 프로필 레코드가 반복 생성되지 않도록, 제출 전에 /in/ URL을 정규화하고 중복을 제거하세요.
  • 반환된 id가 있으면 프로필 키로 사용하고, 식별자가 없는 레코드는 url을 대체 키로 사용하세요.
  • 공개 프로필에서는 경력, 학력, 스킬, 오디언스 수가 생략될 수 있으므로 이 값들은 선택 사항으로 취급하세요.
  • 시간에 따른 직무나 오디언스 변화를 비교하려면 저장하는 스냅샷마다 collected_at을 함께 보관하세요.

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과 연결된 공개 게시물을 찾으며, 작성자 맥락, 미디어, 해시태그, 타임스탬프, 공개된 참여도를 포함합니다.

다른 플랫폼 둘러보기

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

LinkedIn Profiles API — 자주 묻는 질문

LinkedIn Profiles API는 허용되는 /in/{slug} URL 하나 이상에서 공개 전문가 데이터를 가져옵니다. 정규화된 신원 정보, 현재 직무, 지역, 경력, 학력, 스킬, 사용 가능한 팔로워 수와 커넥션 수를 반환합니다.

경로가 /in/{slug} 형식과 일치하는 완전한 http 또는 https LinkedIn URL을 제출하세요. 회사 페이지, 게시물, 피드, 채용 공고 링크는 프로필 입력이 아닙니다.

아니요. 결과는 프로필을 처리하는 시점에 공개 프로필에서 볼 수 있는 필드로 한정되며, 응답에 비공개 회원 데이터가 추가되지 않습니다.

공개 프로필에 노출되지 않은 경우 경력, 학력, 스킬, 오디언스 수 등 선택 필드는 null 또는 빈 값일 수 있습니다.

반환된 프로필을 기준으로 결과당 2.5 SocQ 크레딧이 차감됩니다. 완료된 작업에서 프로필이 반환되지 않으면 결과 요금이 없습니다.