linkedin/
search-jobs

위치와 선택 제공자 필터로 공개 LinkedIn 채용 공고를 검색하고, 정규화된 직무, 회사, 장소, 고용 형태, 경력, 원격 근무, 급여, 시점 필드를 반환합니다.

LinkedIn Search Jobs API

위치 필수
구조화된 탐색
표준 채용 공고 레코드
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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 사용 방법

위치 기반 쿼리 하나를 제출하고, 비동기 작업을 폴링한 뒤, 반환된 결과 페이지를 모두 처리합니다.

  1. 필수 위치를 정하고, 해석 방식을 직접 테스트해 본 제공자 필터 값만 추가합니다.
  2. 쿼리를 /v1/linkedin/search-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/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 true

LinkedIn Search Jobs API 추천 활용 사례

  • 지역별 직무 탐색: 일관된 직무·위치 쿼리로 공개 공고를 수집하고, 이후 비교를 위해 수집 시각을 보관합니다.
  • 고용주·직무 검토: 반환된 표본에 어떤 고용주, 직함, 장소, 근무 방식, 경력 수준, 고용 형태가 나타나는지 살펴봅니다.
  • 급여 공개 여부 파악: 급여 정보를 공개한 공고를 식별하고, 누락된 보상 정보는 명시적인 null로 보존합니다.
  • 채용 워크플로 유입: 정규화된 공개 공고 URL과 필드를 검토, 중복 제거, 알림, 후속 분석 워크플로에 전달합니다.

LinkedIn Search Jobs API 활용 팁

  • 제공자별 필터 표기는 반복 실행 워크플로에 넣기 전에 작은 쿼리로 먼저 테스트하세요.
  • 지역이나 날짜를 비교할 때는 같은 필터와 수집 일정을 사용하세요.
  • 갱신되거나 겹치는 검색에서 같은 채용 건이 나올 수 있으므로, 안정적인 채용 공고 id 또는 공고 URL로 중복을 제거하세요.
  • 원격 근무 표시는 원본 신호로 보고, 지리·거주지·시간대 제약은 설명 본문에서 확인하세요.
  • 공고 시점과 조회 시점이 혼동되지 않도록 published_at, expires_at, collected_at을 구분해 보관하세요.
  • 빈 결과는 여러 수집 결과 중 하나일 뿐, 조건에 맞는 공개 채용 공고가 없다는 증거로 보지 마세요.

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에서 공개 게시물을 찾으며, 텍스트, 작성자 맥락, 미디어, 해시태그, 타임스탬프, 공개된 참여도를 포함합니다.

다른 플랫폼 둘러보기

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

LinkedIn Search Jobs API — 자주 묻는 질문

LinkedIn Search Jobs API는 필수 위치와 선택 제공자 필터로 공개 LinkedIn 채용 공고를 찾는 프로그래밍 인터페이스입니다. 수집 시점에 조회 가능한 공고의 정규화된 직무, 회사, 위치, 고용 형태, 경력, 원격 근무, 급여, 시점 필드를 반환합니다.

location은 필수이며 비어 있지 않은 문자열이어야 합니다. 키워드, 회사 등 다른 선택 필터만 제공하면 현재 검증을 통과하지 못합니다.

아니요. SocQ는 비어 있지 않은 필터 문자열을 허용되는 표기와 조합을 정의하거나 변환하지 않고 탐색 제공자에게 그대로 전달합니다.

아니요. 1부터 2000까지의 정수 상한이며 기본값은 100입니다. 공개 여부, 필터 조합, 페이지네이션, 중복, 제공자 동작에 따라 더 적은 레코드가 반환될 수 있습니다.

아니요. 각 결과는 수집 시점의 공개 레코드입니다. 조치하기 전에 공고에서 지원 상태, 담당 업무, 근무지 제약, 보상 정보를 직접 확인하세요.

아니요. 이 엔드포인트는 지원, 공고 저장, 알림 생성, 지원자 조회, Recruiter 접근, 맞춤 매칭 점수 제공을 하지 않습니다.

반환된 채용 공고 레코드 1건당 0.5 SocQ 크레딧이 차감되며 기본 요금은 없습니다. 기본 예상치는 결과 100건이고, 빈 결과에는 결과 요금이 없으며, 허용되는 경우 실제 사용량이 예상치를 넘을 수 있습니다.