취업 검색 API

취업 검색 API(Job Search API)는 사람인에 등록된 채용정보를 검색할 수 있습니다.

요약

URL 작성 도구를 이용하면 취업 검색 API 맞는 URL을 생성 할 수 있습니다.

개요

키워드, 회사명 또는 다른 기준으로 채용정보를 검색하는데 취업 검색 API를 사용합니다. 검색 조건과 일치하는 결과를 얻을 수 있습니다. 각 항목에서 채용정보 리스트에서 사용할 수 있는 대부분의 정보를 포함할 수 있습니다.

아래는 취업 검색 API를 이용하는 몇가지 기본적이 예제 입니다.


<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<job-search>
  <jobs count="5" start="0" total="5">
    <job>
      <id>10671680</id>
      <url>http://www.saramin.co.kr/zf_user/recruit/recruit-view/idx/10671680</url>
      <active>1</active>
      <posting-timestamp>1322619010</posting-timestamp>
      <modification-timestamp>1322646519</modification-timestamp>
      <opening-timestamp>1322578800</opening-timestamp>
      <expiration-timestamp>1322619010</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>
    ...
    </job>
  </jobs>
</job-search>

키워드, 상장여부, 위치 등과 같은 매개 변수를 제공하여 검색 할 수 있습니다.

매개 변수를 제공과 관련하여 구체적인 내용은 URL 작성 도구를 이용하여 확인할 수 있습니다.

요청 변수(Request Parameters)

별도로 명시하지 않는 한:

  • 변수명은 대소문자를 구분하며, 입력값은 대소문자를 구분하지 않습니다.
  • 여러 단어는 공백으로 구분합니다. 주소표시줄에서는 URL이 인코드되어 %20 또는 +로 변경 됩니다. (예: PHP%20MySQL, PHP+MySQL)
  • 하나의 매개변수에서 공백으로 구분한 여러 값은 모두 포함하여 검색되며, 다른 매개변수는 모든 조건을 만족하는 결과만 출력 합니다.
  • 와일드카드(*, ?)와 AND/OR 는 지원하지 않습니다.
변수명 형식 설명
keywords string 기업명, 공고명, 업직종 키워드, 직무내용에서 검색하고자 하는 검색어
bbs_gb integer 공채구분 (1: 공채속보)
stock string: 공백(+)으로 구분 상장여부(kospi: 유가증권; kosdaq: 코스닥)
sr string: 공백(+)으로 구분 제외/포함 설정
  • directhire: 헤드헌팅/파견업체 공고 제외
  • exjc: 제한 직종 공고 포함
loc_cd string: 공백(+)으로 구분 근무지/지역 조건, 근무지/지역 코드표 참조
loc_mcd string: 공백(+)으로 구분 근무지/지역 조건, 근무지/지역 1차 코드표 참조
loc_bcd string: 공백(+)으로 구분 근무지/지역 조건, 근무지/지역 2차 코드표 참조
ind_cd string: 공백(+)으로 구분 산업/업종 조건, 산업/업종 코드표업종 키워드 코드표 참조
job_category string: 공백(+)으로 구분 직업/직종 조건, 직업/직종 코드표직종 키워드 코드표 참조
job_type string: 공백(+)으로 구분 근무형태/고용형태 조건(1-15), 근무형태 코드표 참조
edu_lv string: 공백(+)으로 구분 학력 조건(0-9), 학력 코드표 참조
fields string: 공백(+)으로 구분 필드 선택
  • posting-date: 날짜/시간 형식의 게시일시
  • expiration-date: 날짜/시간 형식의 마감일시
  • keyword-code: 업직종 키워드(상세분류) 코드
  • count: 조회수/지원자수/댓글수
published date 등록일 검색 (ex. 2011-11-30)
published_min datetime 등록일시 검색 최소값 (ex. 2011-11-30 19:55)
published_min timestamp 등록일시 검색 최소값 (Unix timestamp)
published_max datetime|timestamp 등록일 검색 최대값
updated date 수정일 검색 (ex. 2011-11-30)
updated_min datetime|timestamp 수정일시 검색 최소값
updated_max datetime|timestamp 수정일시 검색 최대값
deadline string today: 오늘마감, tomorrow: 내일마감, -:마감된 공고
deadline datetime|timestamp 마감일시 검색 최소값
start integer 검색 결과 페이지 번호, 제로(0) 기반의 서수 번호 입니다. 기본값: 0
count integer 검색 결과 수, 기본값: 10, 최대값: 110
sort string 검색 결과의 정렬 순서
  • pd: 게시일 역순(기본값)
  • pa: 게시일순
  • ud: 최근수정순
  • ua: 수정일 정순
  • da: 마감일 정순
  • dd: 마감일 역순
  • rc: 조회수 역순
  • ac: 지원자수 역순
  • re: 답변수 역순

출력 결과(Response Elements)

Top-Level Elements

Element Definition
xml -
job-search 취업 검색 엘리먼트. 하위 엘리먼트: jobs

Jobs Elements

검색 결과의 메타 데이타를 포함 합니다.

엘리먼트/속성 Definition
@count job 엘리먼트 개수
@start 검색 결과의 페이지 번호
@total 총 검색 결과 수
job 채용공고 엘리먼트. 출력되는 필드 목록은 채용공고 조회 API 및 필드 참고

Sample Output XML

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<job-search>
  <jobs count="10" start="0" total="5460">
    <job>
      <id>10595284</id>
      <url>http://www.saramin.co.kr/zf_user/recruit/recruit-view/idx/10595284</url>
      <active>1</active>
      <posting-timestamp>1321841818</posting-timestamp>
      <modification-timestamp>1321841828</modification-timestamp>
      <opening-timestamp>1321801200</opening-timestamp>
      <expiration-timestamp>1321841818</expiration-timestamp>
      <close-type code="1">접수마감일</closing_dt>
      <company>
        <name><![CDATA[바다중공업(주)]]></name>
 
      </company>
      <position>
        <title><![CDATA[2011년 하반기 신입 및 경력사원 공개채용]]></title>
        <location code="110040"><![CDATA[경남 &gt; 김해시]]></location>
        <job-type code="1">정규직</job-type>
        <industries code=""></industries>
        <job-category code=""></job-category>
        <open-quantity>0</open-quantity>
        <experience-level>신입/경력</experience-level>
        <required-education-level code="6">고등학교졸업이상</required-education-level>
      </position>
      <keyword></keyword>
      <salary code="0">회사내규에 따름</salary>
    </job>
    <job>
    ...
    </job>
  </jobs>
</job-search>

관련 링크