linkedin/
company-jobs

준비한 /jobs/ URL로 공개 LinkedIn 채용 공고를 탐색하고, 정규화된 직무, 회사, 위치, 고용 형태, 경력, 원격 근무, 급여, 시점 필드를 반환합니다.

LinkedIn Company Jobs API

채용 페이지 입력
URL당 개수 제한
표준화된 채용 레코드
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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을 제출하고, 비동기 작업을 폴링한 뒤, 반환된 결과 페이지를 모두 처리합니다.

  1. 경로가 /jobs/로 시작하는 공개 LinkedIn URL을 준비하고, 유용한 쿼리 매개변수는 그대로 유지합니다.
  2. urls와 results_limit를 /v1/linkedin/company-jobs로 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/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 true

LinkedIn Company Jobs API 추천 활용 사례

  • 특정 고용주 모니터링: 준비해 둔 회사별 채용 URL을 다시 조회해, 수집 시점별로 반환된 공개 공고를 비교합니다.
  • 직무 카탈로그 정보 보강: 공개 채용 공고 카탈로그에 정규화된 회사, 위치, 고용 형태, 경력, 원격 근무, 급여, 날짜 필드를 추가합니다.
  • 채용 페이지 리서치: 모든 원본 URL과 수집 타임스탬프를 보관한 채로, 선택한 채용 페이지들에서 반환된 직무 구성을 비교합니다.
  • 워크플로 입력 데이터: 발견한 공개 공고 레코드를 검토, 중복 제거, 알림, 후속 분석 워크플로에 공급합니다.

LinkedIn Company Jobs API 활용 팁

  • 쿼리 매개변수가 페이지에 노출되는 공고에 영향을 줄 수 있으므로, 의미 있는 쿼리 매개변수는 준비한 URL에 그대로 두세요.
  • 채용 페이지끼리 겹쳐 같은 공고가 반환될 때는 고유한 채용 id나 공고 URL로 중복을 제거하세요.
  • URL 하나의 결과가 비어 있는 것은 수집 결과일 뿐, 해당 고용주에 채용 중인 직무가 없다는 증거가 아닙니다.
  • 준비한 페이지 URL 대신 키워드나 위치를 명시적으로 지정해야 한다면 구조화된 채용 검색을 사용하세요.
  • 공고 게시 시각과 조회 시각이 헷갈리지 않도록 published_at, expires_at, collected_at을 구분해서 보관하세요.

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 채용 공고를 검색하며, 정규화된 직무, 회사, 장소, 고용 형태, 경력, 원격 근무, 연봉, 게시 시점 필드를 반환합니다.

다른 플랫폼 둘러보기

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

LinkedIn Company Jobs API — 자주 묻는 질문

LinkedIn Company Jobs API는 준비한 LinkedIn /jobs/ URL에서 공개 채용 공고를 탐색하는 프로그래밍 인터페이스입니다. 수집 시점에 노출된 공고에 대해 정규화된 직무, 회사, 위치, 고용 형태, 경력, 원격 근무, 급여, 시점 필드를 반환합니다.

각 값은 linkedin.com 또는 LinkedIn 하위 도메인의 완전한 http 또는 https URL이어야 하며, 경로가 /jobs/로 시작해야 합니다. 일반 /company/ 프로필 URL은 검증을 통과하지 못합니다.

정수 제한은 URL마다 따로 적용됩니다. 예를 들어 제한이 20이면 제출한 채용 페이지당 최대 20개의 공고가 반환됩니다.

아니요. 응답이 비어 있다는 것은 그 시점에 해당 URL에서 지원되는 공개 공고가 반환되지 않았다는 뜻일 뿐입니다.

아니요. 이 엔드포인트는 공개 공고 데이터를 반환할 뿐, 직무에 지원하거나 채용 담당자에게 연락하거나 비공개 채용 분석을 제공하지 않습니다.

반환된 채용 레코드 1건당 0.5 SocQ 크레딧이 차감되며, 기본 요금은 없습니다. 결과가 비어 있으면 결과 요금이 부과되지 않고, 허용되는 경우 실제 사용량이 예상 금액을 넘을 수도 있습니다.