공고 번호 검색 API 가이드

공고 번호 검색 API(Job Search API)는 사람인에 등록된 채용공고를 공고번호로 검색할 수 있습니다.

메소드 GET
요청 URI https://oapi.saramin.co.kr/job-search

요청 헤더 (Request Header)

응답 방식을 선택하여 넣어주세요.
Header name Header value
Accept
  • XML로 응답 : application/xml
  • JSON로 응답 : application/json

요청 변수(Request Parameters)

필수 : 필수 입력 값
복수 검색 : 공백과 , 로 구분합니다. 예: PHP%20MySQL, PHP+MySQL, PHP,MySQL
변수명 형식 설명
필수 access-key string 앱 등록 후 발급받은 키
id string 공고 번호
fields string 복수 검색 필드 선택
  • posting-date: 날짜/시간 형식의 게시일시
  • expiration-date: 날짜/시간 형식의 마감일시
  • keyword-code: 업직종 키워드(상세분류) 코드
  • count: 조회수/지원자수

SAMPLE URL

요청 URI https://oapi.saramin.co.kr/job-search?access-key={KEY}&id=36315100

응답 형태(Response type)

출력 결과(Response Elements)

Element Definition
job-search
jobs
count job 엘리먼트 개수
start 검색 결과의 페이지 번호
total 총 검색 결과 수
job 채용공고 엘리먼트
id 공고 번호
url 채용공고 표준 URL. 공채속보의 경우, 리디렉션이 있을 수 있습니다.
active 공고 진행 여부
  • 1 : 진행중
  • 0 : 마감
posting-timestamp 게시일의 Unix timestamp
선택 posting-date 날짜/시간 형식의 게시일 (2019-07-07T17:17:17+0900)
fields=posting-date
modification-timestamp 수정일 Unix timestamp
opening-timestamp 접수 시작일의 Unix timestamp
expiration-timestamp 마감일의 Unix timestamp
선택 expiration-date 날짜/시간 형식의 마감일
fields=expiration-date
close-type 마감일 형식
  • 1 : 접수 마감일
  • 2 : 채용시
  • 3 : 상시
  • 4 : 수시
company
name 기업명
name@href 기업정보 페이지 (공개되어 있는 경우)
position
title 공고 제목
location 지역 코드, 지역명 (@code: 지역코드)
job-type 근무형태 코드, 근무형태명 (@code: 근무형태코드) 코드표
industry 업종코드, 업종명 (@code: 업종코드) 코드표
job-mid-code 상위 직무코드, 직무명 (@code: 상위 직무코드) 코드표
job-code 직무 코드, 직무명 (@code: 직무코드) 코드표
선택 industry-keyword-code 업종 코드 코드표
fields=keyword-code
선택 job-code-keyword-code 직무 키워드 코드표
fields=keyword-code
experience-level 경력 (@min: 최소경력, @max: 최대경력)
experience-level (@code: 경력코드) 경력코드
  • 1 : 신입
  • 2 : 경력
  • 3 : 신입/경력
  • 0 : 경력무관
required-education-level 학력 코드표
keyword 키워드 (쉼표로 구분됨)
선택 read-cnt 조회수
fields=count
선택 apply-cnt 지원자수
fields=count
salary 연봉 (@code: 연봉 코드) 코드표

Sample Output XML

                    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <job-search>
    <jobs count="1" start="0" total="95870">
      <job>
        <id>36314892</id>
        <url>
          http://www.saramin.co.kr/zf_user/jobs/relay/view?rec_idx=36314892&utm_source=job-search-api&utm_medium=api&utm_campaign=saramin-job-search-api
        </url>
        <active>1</active>
        <posting-timestamp>1559182220</posting-timestamp>
        <posting-date>2019-05-30T11:10:20+09:00</posting-date>
        <modification-timestamp>1559182220</modification-timestamp>
        <opening-timestamp>1559181600</opening-timestamp>
        <expiration-timestamp>1988118000</expiration-timestamp>
        <close-type code="2">채용시</close-type>
        <company>
          <name href="http://www.saramin.co.kr/zf_user/company-info/view?csn=123123123#utm_source=job-search-api&utm_medium=api&utm_campaign=saramin-job-search-api">
            <![CDATA[ 한스컨설팅 ]]>
          </name>
        </company>
        <position>
          <title>
            <![CDATA[ 판교 위치 온라인 MMORPG게임 인사팀 채용 과장급 ]]>
          </title>
          <location code="102190">
            <![CDATA[ 경기 > 성남시 분당구 ]]>
          </location>
          <job-type code="1">정규직</job-type>
          <industry code="314">게임</industry>
          <job-mid-code code="22">IT개발·데이터</job-mid-code>
          <job-code code="2072,2093,2106,2107">게임개발,기술지원,네트워크</job-code>
          <experience-level code="2" min="6" max="10">경력 6~10년</experience-level>
          <required-education-level code="8">대학교졸업(4년)이상</required-education-level>
        </position>
        <keyword>
          3D온라인게임,RPG,게임,게임개발,게임기획·마케팅,HRD·HRM,온라인게임,인사,인사기획,인사평가,채용·면접
        </keyword>
        <salary code="18">5,000~6,000만원</salary>
      </job>
    </jobs>
  </job-search>

에러 출력 결과(Error Response Elements)

Element Definition
result
code
  • 1 : access-key 미입력
  • 2 : 유효하지 않은 access-key
  • 3 : 유효하지 않은 request param
  • 4 : 일일 최대 요청 가능 횟수 초과
  • 99 : 오류 발생
message 오류 메시지

Sample Output XML

            <result>
  <code>2</code>
  <message>사용 불가능한 access-key 입니다. </message>
</result>

출력 결과(Response Elements)

Element Definition
jobs
count job 엘리먼트 개수
start 검색 결과의 페이지 번호
total 총 검색 결과 수
job 채용공고 엘리먼트
url 채용공고 표준 URL. 공채속보의 경우, 리디렉션이 있을 수 있습니다.
active 공고 진행 여부
  • 1 : 진행중
  • 0 : 마감
company
detail
href 기업정보 페이지 (공개되어 있는 경우)
name 기업명
position
title 공고 제목
industry 업종 코드표
code 업종 코드
name 업종명
location 지역
code 지역 코드
name 지역명
job-type 근무형태 코드표
code 근무형태 코드
name 근무형태 값
job-mid-code 상위 직무 코드표
code 상위 직무 코드
name 상위 직무명
job-code 직무 코드표
code 직종 코드
name 직무명
선택 industry-keyword-code 업종 키워드 코드 코드표
fields=keyword-code
선택 job-code-keyword-code 직무 키워드 코드표
fields=keyword-code
experience-level 경력
code 경력 코드
  • 1 : 신입
  • 2 : 경력
  • 3 : 신입/경력
  • 0 : 경력무관
min 경력 최소 값
max 경력 최대 값
name 경력 값
required-education-level 학력 코드표
code 학력 코드
name 학력 값
id 공고 번호
posting-timestamp 게시일의 Unix timestamp
선택 posting-date 날짜/시간 형식의 게시일 (2021-07-13T13:15:17+0900)
fields=posting-date
modification-timestamp 수정일 Unix timestamp
opening-timestamp 접수 시작일의 Unix timestamp
expiration-timestamp 마감일의 Unix timestamp
선택 expiration-date 날짜/시간 형식의 마감일
fields=expiration-date
close-type 마감일 형식
code 마감일 코드
  • 1 : 접수 마감일
  • 2 : 채용시
  • 3 : 상시
  • 4 : 수시
name 마감일 값
keyword 키워드
선택 read-cnt 조회수
fields=count
선택 apply-cnt 지원자수
fields=count
salary 연봉 코드표
code 연봉 코드
name 연봉 값

Sample Output JSON

                    {
  "jobs": {
    "count": 1,
    "start": 1,
    "total": "7629",
    "job": [
      {
        "url": "http://www.saramin.co.kr/zf_user/jobs/relay/view?rec_idx=25613683&utm_source=job-search-api&utm_medium=api&utm_campaign=saramin-job-search-api",
        "active": 1,
        "company": {
          "detail": {
            "href": "http://www.saramin.co.kr/zf_user/company-info/view?csn=2118849391&utm_source=job-search-api&utm_medium=api&utm_campaign=saramin-job-search-api",
            "name": "비안어소시에이츠"
          }
        },
        "position": {
          "title": "[멜팅샵] [테이스팅룸] [신규브랜드] 메뉴개발",
          "industry": {
            "code": "109",
            "name": "외식업·식음료"
          },
          "location": {
            "code": "101210",
            "name": "서울 > 용산구"
          },
          "job-type": {
            "code": "1",
            "name": "정규직"
          },
          "job-mid-code": {
            "code": "22",
            "name": "요리·제빵사·영양사"
          },
          "job-code": {
            "code": "2323",
            "name": "요리·제빵사·영양사"
          },
          "experience-level": {
            "code": 0,
            "min": 0,
            "max": 0,
            "name": "경력무관"
          },
          "required-education-level": {
            "code": "2",
            "name": "대학졸업(2,3년)"
          }
        },
        "keyword": "양식당,이태리요리,일식당,프랑스요리,한식당,양식,요리사,일식,제과·제빵사,한식",
        "salary": {
          "code": "99",
          "name": "면접후 결정"
        },
        "id": "25613683",
        "posting-timestamp": "1450104112",
        "posting-date": "2015-12-14T23:41:52+0900",
        "modification-timestamp": "1463703302",
        "opening-timestamp": "1450101600",
        "expiration-timestamp": "1988118000",
        "expiration-date": "2033-01-01T00:00:00+0900",
        "close-type": {
          "code": "2",
          "name": "채용시"
        },
        "read-cnt": "8459",
        "apply-cnt": "1188"
      }
    ]
  }
}

에러 출력 결과(Error Response Elements)

Element Definition
result
code
  • 1 : access-key 미입력
  • 2 : 유효하지 access-key
  • 3 : 유효하지 request param
  • 4 : 일일 최대 요청 가능 횟수 초과
  • 99 : 오류 발생
message 오류 메시지

Sample Output JSON

            {
  "code": 1,
  "message": "access-key를 입력해 주세요."
}