KOSME 중소벤처기업진흥공단

전체메뉴 열기 전체메뉴 닫기

Open API 채용정보 API

채용목록

채용정보 API를 이용하여 다양한 카테고리의 구인정보를 구성할 수 있습니다.

영리법인(개인 사업자)은 이용약관상 채용정보 API를 사용할 수 없습니다.

채용목록

1.1 요청 URL

https://118.67.151.173/data/api/jopblancApi.do

기본검색(필수 입력 예)

https://118.67.151.173/data/api/jopblancApi.do?authKey=[인증키]&callTp=L

다중검색(다중검색 입력 예)

https://118.67.151.173/data/api/jopblancApi.do?authKey=[인증키]&callTp=L&emplymStleCode=[고용형태코드1,고용형태코드2]

요청 parameter 입력 시, 대괄호 [ ]는 제외합니다.

1.2 요청 parameter
요청 parameter
항목 타입 필수여부 설명
authKey String Y 인증키
callTp String Y 호출할 페이지 타입을 반드시 설정합니다.(L: 목록, D:상세)
startCount Number   기본값 0, 최대 1000 검색 시작위치를 지정할 수 있습니다.
최대 1000 까지 가능합니다.
listCount Number   출력건수, 기본값 10, 최대 100 까지 가능합니다.
sField String   필드명
  • ENTRPRS_NM : 기업명
  • PBLANC_SJ : 공고제목
  • JSSFC_STR : 직종
  • AREA_STR : 근무지역
  • EMPLYM_STLE_SE_STR : 고용형태
  • DTY_STR : 직무
query String   검색어
  • 검색연산자 사용
    - 스페이스(공백) : AND 조건 (ex. 검색 엔진)
    - | : OR 조건 (ex. 검색|엔진)
    - ! : NOT 조건 (ex. 검색 !엔진)
jssfcCode String   직종코드

단계별로 콤마로 구분하여 입력
ex) jssfcCode=100 , jssfcCode=100,105 ....

indutyCode String   업종코드

단계별로 콤마로 구분하여 입력
ex) indutyCode=100 , indutyCode=100,105 ....

areaCode String   지역코드

단계별로 콤마로 구분하여 입력
ex) areaCode=100 , areaCode=100,105 ....

dtyCode String   직무코드

단계별로 콤마로 구분하여 입력
ex) dtyCode=100 , dtyCode=100,105 ....

career String   (다중검색 가능)
경력
  • 신입
  • 2년이하
  • 3~5년 이하
  • 6~9년 이하
  • 10~15년 이하
  • 16~20년 이하
  • 21년 이상
  • 경력무관
ex) career=2년이하, career=신입,2년이하 ....
lastAcdmcrCode String   (다중검색 가능)
학력
  • 40 : 고등학교 재학/졸업
  • 50 : 대학교(2,3년) 재학/졸업
  • 60 : 대학교(4년) 재학/졸업
  • 70 : 석사
  • 80 : 박사
  • 99 : 학력무관
ex) lastAcdmcrCode=40 , lastAcdmcrCode=40,50 …
emplymStleCode String   (다중검색 가능)
고용형태
  • 1 : 정규직
  • 2 : 계약직
  • 3 : 병역특례
  • 4 : 인턴
  • 5 : 파견직
  • 7 : 알바
  • 8 : 프리랜서
  • 13 : 위촉직
ex) emplymStleCode=1 , emplymStleCode=1,2....
anslryAmount String  

급여별

반드시 from, to 2개를 콤마로 구분하여 입력
(1개만입력시 조건 안됨)
ex) anslryAmount=2000,2500 …

salaryCodeNm String  

최대급여
※ 급여조건 없을시 조건 안됨

  • 연봉
  • 월급
  • 주급
  • 일급
  • 시급
  • 건별

ex) salaryCodeNm=연봉 , salaryCodeNm=월급 …
exclnc String   (다중검색 가능)
기업인증구분(전용채용관)
  • 1 : 우수기업
  • 2 : 내일채움공제가입 우수기업
  • 3 : 강소기업
  • 4 : 참괜찮은 중소기업
  • 5 : 이노비즈 인증기업
  • 6 : 메인비즈 인증기업
  • 7 : 벤처기업
  • 8 : 인재육성 중소기업
  • 9 : 중진공 우수기업
  • 10 : 이달의 우수기업

콤마로 구분하여 입력
ex) exclnc=1 , exclnc=2 , exclnc=1,2 ….

1.3 출력결과
출력결과
항목 타입 설명
<SearchQueryResult>
<total> String 총건수 </total>
<startCount> String 기본값 0, 최대 1000
검색의 시작위치를 지정 할 수 있습니다.		 </startCount>
<listCount> String 출력건수, 기본값 10 </listCount>
<jobList>
<jopblancIdx> String 구인공고번호 </jopblancIdx>
<entrprsNm> String 기업명 </entrprsNm>
<pblancSj> String 공고명 </pblancSj>
<jssfcStr> String 직종 </jssfcStr>
<areaStr> String 근무지역 </areaStr>
<emplymStleSeStr> String 고용형태 </emplymStleSeStr>
<dtyStr> String 직무 </dtyStr>
<indutyStr> String 업종 </indutyStr>
<salaryPymntMthCodeNm> String 급여지급방법 </salaryPymntMthCodeNm>
<anslryLwltAmount> String 최소임금액 </anslryLwltAmount>
<anslryUplmtAmount> String 최대임금액 </anslryUplmtAmount>
<rceptBeginDe> String 접수시작일자 </rceptBeginDe>
<rceptEndDe> String 접수종료일자 </rceptEndDe>
<lastAcdmcrCodeNm> String 최소학력 </lastAcdmcrCodeNm>
<career> String 경력 </career>
<exclncEntrprsAt> String 우수기업 인증여부 코드
  • 0 : 미인증
  • 1 : 인증
 </exclncEntrprsAt>
<sbcplanExclncEntrprsAt> String 내일체움공제가입 우수기업 인증여부 코드
  • 0 : 미인증
  • 1 : 인증
 </sbcplanExclncEntrprsAt>
<smallgiantsEntrprsAt> String 강소기업 인증여부 코드
  • 0 : 미인증
  • 1 : 인증
 </smallgiantsEntrprsAt>
<gsmbEntrprsAt> String 참괜찮은 중소기업 인증여부 코드
  • 0 : 미인증
  • 1 : 인증
 </gsmbEntrprsAt>
<innobizEntrprsAt> String 이노비즈 인증기업 인증여부 코드
  • 0 : 미인증
  • 1 : 인증
 </innobizEntrprsAt>
<mainbizEntrprsAt> String 메인비즈 인증기업 인증여부 코드
  • 0 : 미인증
  • 1 : 인증
 </mainbizEntrprsAt>
<vnentrEntrprsAt> String 벤처기업 인증여부 코드
  • 0 : 미인증
  • 1 : 인증
 </vnentrEntrprsAt>
<mmdistUnbrngSmlmdmEntrprsAt> String 인재육성 중소기업 인증여부 코드
  • 0 : 미인증
  • 1 : 인증
 </mmdistUnbrngSmlmdmEntrprsAt>
<kosmeExclncEntrprsAt> String 중진공 우수기업 인증여부 코드
  • 0 : 미인증
  • 1 : 인증
 </kosmeExclncEntrprsAt>
<thsmonExclncentrprsAt> String 이달의 우수기업 인증여부 코드
  • 0 : 미인증
  • 1 : 인증
 </thsmonExclncentrprsAt>
<date> String 등록일자 </date>
</jobList>
</SearchQueryResult>
1.4 오류메세지
오류메세지
오류코드 에러메세지 설명
00 NORMAL CODE 정상
01 INVALID REQUEST PARAMETER ERROR 잘못된 요청 파라미터
02 NO MANDATORY REQUEST PARAMETERS ERROR 필수 요청 파라미터 없음
03 SERVICE KEY IS NOT REGISTERED ERROR 등록되지 않았거나 사용할 수 없는 인증키
04 DEADLINE HAS EXPIRED ERROR 기한만료된 인증키
05 UNREGISTERED IP DOMAIN ERROR 등록되지 않은 IP 혹은 도메인 주소
  • 열기
  • top
  • top