도움말 - 인크루트 내일검색 - 취업정보 전문검색 내일검색

로그인
스크랩

검색

도움말 검색

자주 묻는 질문
문의답변처리
용어사전
회원정책
활용팁
검색서비스이용
열린API

내일검색 서비스는 채용정보 검색서비스로서, 열린 API는 채용정보 검색 서비스를 더 많은 사람들에게 유용하고 간편하게 제공 하고자 마련되었습니다. 사용을 위해서는 APIKey 등록을 하여 주시기 바랍니다. 제공되는 API 사용이 어려우신 분들은 '누구나 쉬운 API'을 이용하여 쉽고 편하게 사용할 수 있습니다.
1.	API 요청형식 - REST 형식을 따릅니다.
2.	API 응답형식 - XML, JSON, RSS 방식을 지원 합니다.
3.	API 인코딩 방식 - UTF-8 방식을 따르고 있습니다.

API key가 무엇인가요?

내일검색 API를 사용하려면 사용자 인증 키가 있어야 합니다. 사용된 API키를 참고로 API 사용에 대한 통계와 문제점을 기록하고 개선 합니다. 내일검색 API의 상업적 사용을 목적으로 한다면 담당자와 연락(Tel:02-2186-9259) 후 협의하여 주시기 바랍니다. 지금 API Key 발급을 신청하세요!!!

REST 요청형식이 무엇인가요?

REST는 REpresentational State Transfer의 약자로, 사용하기에 가장 단순한 요청 형식입니다. 이는 단순한 URL 요청방식을 따르며 HTTP GET 또는 POST 방식으로 요청을 보냅니다. API에서 사용하는 REST 방식 URL은 http://naeil.incruit.com/api/ 입니다. API가 정상적으로 응답하고 있는지 Test 하려면 다음과 같이 요청을 해보세요. http://naeilapi.incruit.com/api/?method=echo&apikey=userapikey REST 요청에 대한 기본 응답형식은 XML 형식 입니다. 응답에 대한 특정 형식 (XML.JSON,RSS) 을 지정하면 그에 대한 결과를 받을 수 있습니다.

API의 응답형식들(XML,RSS,JSON)에 대해 알려주세요

API 는 XML, JSON, RSS 3가지 형식을 지원하고 있습니다.

지속적으로 지원형식을 늘려나갈 계획 입니다.

XML

- XML (Extensible Markup Language) 형식의 출력결과를 지원 합니다.

- XML 에 대한 자세한 내용은 w3c/XML 을 참조바랍니다.


<?xml version="1.0" encoding="utf-8" ?> 
<channel>
	<TotalCount>1057</TotalCount> 
	<item>
	 ...
	</item>
	<item>
	 ...
	</item>	
	...
</channel>

JSON

- JSON (JavaScript Object Notation)은 간단한 데이터 교환 형식입니다.

- JSON에 대한 자세한 내용은 json.org 를 참조바랍니다.


{
	"channel": {
		"TotalCount":"2232",
		"item":[
				{...} ,
				{...} ,
				...
		]
	}
}

RSS

- RSS (Really Simple Syndication) 2.0 형식의 출력결과를 지원 합니다.

- RSS에 대한 자세한 내용은 RSS 2.0 을 참조바랍니다.


<?xml version="1.0" encoding="utf-8" ?> 
<rss version="2.0" xmlns:dc="http://purl.org/dc/elements/1.1/">
	<channel>
		<title>...</title>
		<link>...</link> 
		<language>...</language> 
		<description>...</description>
		<copyright>...</copyright> 
		<lastBuildDate>...</lastBuildDate> 
		<webMaster>...</webMaster>
		<item>
		...
		</item>
		<item>
		...
		</item>
		...
	</channel>
</rss>

채용검색 API

입력된 키워드에 따라 검색결과를 제공합니다.

다양한 필터링 조건값 설정으로 꼭 필요한 결과값을 얻을 수 있습니다.

요청 URL

- http://naeilapi.incruit.com/api/?method=search

요청 인자

인자	설 명	기 타
method	함수명 "method=search" (고정)	필수
apikey	발급받은 APIKey 값	필수
q	검색어	필수
out	출력 형식 지정	XML(기본) JSON RSS
start	반환될 결과 시작 번호 start=10 이면 10번째 결과값부터 반환됨	0 (기본)
count	반환 될 결과리스트 개수	10 (기본)
rgn1	조건설정-지역코드	전체 (기본) 서울 - 11 부산 - 12 대구 - 13 인천 - 14 광주 - 15 대전 - 16 울산 - 17 경기 - 18 강원 - 19 충북 - 20 충남 - 21 전북 - 22 전남 - 23 경북 - 24 경남 - 25 제주 - 26 특구 - 40 전국 - 59 해외 - 98 기타 - 99
sry	조건설정-급여코드	전체 (기본) 시급 3500원 미만 - 11 시급 3500~5000원 - 12 시급 5000~1만원 - 13 시급 1만원 이상 - 14 일급 3만원 미만 - 21 일급 3~5만원 - 22 일급 5만원 이상 - 23 주급 10만원 미만 - 31 주급 10~30만원 - 32 주급 30만원 이상 - 33 월급 50만원 미만 - 41 월급 50~100만원 - 42 월급 100만원 이상 - 43 건별 1~5만원 - 51 건별 5~10만원 - 52 건별 10만원 이상 - 53 연봉 1800만원 미만 - 61 연봉 1800~2400만원 - 62 연봉 2400~3000만원 - 63 연봉 3000~4000만원 - 64 연봉 4000~5000만원 - 65 연봉 5000~1억 - 66 연봉 1억 이상 - 67 회사 내규 - 98 면접후 결정 - 99
crr	조건설정-경력코드	전체 (기본) 경력무관 - 0 신입 - 1 1~2년 - 2 2~3년 - 3 3~5년 - 4 5~10년 - 5 10년이상 - 6
schol	조건설정-학력코드	전체 (기본) 고등학교졸업 - 10 대학(2,3년)졸업 - 13 대학교(4년)졸업 - 16 석사이상 - 22 박사이상 - 26 학력무관 - 99
scale	조건설정-기업규모	전체 (기본) 소기업 - 1 중기업 - 2 대기업 - 3 벤처기업 - 4 외국계/해외기업 - 5 정부/공공 - 6 교육기관 - 7
epty	조건설정-채용형태	전체 (기본) 정규직 - 1 계약직 - 2 병역특례 - 3 인턴 - 4 파견대행 - 5 헤드헌팅 - 6 아르바이트 - 7 프리랜서 - 8 생활직 - 9 기타 - 98

출력 항목

항목	설 명
TotalCount	총 검색 건수
Job_Tiitle	공고명
Employ_Ty_Nm	채용 방식 - 정규직, 계약직, 아르바이트 등을 의미
Comp_Nm	구인 회사명
Region_Nm	근무지 - 지역 큰 분류
Region_Det_Nm	근무지역 상세 - 지역 상세 정보
Subway_Str	근무지 인접 지하철역
Schol_Nm	학력
Career_Nm	경력 - 신입, 경력무관 등을 의미
Salary_Nm	급여
Job_Cont	구인 상세 내용
Cl_Invite_Start_Dt	구인 모집 시작일
Cl_Invite_Close_Dt	구인 모집 마갑일
Employ_limit	마감일 정보 - "채용시까지", "상시채용", "마감일"
Source_Site_Nm	Site 이름
Source_Site_Url	Site URL
Link_Url	구인정보 URL
Cl_Date	수집 날짜

결과 예제

<?xml version="1.0" encoding="utf-8" ?> <channel> 	 <TotalCount>12687</TotalCount> 	 <item> 		 <Job_Title> 		 <![CDATA[ 현대자동차 영업사원을 모집합니다. 		 ]]> 		 </Job_Title> 		 <Employ_Ty_Nm> 		 <![CDATA[ 정규직 		 ]]> 		 </Employ_Ty_Nm> 		 <Comp_Nm> 		 <![CDATA[ 현대자동차신천판매영업소 		 ]]> 		 </Comp_Nm> 		 <Region_Nm> 		 <![CDATA[ 서울 		 ]]> 		 </Region_Nm> 		 <Region_Det_Nm> 		 <![CDATA[ 송파구 		 ]]> 		 </Region_Det_Nm> 		 <Subway_Str> 		 <![CDATA[ 성내 		 ]]> 		 </Subway_Str> 		 <Schol_Nm> 		 <![CDATA[ 고등학교졸업 		 ]]> 		 </Schol_Nm> 		 <Career_Nm> 		 <![CDATA[ 경력무관 		 ]]> 		 </Career_Nm> 		 <Salary_Nm> 		 <![CDATA[ 		 ]]> 		 </Salary_Nm> 		 <Job_Cont> 		 <![CDATA[ 고객서비스 마인드 소유자 - 남자는 군필 및 면제자 - 타사 영업 경력자 및 일반영업 경력자 특별우대 - 초보자도 가능가능 * 서울시 송파, 광진, 강남, 서초, 강동, 경기 성남 인근거주자에 한함 ※ 자동차 영업에 의지가 있고 강한 행동력을 보유한 자 ※ ** ... 		 ]]> 		 </Job_Cont> 		 <Cl_Invite_Start_Dt> 		 <![CDATA[ 20071113 		 ]]> 		 </Cl_Invite_Start_Dt> 		 <Cl_Invite_Close_Dt> 		 <![CDATA[ 20071127 		 ]]> 		 </Cl_Invite_Close_Dt> 		 <Employ_Limit> 		 <![CDATA[ 마감일 		 ]]> 		 </Employ_Limit> 		 <Source_Site_Nm> 		 <![CDATA[ 인크루트 		 ]]> 		 </Source_Site_Nm> 		 <Source_Site_Url> 		 <![CDATA[ http://www.incruit.com/ 		 ]]> 		 </Source_Site_Url> 		 <Link_Url> 		 <![CDATA[ http://www.incruit.com/jobdb/02.asp?pid=584223&jid=2771379 		 ]]> 		 </Link_Url> 		 <Cl_Date> 		 <![CDATA[ 2007-11-14 01:09:41 		 ]]> 		 </Cl_Date> 	 </item> </channel>

비고/에러 메시지

100 : 성공

101 : 키없음

apikey 항목이 없습니다.

102 : 쿼리 없음

q 항목이 없습니다.

103 : 메소드명 없음

method 항목이 없습니다.

104 : 유효하지 않은 메소드

정의되지 않은 method 입니다.

200 : 존재하지 않는 키

201 : 키 유효일자가 지났음

102 : 쿼리 없음

q 항목이 없습니다.

400 : Bad Request

요청실패문법상 오류가 있어, 서버가 요청사항을 이해하지 못함

401 : Unauthenticated

권한 없음 (접속실패)이 에러는 서버에 로그온 하려는 요청사항이 서버에 들어있는 권한과 비교했을 때 맞지 않음

403 : Forbidden

금지(수행접근 금지)

404 : Not Found

문서를 찾을 수 없음.웹 서버가 요청한 파일이나 스크립트를 찾지 못함

409 : Conflict

500 : Internal Server Error

서버 내부 오류

501 : Not Implemented Not Implemented

502 : Bad gateway

게이트웨이 상태 나쁨/서버의 과부하 상태

503 : Service Unavailable

외부 서비스가 죽었거나 현재 멈춘 상태 또는 이용할 수 없는 서비스

인기검색어 API

채용정보 인기검색어를 제공 합니다.

요청 URL

- http://naeilapi.incruit.com/api/?method=hotword

요청 인자

인자	설 명	기 타
method	함수명 "method=hotword" (고정)	필수
apikey	발급받은 APIKey 값	필수
out	출력 형식 지정	XML(기본) JSON RSS

출력 항목

항목	설 명
ExtractDate	인기 검색어 생성 기간
Rank	순위
Keyword	인기검색어

결과 예제

비고/에러 메시지

100 : 성공

101 : 키없음

apikey 항목이 없습니다.

103 : 메소드명 없음

method 항목이 없습니다.

104 : 유효하지 않은 메소드

정의되지 않은 method 입니다.

200 : 존재하지 않는 키

201 : 키 유효일자가 지났음

400 : Bad Request

요청실패문법상 오류가 있어, 서버가 요청사항을 이해하지 못함

401 : Unauthenticated

권한 없음 (접속실패)이 에러는 서버에 로그온 하려는 요청사항이 서버에 들어있는 권한과 비교했을 때 맞지 않음

403 : Forbidden

금지(수행접근 금지)

404 : Not Found

문서를 찾을 수 없음.웹 서버가 요청한 파일이나 스크립트를 찾지 못함

409 : Conflict

500 : Internal Server Error

서버 내부 오류

501 : Not Implemented Not Implemented

502 : Bad gateway

게이트웨이 상태 나쁨/서버의 과부하 상태

503 : Service Unavailable

외부 서비스가 죽었거나 현재 멈춘 상태 또는 이용할 수 없는 서비스

echo API

API 서비스의 정상적 응답을 확인 합니다.

요청 URL

- http://naeilapi.incruit.com/api/?method=echo

요청 인자

인자	설 명	기 타
method	함수명 "method=echo" (고정)	필수
apikey	발급받은 APIKey 값	필수
out	출력 형식 지정	XML(기본) JSON

출력 항목

항목	설 명
Response	확인 정보
status	상태
returntime	응답시간

결과 예제

[누구나 쉬운 API] '간단검색창'은 어떻게 하는 건가요?

내일검색의 검색창을 여러분의 블로그나 카페, 홈페이지에 쉽고 편리하게 삽입하여 언제든지 채용정보를 검색 해 볼 수 있도록 스크립트를 자동으로 생성해 드리는 서비스 입니다.

1.	제공되는 서비스 옵션 - 검색창 가로 길이, 검색버튼 색상, 검색창의 로고 삽입 여부
2.	신청은 이렇게 하시면 되요
3.	사용은 이렇게 하시면 되요 - 삽입된 검색창에 직종, 지역, 기업명 등의 다양한 키워드를 입력하시면, 새 창으로 씨올의 채용정보 검색결과가 뜹니다~
4.	수정을 원하시면, 스크립트를 새로 생성받으시면 되요~
5.	그래도 잘 모르시겠다면? -문의답변처리 게시판을 참고하시거나 문의하기(Tel:02-2186-9259)를 이용해 주세요~
자, 지금 ‘간단검색창’을 사용해보시겠어요?

[누구나 쉬운 API] '검색창과 결과'는 어떻게 하는 건가요?

내일검색의 검색창을 여러분의 블로그나 카페, 홈페이지에 쉽고 편리하게 삽입하고 해당 결과 또한 하나의 페이지에서 언제든지 채용정보를 검색 해 볼 수 있는 서비스입니다. 원하는 조건에 따라 자동으로 생성된 스크립트를 삽입만 하시면 됩니다.

1.	제공되는 서비스 옵션 - 검색창 가로 길이, 검색버튼 색상, 검색창의 로고, 노출방식, 설정키워드, 리스팅 개수
2.	신청은 이렇게 하시면 되요
3.	사용은 이렇게 하시면 되요 - 삽입된 검색창에 키워드를 입력하면 선택했던 방식(기본형 or 간편보기형)으로 검색결과가 페이지에 뿌려집니다~
4.	수정을 원하시면, 스크립트를 새로 생성받으시면 되요~
5.	그래도 잘 모르시겠다면? - href="http://naeil.incruit.com/help/index.asp?page=1&sort=20&key=">문의답변처리 게시판을 참고하시거나 문의하기 (Tel:02-2186-9259)를 이용해 주세요~
자, 지금 ‘검색창과 결과’를 사용해보시겠어요?
src="http://img.incruit.com/cxiol/api/icon_api.gif" border=0>

[누구나 쉬운 API] '간단 키워드 결과'는 어떻게 하는 건가요?

내일검색의 검색결과를 여러분의 블로그나 카페, 홈페이지에서 바로 확인할 수 있는 서비스 입니다. 원하는 조건에 따라 자동으로 생성된 스크립트를 삽입만 하시면 됩니다.

1.	제공되는 서비스 옵션 - 노출방식, 결과에 들어갈 로고, 로고 위치, 설정키워드, 노출 개수
2.	신청은 이렇게 하시면 되요
3.	사용은 이렇게 하시면 되요 - 삽입된 곳에 설정된 키워드에 대한 결과값이 페이지를 불러올 때마다 내일검색에서 해당 키워드로 검색을 하는 것과 동일한 결과를 보여줍니다. 내일검색에 업데이트 된 채용정보들이 동시간에 적용됩니다.
4.	수정을 원하시면, 스크립트를 새로 생성받으시면 되요~
5.	그래도 잘 모르시겠다면? -문의답변처리 게시판을 참고하시거나 문의하기(Tel:02-2186-9259)를 이용해 주세요~
자, 지금 ‘간단 키워드 결과’를 사용해보시겠어요?

이전페이지 1 2 다음페이지

개인정보취급방침ㅣ 수집사이트등록 | 도움말ㅣ 공식 블로그ㅣ 오픈APIㅣ 업/직종 - 지역 - 기업형태별 검색

2010 incruit