linkedin/
jobs

/jobs/view/{slug} URL에서 공개 LinkedIn 채용 공고를 조회하고, 정규화된 직무·고용주 정보, 고용 조건, 지원 방법, 보상 정보, 타임스탬프를 반환합니다.

LinkedIn Jobs API

채용 공고 URL 입력
직무 정보
지원 필드
결과당 0.8 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

LinkedIn Jobs

공개 LinkedIn 채용 공고는 직무, 고용주, 상세 설명, 근무지, 직급, 고용 형태, 산업, 지원 경로, 공개된 보상 정보를 통해 특정 채용 건을 설명합니다. 이러한 정보는 공석 추적, 직무 비교, 채용 시장 조사, 구조화된 채용 공고 카탈로그 구축에 활용할 수 있습니다.

LinkedIn Jobs API 주요 기능

  • 채용 공고 상세 URL 입력공개 LinkedIn /jobs/view/{slug} 페이지를 하나 이상 처리하며, 검색 결과와 채용 공고 모음 URL은 거부합니다.
  • 직무와 고용주를 한 레코드에직무명, 전체 설명, 공고 URL, 정규화된 공개 채용 기업 정보를 함께 반환합니다.
  • 구조화된 고용 속성근무지, 직급, 고용 형태, 산업을 설명 본문 안에 두지 않고 별도 필드로 제공합니다.
  • 지원·보상 필드apply_link, Easy Apply 신호, 급여, 게시 시각, 수집 시각을 공고별 개별 필드로 반환합니다.

LinkedIn Jobs API 매개변수

매개변수필수설명
urls필수공개 LinkedIn 채용 공고 상세 URL의 목록으로, 필수 값입니다. 모든 URL은 linkedin.com 또는 LinkedIn 서브도메인의 /jobs/view/{slug} 경로를 사용해야 합니다.

LinkedIn Jobs API 사용 방법

알고 있는 채용 공고 상세 링크를 보내고, 채용 레코드가 준비될 때까지 기다린 뒤, 사용 가능한 결과 페이지를 모두 가져옵니다.

  1. 입력 목록을 공개 /jobs/view/{slug} 상세 링크만 남도록 걸러냅니다.
  2. 해당 링크를 urls에 담아 /v1/linkedin/jobs로 POST하고, task_id를 저장합니다.
  3. 채용 작업이 최종 상태에 도달할 때까지 /v1/tasks/{task_id}를 조회합니다.
  4. 성공하면 data.results.items를 처리하고, has_more로 표시된 페이지는 next_cursor로 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/linkedin/jobs" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.linkedin.com/jobs/view/software-engineer-at-microsoft-4429527118"]}'

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

LinkedIn Jobs API 추천 활용 사례

  • 공석 추적: 직무, 고용주, 근무지, 게시 시각, 원본 URL을 활용해 알고 있는 채용 건의 구조화된 목록을 유지합니다.
  • 직무·요건 비교: 선택한 공고들의 설명, 직급, 고용 형태, 산업, 근무지, 공개된 급여를 비교합니다.
  • 채용 시장 조사: 선택한 채용 건을 고용주, 근무지, 산업, 고용 형태별로 묶어 공개적으로 드러나는 채용 패턴을 살펴봅니다.
  • 지원 경로 관리: apply_link와 Easy Apply 신호를 활용해 저장한 공고마다 이용 가능한 지원 경로로 연결합니다.

LinkedIn Jobs API 활용 팁

  • /jobs/view/ 링크에서 채용 공고 식별자를 추출해 중복을 제거하세요. 그래야 URL 형태가 달라도 같은 공고가 반복 저장되지 않습니다.
  • 급여는 많은 공고에서 생략되고 노출되는 값의 형식도 제각각일 수 있으므로, 선택적인 원본 데이터로 취급하세요.
  • apply_link를 하위 인터페이스에서 외부 이동 버튼으로 보여 주기 전에 먼저 검증하세요.
  • 게시 시각과 조회 시각이 혼동되지 않도록 created_at과 collected_at을 따로 보관하세요.

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

  • LinkedIn Profiles API — 프로필 URL에서 공개 프로필 정보, 직무, 위치, 공개된 오디언스 수, 경력, 학력, 스킬을 정규화합니다.
  • LinkedIn Companies API — 공개 회사 소개, 웹사이트, 로고, 공개된 팔로워 및 직원 수, 산업, 위치, 전문 분야를 정규화합니다.
  • LinkedIn Posts API — 지원되는 URL에서 공개 게시물 텍스트, 작성자, 공개된 참여도, 미디어, 게시 시각, 유형, 해시태그를 수집합니다.
  • LinkedIn Company Jobs API — 준비된 LinkedIn /jobs/ URL에서 공개 채용 공고를 찾으며, 정규화된 직무, 회사, 위치, 고용 형태, 경력, 원격 근무, 연봉, 게시 시점 필드를 포함합니다.
  • LinkedIn Company Posts API — LinkedIn 회사 페이지 URL에서 공개 게시물을 찾으며, 텍스트, 작성자 맥락, 미디어, 해시태그, 타임스탬프, 공개된 참여도를 포함합니다.
  • LinkedIn Search Jobs API — 필수 위치와 선택 필터로 공개 LinkedIn 채용 공고를 검색하며, 정규화된 직무, 회사, 장소, 고용 형태, 경력, 원격 근무, 연봉, 게시 시점 필드를 반환합니다.

다른 플랫폼 둘러보기

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

LinkedIn Jobs API — 자주 묻는 질문

LinkedIn Jobs API는 허용되는 /jobs/view/{slug} URL 하나 이상에서 공개 채용 공고 데이터를 가져옵니다. 직무, 고용주, 설명, 근무지, 직급, 고용 형태, 산업, 지원 필드, 공개된 급여, 타임스탬프를 반환합니다.

아니요. 각 입력은 /jobs/view/{slug} 상세 페이지 한 건을 가리키는 완전한 http 또는 https LinkedIn URL이어야 하며, 검색 및 모음 경로는 검증을 통과하지 못합니다.

아니요. 이 제품은 urls로 제출한 공개 채용 공고 상세 URL만 처리하며, LinkedIn 채용 공고 검색은 수행하지 않습니다.

공개 공고에 노출되어 있으면 레코드에 외부 apply_link와 is_easy_apply 신호가 포함될 수 있습니다. 이 엔드포인트는 지원 정보를 반환할 뿐 지원서를 제출하지는 않습니다.

공개 공고에 급여, 외부 지원 링크, Easy Apply 신호가 게시되어 있지 않을 수 있어서, 이러한 선택 필드는 null 또는 빈 값일 수 있습니다.

반환된 채용 공고 레코드는 건당 0.8 SocQ 크레딧이 차감됩니다. 작업 결과가 비어 있으면 결과 요금이 부과되지 않습니다.