채용공고 조회 API 및 필드

채용공고(구인) 조회 API는 채용공고 조회를 위한 데이타를 제공합니다.

Summary

Overview

채용공고 API 는 사람인에 등록된 채용공고의 자세한 정보를 제공합니다.

요청 변수(Request Parameters)

매개변수 데이타 형식 설명
id integer: 필수 채용공고 번호
fields string: 콤마로 구분 필드 선택
  • posting-date: 날짜/시간 형식의 게시일시
  • expiration-date: 날짜/시간 형식의 마감일시

별도로 명시하지 않는 한:

  • 변수명은 대소문자를 구분하며, 입력값은 대소문자를 구분하지 않습니다.
  • 여러 단어는 공백으로 구분합니다. 주소표시줄에서는 URL이 인코드되어 %20 또는 +로 변경 됩니다. (예: PHP%20MySQL, PHP+MySQL)
  • 하나의 매개변수에서 공백으로 구분한 여러 값은 모두 포함하여 검색되며, 다른 매개변수는 모든 조건을 만족하는 결과만 출력 합니다.
  • 와일드카드(*, ?)와 AND/OR 는 지원하지 않습니다.

출력 필드(Output Fields)

필드 선택으로 아래에 목록중에서 특정 필드를 선택 해서 받을 수 있습니다.

Job Elements

각 job 요소는 채용공고 목록을 포함하고 있습니다.

Element Definition
id 기본 제공. The unique identifier for a job.
url 기본 제공. 채용공고 표준 URL. 공채속보의 경우, 리디렉션이 있을 수 있습니다.
active 기본 제공. 공고 진행 여부(1: 진행중, 0: 마감)
posting-timestamp 기본 제공. 게시일의 Unix timestamp 값.
posting-date 선택 제공. 날짜/시간 형식의 게시일 (2011-01-13T13:15:17+09:00)
modification-timestamp 기본 제공. 수정일 Unix timestamp 값.
opening-timestamp 기본 제공. 접수 시작일의 Unix timestamp 값.
expiration-timestamp 기본 제공. 마감일의 Unix timestamp 값.
expiration-date 선택 제공. 날짜/시간 형식의 마감일
close-type 기본 제공. 마감일 형식(1: 접수 마감일; 2: 채용시; 3: 상시; 4: 수시;)
company:name 기본 제공. 기업명
company:name@href 기업정보 페이지(공개되어 있는 경우)
position:title 기본 제공. 공고 제목
position:location 기본 제공. 지역 (@code: 지역코드)
position:job-type 기본제공, 근무형태, 기본제공 (@code, 쉼표/comma로 구분됨, 근무형태코드 참고)
position:industry 기본제공, 업종 (@code, 쉼표로 구분됨) 업종 코드표 참고
position:job-category 기본제공, 직종 (@code, 쉼표로 구분됨) 직종 코드표 참고
position:industry-keyword-code 업종 키워드 코드 (@code, 쉼표로 구분됨) 업종 키워드 코드표 참고
position:job-category-keyword-code 직종 키워드 (@code, 쉼표로 구분됨) 직종 키워드 코드표 참고
position:open-quantity 기본제공, 모집인원
position:experience-level 기본제공, 경력 (@min: 최소경력, @max: 최대경력)
position:experience-level@code 기본제공, 경력코드 (1:신입, 2: 경력, 3: 신입/경력, 0: 경력무관)
position:required-education-level 기본제공, 학력, 학력 코드표 참고
keyword 기본제공, 키워드 (쉼표로 구분됨)
read-cnt 조회수, fields=count
apply-cnt 지원자수, fields=count
reply-cnt 댓글수, fields=count
salary 기본제공, 연봉 (@code) 연봉 범위 코드표 참고

Sample XML

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<job-search>
  <jobs count="1" start="0" total="1">
    <job>
      <id>10671680</id>
      <url>http://www.saramin.co.kr/zf_user/recruit/recruit-view/idx/10671680</url>
      <active>1</active>
      <posting-timestamp>1323130746</posting-timestamp>
      <modification-timestamp>1323219482</modification-timestamp>
      <opening-timestamp>1322578800</opening-timestamp>
      <expiration-timestamp>1323130746</expiration-timestamp>
      <close-type code="1">접수마감일</closing_dt>
      <company>
        <name href="http://www.saramin.co.kr/zf_user/bbs-tong/view/com_idx/5601"><![CDATA[(주)사람인HR]]></name>
      </company>
      <position>
        <title><![CDATA[사람인HR 콘텐츠기획팀 인턴십 채용]]></title>
        <location code="101070"><![CDATA[서울 &gt; 구로구]]></location>
        <job-type code="11,4">인턴직,인턴직 (정규직 전환가능)</job-type>
        <industries code="305">포털·인터넷</industries>
        <job-category code="108,403,415">사무보조·OA, 웹기획·PM, IT강의·교육</job-category>
        <open-quantity>0</open-quantity>
        <experience-level>신입</experience-level>
        <required-education-level code="8">대학교졸업(4년)이상</required-education-level>
      </position>
      <keyword>종합포털,컨텐츠제공,취업포털,사무보조,OA,워드·문서작성,Excel·도표,PowerPoint,전산입력·편집,홈페이지관리,웹기획,자료조사,게시판관리,컨텐츠관리,OA·컴퓨터</keyword>
      <salary code="0">회사내규에 따름</salary>
    </job>
  </jobs>
</job-search>

관련 링크