Saramin 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	앱 등록 후 발급받은 키
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 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를 입력해 주세요."
}

채용 공고 API 가이드

요청 헤더 (Request Header)

요청 변수(Request Parameters)

SAMPLE URL

응답 형태(Response type)

출력 결과(Response Elements)

Sample Output XML

에러 출력 결과(Error Response Elements)

Sample Output XML

출력 결과(Response Elements)

Sample Output JSON

에러 출력 결과(Error Response Elements)

Sample Output JSON