채용 공고 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 앱 등록 후 발급받은 키
keywords string 기업명, 공고명, 업직종 키워드, 직무내용에서 검색하고자 하는 검색어
bbs_gb integer 공채구분
  • 1 : 공채속보
stock string 복수 검색 상장여부
  • kospi : 유가증권
  • kosdaq : 코스닥
  • konex : 코넥스
sr string 복수 검색 제외 설정
  • directhire : 헤드헌팅/파견업체 공고 제외
loc_cd string 복수 검색 근무지/지역 조건 코드표
loc_mcd string 복수 검색 1차 근무지/지역 조건 코드표
loc_bcd string 복수 검색 2차 근무지/지역 조건 코드표
ind_cd string 복수 검색 산업/업종 조건 코드표
job_mid_cd string 복수 검색상위 직무 코드 코드표
job_cd string 복수 검색 직무 코드 코드표
job_type string 복수 검색 근무형태/고용형태 조건(1-15) 코드표
edu_lv string 복수 검색 학력 조건(0-9) 코드표
fields string 복수 검색 필드 선택
  • posting-date : 날짜/시간 형식의 게시일시
  • expiration-date : 날짜/시간 형식의 마감일시
  • keyword-code : 업직종 키워드(상세분류) 코드
  • count : 조회수/지원자수
published date 등록일 검색
(ex. 2019-03-20)
published_min datetime|timestamp 등록일시 검색 최소값
(ex. 2019-03-20 19:55:00 | Unix timestamp)
published_max datetime|timestamp 등록일 검색 최대값
updated date 수정일 검색
(ex. 2019-03-20)
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: 지원자수 역순

별도로 명시하지 않는 한:

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

SAMPLE URL

  • https://oapi.saramin.co.kr/job-search?access-key={KEY}&keywords=웹+퍼블리셔
  • https://oapi.saramin.co.kr/job-search?access-key={KEY}&bbs_gb=1
  • https://oapi.saramin.co.kr/job-search?access-key={KEY}&stock=kospi+kosdaq
  • https://oapi.saramin.co.kr/job-search?access-key={KEY}&ind_cd=40101+40102&fields=keyword-code
  • https://oapi.saramin.co.kr/job-search?access-key={KEY}&published=2019-05-28&start=2&count=100
  • https://oapi.saramin.co.kr/job-search?access-key={KEY}&published=2019-05-08

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

응답 형태(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="10" 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>
        ...
      </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": 2,
    "start": 1,
    "total": "7629",
    "job": [
      {
        "url": "http://www.saramin.co.kr/zf_user/jobs/relay/view?rec_idx=27614114&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=1138600917&utm_source=job-search-api&utm_medium=api&utm_campaign=saramin-job-search-api",
            "name": "(주)사람인"
          }
        },
        "position": {
          "title": "(주)사람인 사무보조·문서작성 경력 채용합니다11212",
          "industry": {
            "code": "301",
            "name": "솔루션·SI·ERP·CRM"
          },
          "location": {
            "code": "101050,101060,101070",
            "name": "서울 > 관악구,서울 > 광진구,서울 > 구로구"
          },
          "job-type": {
            "code": "1",
            "name": "정규직"
          },
          "job-mid-code": {
            "code": "22",
            "name": "요리·제빵사·영양사"
          },
          "job-code": {
            "code": "2323",
            "name": "요리·제빵사·영양사"
          },
          "experience-level": {
            "code": 2,
            "min": 2,
            "max": 3,
            "name": "경력 2~3년"
          },
          "required-education-level": {
            "code": "0",
            "name": "학력무관"
          }
        },
        "keyword": "SI·시스템통합,Excel·도표,PowerPoint,전산입력·편집",
        "salary": {
          "code": "6",
          "name": "1,800~2,000만원"
        },
        "id": "27614114",
        "posting-timestamp": "1559191564",
        "posting-date": "2019-05-30T13:46:04+0900",
        "modification-timestamp": "1559191564",
        "opening-timestamp": "1559188800",
        "expiration-timestamp": "1561820399",
        "expiration-date": "2019-06-29T23:59:59+0900",
        "close-type": {
          "code": "1",
          "name": "접수마감일"
        },
        "read-cnt": "0",
        "apply-cnt": "0"
      },
      {
        "url":"http://www.saramin.co.kr/zf_user/jobs/relay/view?rec_idx=27614112&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=1138600917&utm_source=job-search-api&utm_medium=api&utm_campaign=saramin-job-search-api",
            "name": "(주)사람인테스트계정04"
          }
        },
        "position": {
          "title": "건축·인테리어·설계 외 2개 부문 담당자 모집 공고123",
          "industry": {
            "code": "1005",
            "name": "연구소·컨설팅·조사"
          },
          "location": {
            "code": "101070",
            "name": "서울 > 구로구"
          },
          "job-type": {
            "code": "1",
            "name": "정규직"
          },
          "industry-keyword-code": "100501",
          "experience-level": {
            "code": 1,
            "min": 0,
            "max": 0,
            "name": "신입"
          },
          "required-education-level": {
            "code": "0",
            "name": "학력무관"
          }
        },
        "keyword": "연구소,전기공사,창호공사,항공사무",
        "salary": {
          "code": "4",
          "name": "1,400~1,600만원"
        },
        "id": "27614112",
        "posting-timestamp": "1559175921",
        "posting-date": "2019-05-30T09:25:21+0900",
        "modification-timestamp": "1559175921",
        "opening-timestamp": "1559174400",
        "expiration-timestamp": "1561820399",
        "expiration-date": "2019-06-29T23:59:59+0900",
        "close-type": {
          "code": "1",
          "name": "접수마감일"
        },
        "read-cnt": "0",
        "apply-cnt": "0"
      }
    ]
  }
}
                

에러 출력 결과(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를 입력해 주세요."
}