LinkedIn Company Jobs
LinkedIn 회사 채용 공고는 직책, 회사, 위치, 고용 형태, 경력 수준, 원격 근무 여부, 급여, 시점 정보를 담은 공개 공고입니다. 이러한 필드는 채용 공고 추적, 직무 비교, 채용 리서치, 구조화된 채용 디렉터리에 활용할 수 있습니다.
LinkedIn Company Jobs API 주요 기능
- 채용 페이지 탐색경로가 /jobs/로 시작하는 공개 LinkedIn URL을 하나 이상 제출하면, 준비한 페이지마다 노출되는 공고를 수집합니다.
- 입력별 개수 제한results_limit를 1~2000으로 설정할 수 있으며, 선택한 상한은 요청에 포함된 모든 URL에 각각 독립적으로 적용됩니다.
- 표준화된 채용 레코드원본마다 다른 중첩 구조 대신, 안정적인 채용 공고·회사·위치·급여·게시·만료·수집 필드를 받습니다.
- 원본에 충실한 null 처리급여, 원격 근무 여부, 경력 수준, 정확한 위치처럼 공고가 공개하지 않는 값은 null로 유지합니다.
LinkedIn Company Jobs API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 공개 http 또는 https LinkedIn URL의 필수 목록입니다. 각 호스트는 linkedin.com 또는 LinkedIn 하위 도메인이어야 하고, 각 경로는 /jobs/로 시작해야 합니다. |
results_limit | 선택 | 입력 URL마다 적용되는 결과 개수 상한으로, 선택 값인 정수입니다. 기본값은 100, 최솟값은 1, 최댓값은 2000입니다. |
LinkedIn Company Jobs API 사용 방법
준비한 채용 페이지 URL을 제출하고, 비동기 작업을 폴링한 뒤, 반환된 결과 페이지를 모두 처리합니다.
- 경로가 /jobs/로 시작하는 공개 LinkedIn URL을 준비하고, 유용한 쿼리 매개변수는 그대로 유지합니다.
- urls와 results_limit를 /v1/linkedin/company-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/company-jobs" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/jobs/microsoft-jobs/"],"results_limit":20}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueLinkedIn Company Jobs API 추천 활용 사례
- 특정 고용주 모니터링: 준비해 둔 회사별 채용 URL을 다시 조회해, 수집 시점별로 반환된 공개 공고를 비교합니다.
- 직무 카탈로그 정보 보강: 공개 채용 공고 카탈로그에 정규화된 회사, 위치, 고용 형태, 경력, 원격 근무, 급여, 날짜 필드를 추가합니다.
- 채용 페이지 리서치: 모든 원본 URL과 수집 타임스탬프를 보관한 채로, 선택한 채용 페이지들에서 반환된 직무 구성을 비교합니다.
- 워크플로 입력 데이터: 발견한 공개 공고 레코드를 검토, 중복 제거, 알림, 후속 분석 워크플로에 공급합니다.
LinkedIn Company Jobs API 활용 팁
- 쿼리 매개변수가 페이지에 노출되는 공고에 영향을 줄 수 있으므로, 의미 있는 쿼리 매개변수는 준비한 URL에 그대로 두세요.
- 채용 페이지끼리 겹쳐 같은 공고가 반환될 때는 고유한 채용 id나 공고 URL로 중복을 제거하세요.
- URL 하나의 결과가 비어 있는 것은 수집 결과일 뿐, 해당 고용주에 채용 중인 직무가 없다는 증거가 아닙니다.
- 준비한 페이지 URL 대신 키워드나 위치를 명시적으로 지정해야 한다면 구조화된 채용 검색을 사용하세요.
- 공고 게시 시각과 조회 시각이 헷갈리지 않도록 published_at, expires_at, collected_at을 구분해서 보관하세요.
관련 API
LinkedIn Company Jobs API 외에 LinkedIn의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- LinkedIn Profiles API — 프로필 URL에서 공개 프로필 정보, 직무, 위치, 공개된 오디언스 수, 경력, 학력, 스킬을 정규화합니다.
- LinkedIn Companies API — 공개 회사 소개, 웹사이트, 로고, 공개된 팔로워 및 직원 수, 산업, 위치, 전문 분야를 정규화합니다.
- LinkedIn Posts API — 지원되는 URL에서 공개 게시물 텍스트, 작성자, 공개된 참여도, 미디어, 게시 시각, 유형, 해시태그를 수집합니다.
- LinkedIn Jobs API — 공개 채용 공고의 직무명, 회사, 설명, 위치, 자격 요건, 고용 정보, 지원 링크, 확인 가능한 연봉 필드를 정규화합니다.
- LinkedIn Company Posts API — LinkedIn 회사 페이지 URL에서 공개 게시물을 찾으며, 텍스트, 작성자 맥락, 미디어, 해시태그, 타임스탬프, 공개된 참여도를 포함합니다.
- LinkedIn Search Jobs API — 필수 위치와 선택 필터로 공개 LinkedIn 채용 공고를 검색하며, 정규화된 직무, 회사, 장소, 고용 형태, 경력, 원격 근무, 연봉, 게시 시점 필드를 반환합니다.