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을 준비하고, 비동기 작업을 제출한 뒤, 반환된 후보를 모두 검토합니다.
- keywords 쿼리 값에 사람 이름을 담은 LinkedIn 인물 검색 URL을 만듭니다.
- urls를 /v1/linkedin/search-people로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 최종 상태에 도달할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 성공하면 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 trueLinkedIn 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로 중복을 제거하세요.
- 호출자가 지정하는 결과 제한이 없으므로, 요금과 검토 워크플로는 실제로 저장된 결과를 기준으로 설계하세요.
관련 API
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 게시물을 찾고, 정규화된 콘텐츠, 작성자, 미디어, 태그, 타임스탬프, 공개된 참여도를 반환합니다.