채용검색API

Open API wiki
이동: 둘러보기, 찾기

1. 소개


2. 요청 URL (request url)

http://api.naeil.incruit.com/api

ex) 테스트 URL : http://api.naeil.incruit.com/api?q=java&key=afd&nation_code=kr&facet_field=region_facet


2-2. 요청 변수 (request parameter)

순번 파라메터명 기본값 필수여부 내용 사용예
1methodselectAPI기능종류 (select/insert)select/insert
2nation_code필수국가명 &nation_code=kr
3qq와lo둘중하나 필수검색키워드 &q=java
4loq와lo둘중하나 필수지역키워드 &lo=서울시
5key필수apikey &apikey={키}
6wtxmlxml, json &wt=xml
7start0공고 시작 위치(default 0)
8rows10보여줄 공고 수 1~100
9sortrank정렬 (rank/cl_date)
10pt좌표검색(latitude ,longitude ) &pt=45.15,-93.85
11dist범위(km) &dist=5
12fragsizehighlighting 필드 크기(10~300)
13facet_field패싯필드 정의 콤마 연결(5개까지) &facet_field=company_facet,job_type_facet
14facet_condition선택된 패싯에 대한 조건 연결 &facet_condition=region_facet:서울특별시,region_det_facet:서울특별시★강남구
15facet_mincount1최소 갯수 &facet_mincount=1
16facet_limit10출력 갯수(0~100) &facet_limit=10
17facet_sortcountcount/index 소팅 방법 &facet_sort=count
18fqfq중복 가능 &fq=region_facet:서울특별시 AND region_det_facet:서울특별시★강남구&fq=company:아무개회사명
19opand검색 조건 &op=and(키워드가 전부 포함된 공고 리스트), &op=or(공백으로 나뉘어진 키워드의 일부를 포함하는 공고 리스트)


3. 출력 필드 정의

순번 필드명 내용
1job_post_no공고번호
2company회사명
3company_address회사주소
4company_scale회사규모
5job_type고용형태
6education학력
7salary연봉분류
8career경력
9start_dt채용공고시작일자
10close_dt채용공고마감일자
11source_site_nm출처명
12source_site_url출처URL
13title제목
14content상세내용
15keyword키워드
16occupation직종명
17region지역명
18subway전철명
19location지역좌표
20link_url링크URL
21cl_date수집일자
22login_yn로그인필요여부


4.응답형식

1. 기본 포맷

<response>
  <qtime>{반환시간 밀리세컨드}</qtime>
  <numfound>{검색된 갯수}</numfound>
  <fragsize>{하일라이팅 fragsize}</fragsize>
  <start>{시작번호}</start>
  <rows>{출력갯수}</rows>
  <keyword>{검색어}</keyword>
  <items>
   <item>...</item>
   <item>...</item>
   <item>...</item>
   <item>...</item>
   <item>...</item>
   <item>...</item>
   <item>...</item>
   <item>...</item>
   <item>...</item>
   <item>...</item>
  </items>
  <facet_fields>
   <facets name="region_nm"/> <-- 제공중
   <facets name="region_det_nm"/> <-- 제공중
   <facets name="subway_line_nm"/> <-- 제공중
   <facets name="subway_station_nm"/> <-- 제공중
   <facets name="company_facet"/> <-- 제공중
   <facets name="career_facet/> <-- 제공예정
   <facets name="job_type_facet"/> <-- 제공예정
   <facets name="education_facet/> <-- 제공예정
   <facets name="salary_facet"/> <-- 제공예정
   <facets name="occupation_facet"/> <-- 제공예정
   <facets name="company_scale_facet"/> <-- 제공예정
  </facet_fields>
</response>

2. <item>...</item> 세부 구조

<item>
 <job_post_no><![CDATA[공고번호]]></job_post_no>
 <company><![CDATA[회사명]]></company>
 <company_address><![CDATA[회사주소]]></company_address>
 <company_scale><![CDATA[회사규모]]></company_scale>
 <job_type><![CDATA[고용형태]]></job_type>
 <education><![CDATA[학력]]></education>
 <salary><![CDATA[연봉분류]]></salary>
 <career><![CDATA[경력]]></career>
 <start_dt><![CDATA[채용공고시작일자]]></start_dt>
 <close_dt><![CDATA[채용공고마감일자]]></close_dt>
 <source_site_nm><![CDATA[출처명]]></source_site_nm>
 <source_site_url><![CDATA[출처URL]]></source_site_url>
 <title><![CDATA[제목]]></title>
 <content><![CDATA[상세내용]]></content>
 <keyword><![CDATA[키워드]]></keyword>
 <occupation><![CDATA[직종명]]></occupation>
 <region><![CDATA[지역명]]></region>
 <subway><![CDATA[전철명]]></subway>
 <location><![CDATA[지역좌표]]></location>
 <link_url><![CDATA[링크URL]]></link_url>
 <cl_date><![CDATA[수집일자]]></cl_date>
 <login_yn><![CDATA[로그인필요여부]]></login_yn>
</item>

3. <facets>...</facets> 세부 구조

<facets name="region_facet">
  <facet name="서울특별시">
    <![CDATA[ 2772 ]]>
   </facet>
  <facet name="경기도">
     <![CDATA[ 624 ]]>
   </facet>
   <facet name="대전광역시">
     <![CDATA[ 76 ]]>
   </facet>
   <facet name="부산광역시">
     <![CDATA[ 56 ]]>
   </facet>
   <facet name="인천광역시">
     <![CDATA[ 49 ]]>
   </facet>
   <facet name="전라남도">
     <![CDATA[ 45 ]]>
   </facet>
   <facet name="충청남도">
     <![CDATA[ 38 ]]>
   </facet>
   <facet name="경상남도">
     <![CDATA[ 31 ]]>
   </facet>
   </facet>
</facets>

4. 에러 출력 구조

<message>
   <code>101</code>
   <title>No Apikey</title>
   <description>No Apikey. Please input the Apikey value.</description>
</message>

5.에러 코드

순번 코드명 내용
1101api key 미입력시
2102잘못된 API-key
3103nation_code 미입력시
4120q 또는 lo 값 미입력시
5150검색한 결과 값이 없을 시
6404404 에러
7500서버 에러

6.기타사항

키 발급 및 문의 사항

Tel:02-2186-9027 Email: dhpark@incruit.com

<script type="text/javascript"> _atrk_opts = { atrk_acct:"XznHh1aIE7002X", domain:"incruit.com",dynamic: true}; (function() { var as = document.createElement('script'); as.type = 'text/javascript'; as.async = true; as.src = "https://d31qbv1cthcecs.cloudfront.net/atrk.js"; var s = document.getElementsByTagName('script')[0];s.parentNode.insertBefore(as, s); })(); </script> <noscript><img src="https://d5nxst8fruw4z.cloudfront.net/atrk.gif?account=XznHh1aIE7002X" style="display:none" height="1" width="1" alt="" /></noscript>

개인 도구
이름공간

변수
행위
둘러보기
도구모음