linkedin/
search-people

인물 검색 URL에서 후보 공개 LinkedIn 프로필을 찾아, 정규화된 신원 정보, 소개, 이미지, 지역, 웹사이트, 계정 신호, 사용 가능한 지표를 반환합니다.

LinkedIn Search People API

검색 URL 입력
이름 기반 탐색
표준 계정 레코드
결과당 1 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

LinkedIn Search People

LinkedIn 인물 검색은 제출한 인물 검색 URL마다 keywords 값을 이름 기반 제공자 쿼리로 변환합니다. 결과는 신원 확인을 위한 후보 공개 프로필일 뿐 해당 프로필이 찾는 사람의 것임을 증명하지 않으며, URL에 인코딩된 회사·학교·지역·산업·1촌 필터는 반영하지 않습니다.

LinkedIn Search People API 주요 기능

  • 인물 검색 URL 입력경로가 /search/results/people로 시작하는 공개 LinkedIn URL을 하나 이상 제출합니다.
  • 명시적인 이름 매핑keywords를 디코딩한 뒤 공백으로 구분된 첫 번째 토큰을 first_name에, 나머지 토큰을 이어 붙여 last_name에 매핑합니다.
  • 후보 프로필 탐색수동 매칭이나 이후 프로필별 수집에 활용할 수 있는 공개 프로필 URL과 신원 정보를 받습니다.
  • 표준 계정 레코드안정적인 신원, 소개, 이미지, 웹사이트, 계정 상태, 지역, 지표, 수집 필드를 반환합니다.
  • null 허용으로 원본 충실도 유지확인할 수 없는 필드는 null로 두며, 비공개 연락처, 경력, 학력, 스킬, 신원 확실성을 추정하지 않습니다.

LinkedIn Search People API 매개변수

매개변수필수설명
urls필수공개 http 또는 https LinkedIn URL의 목록으로, 필수 값입니다. 각 호스트는 linkedin.com 또는 LinkedIn 서브도메인이어야 하고, 각 경로는 /search/results/people로 시작해야 합니다. 이름 기반으로 안정적으로 동작하려면 keywords를 포함하세요.

LinkedIn Search People API 사용 방법

이름 기반 인물 검색 URL을 준비하고, 비동기 작업을 제출한 뒤, 반환된 후보를 모두 검토합니다.

  1. keywords 쿼리 값에 사람 이름을 담은 LinkedIn 인물 검색 URL을 만듭니다.
  2. urls를 /v1/linkedin/search-people로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 최종 상태에 도달할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 성공하면 data.results.items를 처리하고, has_more가 true일 때마다 next_cursor를 따라갑니다.
curl -X POST "https://api.socq.ai/v1/linkedin/search-people" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.linkedin.com/search/results/people/?keywords=Aakash%20Gupta"]}'

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

LinkedIn Search People API 추천 활용 사례

  • 프로필 URL 탐색: 프로필 전용 수집 엔드포인트를 사용하기 전에 후보 공개 LinkedIn 프로필 URL을 찾습니다.
  • 수동 신원 확인: 후보 간의 이름, 소개, 지역, 이미지, URL을 비교하되 불확실성은 그대로 남겨 둡니다.
  • 공개 디렉터리 유입: 연락처 보강이나 비공개 속성을 약속하지 않고, 정규화된 후보 계정을 검토 대기열에 전달합니다.
  • 이름 표기 변형 조사: 신중하게 고른 이름 표기를 각각 따로 실행하고, 수집 시점마다 나온 공개 후보를 비교합니다.

LinkedIn Search People API 활용 팁

  • 의미 있는 keywords 쿼리 값을 항상 포함하세요. 값이 없으면 유효한 URL이어도 빈 이름 행이 만들어져 제공자 동작을 신뢰할 수 없습니다.
  • Mary Jane Smith는 일반 키워드 표현이 아니라 first_name은 Mary, last_name은 Jane Smith로 매핑된다는 점을 기억하세요.
  • URL의 지역, 회사, 학교, 산업, 1촌 필터가 반영된다고 가정하지 마세요. 현재 어댑터는 이를 버립니다.
  • 사람을 특정하기 전에 공개 프로필 URL과 여러 보강 속성을 함께 확인하세요.
  • 제출한 검색이 서로 겹쳐 같은 후보가 반복되면 안정적인 프로필 URL로 중복을 제거하세요.
  • 호출자가 지정하는 결과 제한이 없으므로, 요금과 검토 워크플로는 실제로 저장된 결과를 기준으로 설계하세요.

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

  • LinkedIn Profiles API — 프로필 URL에서 공개 프로필 정보, 직무, 위치, 공개된 오디언스 수, 경력, 학력, 스킬을 정규화합니다.
  • LinkedIn Companies API — 공개 회사 소개, 웹사이트, 로고, 공개된 팔로워 및 직원 수, 산업, 위치, 전문 분야를 정규화합니다.
  • LinkedIn Posts API — 지원되는 URL에서 공개 게시물 텍스트, 작성자, 공개된 참여도, 미디어, 게시 시각, 유형, 해시태그를 수집합니다.
  • LinkedIn Jobs API — 공개 채용 공고의 직무명, 회사, 설명, 위치, 자격 요건, 고용 정보, 지원 링크, 확인 가능한 연봉 필드를 정규화합니다.
  • LinkedIn Profile Posts API — LinkedIn 프로필 URL과 연결된 공개 게시물을 찾으며, 작성자 맥락, 미디어, 해시태그, 타임스탬프, 공개된 참여도를 포함합니다.
  • LinkedIn Search Posts API — 키워드와 선택 날짜 문자열로 Google에 색인된 공개 LinkedIn 게시물을 찾고, 정규화된 콘텐츠, 작성자, 미디어, 태그, 타임스탬프, 공개된 참여도를 반환합니다.

다른 플랫폼 둘러보기

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

LinkedIn Search People API — 자주 묻는 질문

LinkedIn Search People API는 인물 검색 URL에서 후보 공개 LinkedIn 프로필을 찾는 프로그래밍 인터페이스입니다. URL의 keywords 값을 이름 기반 제공자 쿼리로 매핑하고, 검토용 정규화된 공개 계정 레코드를 반환합니다.

각 값은 linkedin.com 또는 LinkedIn 서브도메인의 완전한 http 또는 https URL이어야 하며, 경로가 /search/results/people로 시작해야 합니다.

디코딩한 뒤 값을 공백 기준으로 나눕니다. 첫 번째 토큰은 first_name이 되고, 나머지 토큰은 이어 붙여 last_name이 됩니다.

아니요. 현재 어댑터는 인코딩된 지역, 회사, 학교, 산업, 연결 차수 등 다른 검색 필터를 매핑하지 않습니다.

아니요. 이 엔드포인트에는 호출자가 지정하는 결과 제한이 없으며, 제출한 URL마다 탐색 소스가 만든 레코드를 그대로 저장합니다.

아니요. 이름은 고유하지 않습니다. 각 결과를 후보로 보고 공개 URL, 이름, 소개, 지역 등 공개된 다른 속성과 대조해 확인하세요.

저장에 성공한 프로필 결과 1건당 1 SocQ 크레딧이 차감되며 기본 요금은 없습니다. 계획용 예상치는 URL당 결과 100건을 기준으로 하고, 빈 결과에는 결과 요금이 없으며, 결과 상한이 없어 실제 사용량은 달라질 수 있습니다.