LinkedIn Search Jobs
LinkedIn 채용 공고 검색은 필수 위치와 선택 필터로 공개 탐색 쿼리 하나를 구성합니다. 조사와 워크플로 유입에 쓸 수 있는 수집 시점의 공고 레코드를 반환하며, 반환된 공고가 지원 접수 중임을 보장하지 않고 결과 수가 채용 규모나 인원을 직접 나타내는 지표도 아닙니다.
LinkedIn Search Jobs API 주요 기능
- 위치 중심 탐색모든 쿼리를 비어 있지 않은 위치로 시작하며, 키워드·국가·회사 등 제공자 필터로 공개 공고 표본을 좁힐 수도 있습니다.
- 유연한 원본 필터time_range, job_type, experience_level, remote, company, location_radius, selective_search, 제외 값을 SocQ 자체 열거형을 만들지 않고 그대로 전달합니다.
- 설정 가능한 결과 상한단일 탐색 쿼리에 대해 results_limit을 1부터 2000까지 지정할 수 있으며, 기본값은 100이고 제공자가 더 적은 레코드를 반환할 수도 있습니다.
- 표준 채용 공고 레코드제공자별 중첩 구조 대신 안정적인 채용 공고, 회사, 위치, 급여, 게시, 만료, 수집 필드를 받습니다.
- null 허용으로 원본 충실도 유지확인할 수 없는 급여, 원격 근무, 회사, 경력, 위치, 게시, 만료 값은 추정하지 않고 null로 유지합니다.
LinkedIn Search Jobs API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
location | 필수 | 제공자 탐색 쿼리를 구성하는 데 사용되는 위치 문자열로, 비어 있지 않아야 하는 필수 값입니다. |
keyword | 선택 | 제공자에게 그대로 전달되는 선택 사항의 직무·스킬·주제 문자열로, 비어 있지 않아야 합니다. |
country | 선택 | SocQ 측 변환 없이 그대로 전달되는 선택 사항의 국가 필터 문자열로, 비어 있지 않아야 합니다. |
time_range | 선택 | 제공자별 게시 시점 또는 기간을 나타내는 선택 문자열로, 비어 있지 않아야 합니다. |
job_type | 선택 | 제공자별 고용 형태 또는 채용 유형 필터를 나타내는 선택 문자열로, 비어 있지 않아야 합니다. |
experience_level | 선택 | 제공자별 경력 또는 직급 필터를 나타내는 선택 문자열로, 비어 있지 않아야 합니다. |
remote | 선택 | 제공자별 근무 형태 또는 원격 근무 필터를 나타내는 선택 문자열로, 비어 있지 않아야 합니다. |
company | 선택 | 제공자에게 그대로 전달되는 선택 사항의 회사 필터 문자열로, 비어 있지 않아야 합니다. |
selective_search | 선택 | 제공자의 선택적 검색(selective-search) 동작을 제어하기 위해 그대로 전달되는 선택 불리언 값입니다. |
jobs_to_not_include | 선택 | 제공자에게 그대로 전달되는 제외 문자열의 선택 목록으로, 각 문자열은 비어 있지 않아야 합니다. |
location_radius | 선택 | 위치 쿼리와 함께 쓰이는 제공자별 반경을 나타내는 선택 문자열로, 비어 있지 않아야 합니다. |
results_limit | 선택 | 이 쿼리에 적용되는 선택 정수 상한입니다. 기본값은 100, 최솟값은 1, 최댓값은 2000입니다. |
LinkedIn Search Jobs API 사용 방법
위치 기반 쿼리 하나를 제출하고, 비동기 작업을 폴링한 뒤, 반환된 결과 페이지를 모두 처리합니다.
- 필수 위치를 정하고, 해석 방식을 직접 테스트해 본 제공자 필터 값만 추가합니다.
- 쿼리를 /v1/linkedin/search-jobs로 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-jobs" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"location":"Seattle","keyword":"Python","country":"US","results_limit":20}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueLinkedIn Search Jobs API 추천 활용 사례
- 지역별 직무 탐색: 일관된 직무·위치 쿼리로 공개 공고를 수집하고, 이후 비교를 위해 수집 시각을 보관합니다.
- 고용주·직무 검토: 반환된 표본에 어떤 고용주, 직함, 장소, 근무 방식, 경력 수준, 고용 형태가 나타나는지 살펴봅니다.
- 급여 공개 여부 파악: 급여 정보를 공개한 공고를 식별하고, 누락된 보상 정보는 명시적인 null로 보존합니다.
- 채용 워크플로 유입: 정규화된 공개 공고 URL과 필드를 검토, 중복 제거, 알림, 후속 분석 워크플로에 전달합니다.
LinkedIn Search Jobs API 활용 팁
- 제공자별 필터 표기는 반복 실행 워크플로에 넣기 전에 작은 쿼리로 먼저 테스트하세요.
- 지역이나 날짜를 비교할 때는 같은 필터와 수집 일정을 사용하세요.
- 갱신되거나 겹치는 검색에서 같은 채용 건이 나올 수 있으므로, 안정적인 채용 공고 id 또는 공고 URL로 중복을 제거하세요.
- 원격 근무 표시는 원본 신호로 보고, 지리·거주지·시간대 제약은 설명 본문에서 확인하세요.
- 공고 시점과 조회 시점이 혼동되지 않도록 published_at, expires_at, collected_at을 구분해 보관하세요.
- 빈 결과는 여러 수집 결과 중 하나일 뿐, 조건에 맞는 공개 채용 공고가 없다는 증거로 보지 마세요.
관련 API
LinkedIn Search Jobs API 외에 LinkedIn의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- LinkedIn Profiles API — 프로필 URL에서 공개 프로필 정보, 직무, 위치, 공개된 오디언스 수, 경력, 학력, 스킬을 정규화합니다.
- LinkedIn Companies API — 공개 회사 소개, 웹사이트, 로고, 공개된 팔로워 및 직원 수, 산업, 위치, 전문 분야를 정규화합니다.
- LinkedIn Posts API — 지원되는 URL에서 공개 게시물 텍스트, 작성자, 공개된 참여도, 미디어, 게시 시각, 유형, 해시태그를 수집합니다.
- LinkedIn Jobs API — 공개 채용 공고의 직무명, 회사, 설명, 위치, 자격 요건, 고용 정보, 지원 링크, 확인 가능한 연봉 필드를 정규화합니다.
- LinkedIn Company Jobs API — 준비된 LinkedIn /jobs/ URL에서 공개 채용 공고를 찾으며, 정규화된 직무, 회사, 위치, 고용 형태, 경력, 원격 근무, 연봉, 게시 시점 필드를 포함합니다.
- LinkedIn Company Posts API — LinkedIn 회사 페이지 URL에서 공개 게시물을 찾으며, 텍스트, 작성자 맥락, 미디어, 해시태그, 타임스탬프, 공개된 참여도를 포함합니다.