Naver Open Api Reference Manual

Slide 1: openapi.naver.com

Slide 3: NAVER open API 검색 결과 서비스 / 07 Contents 08 지식IN 검색 요청 URL 및 변수 (request url and parameter) / 08 출력 결과 필드 (response field) / 08 09 블로그 검색 요청 URL 및 변수 (request url and parameter) / 09 출력 결과 필드 (response field) / 09 10 전문 자료 검색 요청 URL 및 변수 (request url and parameter) / 10 출력 결과 필드 (response field) / 10 11 한국 웹 문서 검색 요청 URL 및 변수 (request url and parameter) / 11 출력 결과 필드 (response field) / 11 12 책 검색 요청 URL 및 변수 (request url and parameter) / 12 상세 검색 요청 URL 및 변수 (request url and parameter) / 12 책 카테고리 / 13 출력 결과 필드 (response field) / 14 15 쇼핑 검색 요청 URL 및 변수 (request url and parameter) / 15 출력 결과 필드 (response field) / 15 16 국어 사전 검색 요청 URL 및 변수 (request url and parameter) / 16 출력 결과 필드 (response field) / 16 17 일어 사전 검색 요청 URL 및 변수 (request url and parameter) / 17 출력 결과 필드 (response field) / 17 18 영어 사전 검색 요청 URL 및 변수 (request url and parameter) / 18 출력 결과 필드 (response field) / 18

Slide 4: 19 내 PC 검색 검색 관련 기능 / 26 내 PC 검색에서 사용되는 공통 요소 / 19 출력 결과 필드 (response field) 19 27 실시간 검색어 공통적으로 사용되는 카테고리 정보 19 요청 URL 및 변수 (request url and parameter) / 27 출력 결과 필드 (response field) / 27 20 openapi_search 요청 URL 및 변수 (request url and parameter) / 20 28 추천 검색어 출력 결과 필드 (response field) / 20 요청 URL 및 변수 (request url and parameter) / 28 출력 결과 필드 (response field) / 28 21 openapi_datacache 요청 URL 및 변수 (request url and parameter) / 21 29 성인 검색어 판별 출력 결과 필드 (response field) / 21 요청 URL 및 변수 (request url and parameter) / 29 출력 결과 필드 (response field) / 29 21 openapi_status 요청 URL 및 변수 (request url and parameter) / 21 30 오타 변환 출력 결과 필드 (response field) / 21 요청 URL 및 변수 (request url and parameter) / 30 출력 결과 필드 (response field) / 30 22 openapi_latestdoc 요청 URL 및 변수 (request url and parameter) / 22 31 바로 가기 출력 결과 필드 (response field) / 22 요청 URL 및 변수 (request url and parameter) / 31 출력 결과 필드 (response field) / 31 22 openapi_landmark 요청 URL 및 변수 (request url and parameter) / 22 출력 결과 필드 (response field) / 23 에러 메시지 / 32 23 openapi_extinfo 33 에러 메시지 요청 URL 및 변수 (request url and parameter) / 23 출력 결과 필드 (response field) / 23 지도 API / 34 24 openapi_property 요청 URL 및 변수 (request url and parameter) / 24 35 NMap Constructor / 35 24 openapi_open NMap(container [,width] [,height]) 35 요청 URL 및 변수 (request url and parameter) / 24 Method / 35 getBound() 35 24 openapi_readmail setBound(left, top, right, bottom) 35 요청 URL 및 변수 (request url and parameter) / 24 setCenterAndZoom(point, zoom_level) 35 setCenter(point) 35 25 openapi_getoption getCenter() 36 요청 URL 및 변수 (request url and parameter) / 25 setZoom(zoom_level) 36 출력 결과 필드 (response field) / 25 getZoom() 36 zoomIn() 36 zoomOut() 36 setMinLevel(zoom_level) 36 setMaxLevel(zoom_level) 36 enableDrag() 37

Slide 5: disableDrag() 37 43 NEvent enableWheelZoom() 37 Static method / 43 disableWheelZoom() 37 addListener(event_src, event_name, event_func) 43 addControl(control) 37 removeListener(event_src, event_name, event_func) 43 removeControl(control) 37 addOverlay(overlay,[ key]) 37 43 NMark removeOverlay(overlay) 38 Constructor / 43 clearOverlays([key]) 38 NMark(point, icon) 43 pan(x, y) 38 Method / 44 Event / 38 setZindex(zindex) 44 move 38 setTargeturl(url) 44 drag 38 unsetTargeturl() 44 startDrag 38 setPoint(point) 44 endDrag 38 getPoint() 44 click 39 hide() 44 dblclick 39 show() 44 mousemove 39 Event / 45 zoom 39 click 45 redraw 39 mousedown 45 mouseup 45 39 NSize mouseover 45 Constructor / 39 mouseout 45 NSize(width, height) 39 Method / 40 45 NIcon set(width, height) 40 Constructor / 45 setWidth(width) 40 NIcon(src, size [,offset]) 45 setHeight(height) 40 getWidth() 40 46 NInfoWindow getHeight() 40 Constructor / 46 add(width_dx, height_dx) 41 NInfoWindow() 46 equals(size) 41 Method / 46 copy() 41 setOpacity(opacity) 46 set(point, content) 46 41 NPoint showWindow() 46 Constructor / 41 hideWindow() 46 NPoint(x, y) 41 getPoint() 46 Method / 41 delayHideWindow([delayTime]) 47 set(x, y) 41 Event / 47 setX(x) 41 mouseover 47 setY(y) 42 mouseout 47 getX() 42 getY() 42 47 NPolyline add(x_dx, y_dx) 42 Constructor / 47 distance(x, y) 42 NPolyline() 47 equals(point) 42 Method / 47 copy() 43 setWeight(weight) 47

Slide 6: getWeight() 47 52 주소 좌표 변환 addPoints(...) 48 요청 URL 및 변수 (request url and parameter) / 52 getBound() 48 출력 결과 필드 (response field) / 52 show() 48 에러 메시지 / 52 hide() 48 setOpacity(opacity) 48 getOpacity() 48 setColor(color) 49 getColor() 49 49 NXmlhttp Constructor / 49 NXmlhttp() 49 Method / 49 setType(type) 49 loadhttp(url, returnFunc, ...) 49 50 NZoomControl Constructor / 50 NZoomControl() 50 Method / 50 setAlign(position) 50 setValign(position) 50 50 NSaveBtn Constructor / 50 NSaveBtn() 50 Method / 51 setAlign(position) 51 setValign(position) 51 51 NIndexMap Constructor / 51 NIndexMap() 51 Method / 51 setAlign(position) 51 setValign(position) 51

Slide 7: 표1 지식iN 검색 요청 변수 목록 08 표 27 내 PC 검색 openapi_status 출력 필드 목록 21 표2 지식iN 검색 출력 필드 목록 08 표 28 내 PC 검색 openapi_status 요청 변수 목록 21 표3 블로그 검색 요청 변수 목록 09 표 29 내 PC 검색 openapi_latestdoc 출력 필드 목록 22 표4 블로그 검색 출력 필드 목록 09 표 30 내 PC 검색 openapi_landmark 요청 변수 목록 22 표5 전문 자료 검색 요청 변수 목록 10 표 31 내 PC 검색 openapi_landmark 출력 필드 목록 23 표6 전문 자료 검색 출력 필드 목록 10 표 32 내 PC 검색 openapi_extinfo 요청 변수 목록 23 표7 한국 웹 문서 검색 요청 변수 목록 11 표 33 내 PC 검색 openapi_extinfo 출력 필드 목록 23 표8 한국 웹 문서 검색 출력 필드 목록 11 표 34 내 PC 검색 openapi_property 요청 변수 목록 24 표9 책 검색 요청 변수 목록 12 표 35 내 PC 검색 openapi_open 요청 변수 목록 24 표 10 책 상세 검색 요청 변수 목록 12 표 36 내 PC 검색 openapi_readmail 요청 변수 목록 24 표 11 책 상세 검색 카테고리 13 표 37 내 PC 검색 openapi_getoption 요청 변수 목록 25 표 12 책 검색 출력 필드 목록 14 표 38 내 PC 검색 openapi_getoption 출력 필드 목록 25 표 13 한국 웹 문서 검색 요청 변수 목록 15 표 39 실시간 검색어 요청 변수 목록 27 표 14 한국 웹 문서 검색 출력 필드 목록 15 표 40 실시간 검색어 출력 필드 목록 27 표 15 국어 사전 검색 요청 변수 목록 16 표 41 추천 검색어 요청 변수 목록 28 표 16 국어 사전 검색 출력 필드 목록 16 표 42 추천 검색어 출력 필드 목록 28 표 17 일어 사전 검색 요청 변수 목록 17 표 43 성인 검색어 판별 요청 변수 목록 29 표 18 일어 사전 검색 출력 필드 목록 17 표 44 성인 검색어 판별 출력 필드 목록 29 표 19 영어 사전 검색 요청 변수 목록 18 표 45 오타 변환 요청 변수 목록 30 표 20 영어 사전 검색 출력 필드 목록 18 표 46 오타 변환 출력 필드 목록 30 표 21 내 PC 검색 출력 필드 목록 19 표 47 바로 가기 요청 변수 목록 31 표 22 내 PC 검색에서 사용되는 카테고리 목록 19 표 48 바로 가기 출력 필드 목록 31 표 23 내 PC 검색 openapi_search 요청 변수 목록 20 표 49 공통 에러 메시지 33 표 24 내 PC 검색 openapi_search 출력 필드 목록 20 표 50 주소 좌표 변환 요청 변수 목록 52 표 25 내 PC 검색 openapi_datacache 요청 변수 목록 21 표 51 주소 좌표 변환 출력 필드 목록 52 표 26 내 PC 검색 openapi_datacache 출력 필드 목록 21 표 52 주소 좌표 변환 에러 메시지 52

Slide 8: 검색 결과 서비스

Slide 9: NAVER open API | 검색 결과 서비스 지식iN 검색 지식iN 검색은 지식인의 데이터를 검색할 수 있는 API 입니다. 요청 URL 및 변수 (request url and parameter) http://openapi.naver.com/search?key=검색용OpenAPI키&target=kin&query=검색하고자하는키워드&display=10&start =1&sort=sim 변수 명 설명 key OpenAPI를 사용하기 위해 NAVER에서 발급받은 key입니다. target 지식iN을 검색하기 위해서 이 값은 항상 kin 이어야 합니다. query 검색하려는 질의문 입니다. UTF-8 형식이어야 합니다. display 한번에 반환되는 검색 결과의 개수입니다. 기본값: 10 최대값: 100 start 검색의 시작위치를 지정합니다. 기본값: 1 최대값: 1000 sort 결과값이 출력되는 순서를 정렬하기 위한 옵션입니다. sim: 유사도 순 date: 날짜 순 count: 조회수 순 point: 평점 순 표 1 지식iN 검색 요청 변수 목록 출력 결과 필드 (response field) 필드 명 형식 설명 rss 디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다 channel 검색 결과를 포함하는 컨테이너입니다. 이 안에 있는 title, link, description 등의 항목은 참고용으로 무시해도 무방합니다. lastBuildDate datetime 검색 결과를 생성한 시간입니다. total integer 검색 결과 문서의 총 개수를 의미합니다. start integer 검색 결과 문서 중, 문서의 시작점을 의미합니다. display integer . item 개별 검색 결과이며 title, link, description을 포함합니다. title string 검색 결과 문서의 제목을 나타냅니다. 제목에서 검색어와 일치하는 부분은 <b> 태그로 감싸져 있습니다. link string 검색 결과 문서의 하이퍼텍스트 link를 나타냅니다. description string 검색 결과 문서의 내용을 요약한 정보입니다. 문서 전체의 내용은 link를 따라가면 읽을 수 있습니다. 검색어와 일치하는 부분은 <b> 태그로 감싸져 있습니다. 표 2 지식iN 검색 출력 필드 목록 08

Slide 10: NAVER open API | 검색 결과 서비스 블로그 검색 블로그 검색은 블로그의 데이터를 검색할 수 있는 API 입니다. 요청 URL 및 변수 (request url and parameter) http://openapi.naver.com/search?key=검색용OpenAPI키&target=blog&query=검색하고자하는키워드&display=10&star t=1&sort=sim 변수 명 설명 key OpenAPI를 사용하기 위해 NAVER에서 발급받은 key입니다. target 블로그를 검색하기 위해서 이 값은 항상 blog 이어야 합니다. query 검색하려는 질의문 입니다. UTF-8 형식이어야 합니다. display 한번에 반환되는 검색 결과의 개수입니다. 기본값: 10 최대값: 100 start 검색의 시작위치를 지정합니다. 기본값: 1 최대값: 1000 sort 결과값이 출력되는 순서를 정렬하기 위한 옵션입니다. sim: 유사도순 date: 날짜순 표 3 블로그 검색 요청 변수 목록 출력 결과 필드 (response field) 필드 명 형식 설명 rss 디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다. channel 검색 결과를 포함하는 컨테이너입니다. 이 안에 있는 title, link, description 등의 항목은 참고용으로 무시해도 무방합니다. lastBuildDate datetime 검색 결과를 생성한 시간입니다. total integer 검색 결과 문서의 총 개수를 의미합니다. start integer 검색 결과 문서 중, 문서의 시작점을 의미합니다. display integer item 개별 검색 결과이며 title, link, description을 포함합니다. title string 검색 결과 문서의 제목을 나타냅니다. 제목에서 검색어와 일치하는 부분은 <b> 태그로 감싸져 있습니다. link string 검색 결과 문서의 하이퍼텍스트 link를 나타냅니다. description string 검색 결과 문서의 내용을 요약한 정보입니다. 문서 전체의 내용은 link를 따라가면 읽을 수 있습니다. 검색어와 일치하는 부분은 <b> 태그로 감싸져 있습니다. 표 4 블로그 검색 출력 필드 목록 09

Slide 11: NAVER open API | 검색 결과 서비스 전문 자료 검색 전문 자료 검색은 전문 자료의 데이터를 검색할 수 있는 API 입니다. 요청 URL 및 변수 (request url and parameter) http://openapi.naver.com/search?key=검색용OpenAPI키&target=doc&query=검색하고자하는키워드 &display=10&start=1 변수 명 설명 key OpenAPI를 사용하기 위해 NAVER에서 발급받은 key입니다. target 전문 자료를 검색하기 위해서 이 값은 항상 doc 이어야 합니다. query 검색하려는 질의문 입니다. UTF-8 형식이어야 합니다. display 한번에 반환되는 검색 결과의 개수입니다. 기본값: 10 최대값: 100 start 검색의 시작위치를 지정합니다. 기본값: 1 최대값: 1000 표 5 전문 자료 검색 요청 변수 목록 출력 결과 필드 (response field) 필드 명 형식 설명 rss 디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다 channel 검색 결과를 포함하는 컨테이너입니다. 이 안에 있는 title, link, description 등의 항목은 참고용으로 무시해도 무방합니다. lastBuildDate datetime 검색 결과를 생성한 시간입니다. total integer 검색 결과 문서의 총 개수를 의미합니다. start integer 검색 결과 문서 중, 문서의 시작점을 의미합니다. display integer item 개별 검색 결과이며 title, link, description을 포함합니다. title string 검색 결과 문서의 제목을 나타냅니다. 제목에서 검색어와 일치하는 부분은 <b> 태그로 감싸져 있습니다. link string 검색 결과 문서의 하이퍼텍스트 link를 나타냅니다. description string 검색 결과 문서의 내용을 요약한 정보입니다. 문서 전체의 내용은 link를 따라가면 읽을 수 있습니다. 검색어와 일치하는 부분은 <b> 태그로 감싸져 있습니다. 표 6 전문 자료 검색 출력 필드 목록 10

Slide 12: NAVER open API | 검색 결과 서비스 한국 웹 문서 검색 한국 웹 문서 검색은 한국 웹 문서의 데이터를 검색할 수 있는 API 입니다. 요청 URL 및 변수 (request url and parameter) http://openapi.naver.com/search?key=검색용OpenAPI키&target=webkr&query=검색하고자하는키워드 &display=10&start=1 변수 명 설명 key OpenAPI를 사용하기 위해 NAVER에서 발급받은 key입니다. target 한국 웹 문서를 검색하기 위해서 이 값은 항상 webkr 이어야 합니다. query 검색하려는 질의문 입니다. UTF-8 형식이어야 합니다. display 한번에 반환되는 검색 결과의 개수입니다. 기본값: 10 최대값: 100 start 검색의 시작위치를 지정합니다. 기본값: 1 최대값: 1000 표 7 한국 웹 문서 검색 요청 변수 목록 출력 결과 필드 (response field) 필드 명 형식 설명 rss 디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다 channel 검색 결과를 포함하는 컨테이너입니다. 이 안에 있는 title, link, description 등의 항목은 참고용으로 무시해도 무방합니다. lastBuildDate datetime 검색 결과를 생성한 시간입니다. total integer 검색 결과 문서의 총 개수를 의미합니다. start integer 검색 결과 문서 중, 문서의 시작점을 의미합니다. display integer item 개별 검색 결과이며 title, link, description을 포함합니다. title string 검색 결과 문서의 제목을 나타냅니다. 제목에서 검색어와 일치하는 부분은 <b> 태그로 감싸져 있습니다. link string 검색 결과 문서의 하이퍼텍스트 link를 나타냅니다. description string 검색 결과 문서의 내용을 요약한 정보입니다. 문서 전체의 내용은 link를 따라가면 읽을 수 있습니다. 검색어와 일치하는 부분은 <b> 태그로 감싸져 있습니다. 표 8 한국 웹 문서 검색 출력 필드 목록 11

Slide 13: NAVER open API | 검색 결과 서비스 책 검색 책 검색은 책에 대한 데이터를 검색할 수 있는 API 입니다. 요청 URL 및 변수 (request url and parameter) http://openapi.naver.com/search?key=검색용OpenAPI키&target=book&query=검색하고자하는키워드 &display=10&start=1 변수 명 설명 key OpenAPI를 사용하기 위해 NAVER에서 발급받은 key입니다. target 책을 검색하기 위해서 이 값은 항상 book 이어야 합니다. query 검색하려는 질의문 입니다. UTF-8 형식이어야 합니다. display 한번에 반환되는 검색 결과의 개수입니다. 기본값: 10 최대값: 100 start 검색의 시작위치를 지정합니다. 기본값: 1 최대값: 1000 sort 결과값이 출력되는 순서를 정렬하기 위한 옵션입니다. sim: 유사도 순 date: 날짜 순 count: 판매량 순 표 9 책 검색 요청 변수 목록 상세 검색 요청 URL 및 변수 (request url and parameter) http://openapi.naver.com/search?key=검색용OpenAPI키&target=book_adv&query=검색하고자하는키워드&display=1 0&start=1&d_title=XXX&d_catg=YYY 변수 명 설명 key OpenAPI를 사용하기 위해 NAVER에서 발급받은 key입니다. target 한국 웹 문서를 검색하기 위해서 이 값은 항상 book_adv 이어야 합니다. query 검색하려는 질의문 입니다. UTF-8 형식이어야 합니다. d_titl 책 제목에서의 검색을 의미합니다. d_auth 저자명에서의 검색을 의미합니다. d_cont 목차에서의 검색을 의미합니다. d_isbn ISBN에서의 검색을 의미합니다. d_publ 출판사에서의 검색을 의미합니다. d_dafr 검색을 원하는 책의 출간 범위를 지정합니다. (시작일) (e.g. 20000101) d_dato 검색을 원하는 책의 출간 범위를 지정합니다. (종료일) (e.g. 20061231) d_catg 검색을 원하는 카테고리를 지정합니다. 12

Slide 14: NAVER open API | 검색 결과 서비스 display 한번에 반환되는 검색 결과의 개수입니다. 기본값: 10 최대값: 100 start 검색의 시작위치를 지정합니다. 기본값: 1 최대값: 1000 sort 결과값이 출력되는 순서를 정렬하기 위한 옵션입니다. sim: 유사도 순 date: 날짜 순 count: 판매량 순 표 10 책 상세 검색 요청 변수 목록 책 카테고리 카테고리 명 depth 1 depth 2 일반도서 1 철학 101 종교/신화 102 예술/대중문화 103 인문/교양 104 역사/지리학 105 인물/전기/평전 106 문학이론/문학연구 107 소설/시/희곡 108 산문/에세이/논픽션 109 사회과학 110 여성학/페미니즘 111 언론/미디어/광고 112 경영/비즈니스 114 컴퓨터/인터넷 115 순수과학 116 응용과학 117 장르소설 119 여행/해외정보 121 건강/취미/스포츠 122 가정/생활/요리 123 자기계발 124 외국어학습 125 취업/수험/자격증 126 청소년 128 참고서 129 사전/백과/연감/기타 130 출판사 광장 150 어린이 2 아티누스 국외서 4 큐레이터학/예술행정 401 13

Slide 15: NAVER open API | 검색 결과 서비스 미술 402 건축/인테리어 403 디자인 404 공예 405 패션 406 사진 407 영화 408 애니메이션/만화 409 라이프 스타일 410 기법서/사전 411 한국문화 소개서 412 음악 413 아동 미술 414 잡지 5 국내잡지 501 해외잡지 502 만화 6 표 11 책 상세 검색 카테고리 출력 결과 필드 (response field) 필드 명 형식 설명 rss 디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다 channel 검색 결과를 포함하는 컨테이너입니다. 이 안에 있는 title, link, description 등의 항목은 참고용으로 무시해도 무방합니다. lastBuildDate datetime 검색 결과를 생성한 시간입니다. total integer 검색 결과 문서의 총 개수를 의미합니다. start integer 검색 결과 문서 중, 문서의 시작점을 의미합니다. display integer item 개별 검색 결과이며 title, link, description을 포함합니다. title string 검색 결과 문서의 제목을 나타냅니다. 제목에서 검색어와 일치하는 부분은 <b> 태그로 감싸져 있습니다. link string 검색 결과 문서의 하이퍼텍스트 link를 나타냅니다. image string 썸네일 이미지의 URL입니다. 이미지가 있는 경우만 나타납니다. author string 저자정보입니다. price integer 가격정보입니다. 절판도서 등으로 가격이 없으면 나타나지 않습니다. discount integer 할인가 정보입니다. 절판도서 등으로 가격이 없으면 나타나지 않습니다. publisher string 출판사 정보입니다. pubdate date 출간일 정보입니다. isbn integer ISBN 정보입니다. description string 검색 결과 문서의 내용을 요약한 정보입니다. 문서 전체의 내용은 link를 따라가면 읽을 수 있습니다. 검색어와 일치하는 부분은 <b> 태그로 감싸져 있습니다. 표 12 책 검색 출력 필드 목록 14

Slide 16: NAVER open API | 검색 결과 서비스 쇼핑 검색 쇼핑 검색은 NAVER 쇼핑에 등록된 상품의 데이터를 검색할 수 있는 API 입니다. 요청 URL 및 변수 (request url and parameter) http://openapi.naver.com/search?key=검색용OpenAPI키&target=shop&query=검색하고자하는키워드 &display=10&start=1 변수 명 설명 key OpenAPI를 사용하기 위해 NAVER에서 발급받은 key입니다. target 쇼핑 데이터를 검색하기 위해서 이 값은 항상 shop 이어야 합니다. query 검색하려는 질의문 입니다. UTF-8 형식이어야 합니다. display 한번에 반환되는 검색 결과의 개수입니다. 기본값: 10 최대값: 100 start 검색의 시작위치를 지정합니다. 기본값: 1 최대값: 1000 sort 결과값이 출력되는 순서를 정렬하기 위한 옵션입니다. sim: 유사도 순 date: 날짜 순 asc: 가격 오름차순 dsc: 가격 내림차순 표 13 한국 웹 문서 검색 요청 변수 목록 출력 결과 필드 (response field) 필드 명 형식 설명 rss 디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다 channel 검색 결과를 포함하는 컨테이너입니다. 이 안에 있는 title, link, description 등의 항목은 참고용으로 무시해도 무방합니다. lastBuildDate datetime 검색 결과를 생성한 시간입니다. total integer 검색 결과 문서의 총 개수를 의미합니다. start integer 검색 결과 문서 중, 문서의 시작점을 의미합니다. display integer item 개별 검색 결과이며 title, link, description을 포함합니다. title string 검색 결과 문서의 제목을 나타냅니다. 제목에서 검색어와 일치하는 부분은 <b> 태그로 감싸져 있습니다. link string 검색 결과 문서의 하이퍼텍스트 link를 나타냅니다. image string 썸네일 이미지의 URL입니다. 이미지가 있는 경우에만 나타납니다. lprice integer 최저가 정보입니다. 가격 정보가 있는 경우에만 나타납니다. hprice integer 최고가 정보입니다. 가격 정보가 있는 경우에만 나타납니다. 표 14 한국 웹 문서 검색 출력 필드 목록 15

Slide 17: NAVER open API | 검색 결과 서비스 국어 사전 검색 국어 사전 검색은 NAVER의 국어 사전을 검색할 수 있는 API 입니다. 요청 URL 및 변수 (request url and parameter) http://openapi.naver.com/search?key=검색용OpenAPI키&target=krdic&query=검색하고자하는키워드 &display=10&start=1 변수 명 설명 key OpenAPI를 사용하기 위해 NAVER에서 발급받은 key입니다. target 국어 사전을 검색하기 위해서 이 값은 항상 krdic 이어야 합니다. query 검색하려는 질의문 입니다. UTF-8 형식이어야 합니다. display 한번에 반환되는 검색 결과의 개수입니다. 기본값: 10 최대값: 100 start 검색의 시작위치를 지정합니다. 기본값: 1 최대값: 1000 표 15 국어 사전 검색 요청 변수 목록 출력 결과 필드 (response field) 필드 명 형식 설명 rss 디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다 channel 검색 결과를 포함하는 컨테이너입니다. 이 안에 있는 title, link, description 등의 항목은 참고용으로 무시해도 무방합니다. lastBuildDate datetime 검색 결과를 생성한 시간입니다. total integer 검색 결과 문서의 총 개수를 의미합니다. start integer 검색 결과 문서 중, 문서의 시작점을 의미합니다. display integer item 개별 검색 결과이며 title, link, description을 포함합니다. title string 검색 결과 문서의 제목을 나타냅니다. 제목에서 검색어와 일치하는 부분은 <b> 태그로 감싸져 있습니다. link string 검색 결과 문서의 하이퍼텍스트 link를 나타냅니다. 표 16 국어 사전 검색 출력 필드 목록 16

Slide 18: NAVER open API | 검색 결과 서비스 일어 사전 검색 일어 사전 검색은 NAVER의 일어 사전을 검색할 수 있는 API 입니다. 요청 URL 및 변수 (request url and parameter) http://openapi.naver.com/search?key=검색용OpenAPI키&target=jpdic&query=검색하고자하는키워드 &display=10&start=1 변수 명 설명 key OpenAPI를 사용하기 위해 NAVER에서 발급받은 key입니다. target 일어 사전을 검색하기 위해서 이 값은 항상 jpdic 이어야 합니다. query 검색하려는 질의문 입니다. UTF-8 형식이어야 합니다. display 한번에 반환되는 검색 결과의 개수입니다. 기본값: 10 최대값: 100 start 검색의 시작위치를 지정합니다. 기본값: 1 최대값: 1000 표 17 일어 사전 검색 요청 변수 목록 출력 결과 필드 (response field) 필드 명 형식 설명 rss 디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다 channel 검색 결과를 포함하는 컨테이너입니다. 이 안에 있는 title, link, description 등의 항목은 참고용으로 무시해도 무방합니다. lastBuildDate datetime 검색 결과를 생성한 시간입니다. total integer 검색 결과 문서의 총 개수를 의미합니다. start integer 검색 결과 문서 중, 문서의 시작점을 의미합니다. display integer item 개별 검색 결과이며 title, link, description을 포함합니다. title string 검색 결과 문서의 제목을 나타냅니다. 제목에서 검색어와 일치하는 부분은 <b> 태그로 감싸져 있습니다. link string 검색 결과 문서의 하이퍼텍스트 link를 나타냅니다. 표 18 일어 사전 검색 출력 필드 목록 17

Slide 19: NAVER open API | 검색 결과 서비스 영어 사전 검색 영어 사전 검색은 NAVER의 영어 사전을 검색할 수 있는 API 입니다. 요청 URL 및 변수 (request url and parameter) http://openapi.naver.com/search?key=검색용OpenAPI키&target=endic&query=검색하고자하는키워드 &display=10&start=1 변수 명 설명 key OpenAPI를 사용하기 위해 NAVER에서 발급받은 key입니다. target 영어 사전을 검색하기 위해서 이 값은 항상 endic 이어야 합니다. query 검색하려는 질의문 입니다. UTF-8 형식이어야 합니다. display 한번에 반환되는 검색 결과의 개수입니다. 기본값: 10 최대값: 100 start 검색의 시작위치를 지정합니다. 기본값: 1 최대값: 1000 표 19 영어 사전 검색 요청 변수 목록 출력 결과 필드 (response field) 필드 명 형식 설명 rss 디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다 channel 검색 결과를 포함하는 컨테이너입니다. 이 안에 있는 title, link, description 등의 항목은 참고용으로 무시해도 무방합니다. lastBuildDate datetime 검색 결과를 생성한 시간입니다. total integer 검색 결과 문서의 총 개수를 의미합니다. start integer 검색 결과 문서 중, 문서의 시작점을 의미합니다. display integer item 개별 검색 결과이며 title, link, description을 포함합니다. title string 검색 결과 문서의 제목을 나타냅니다. 제목에서 검색어와 일치하는 부분은 <b> 태그로 감싸져 있습니다. link string 검색 결과 문서의 하이퍼텍스트 link를 나타냅니다. 표 20 영어 사전 검색 출력 필드 목록 18

Slide 20: NAVER open API | 검색 결과 서비스 내 PC 검색 내 PC 검색은 내PC검색(http://mypc.naver.com)을 설치했을 경우 내 PC의 자료를 검색할 수 있는 API 입니다. 내 PC 검색에서 사용되는 공통 요소 출력 결과 필드 (response field) 출력은 표준 형식인 RSS 2.0 형식(http://blogs.law.harvard.edu/tech/rss)을 따릅니다. 표준 RSS에 내PC검색 API용으로 추가 된 태그는 nns XML namespace를 가집니다. 필드 명 형식 설명 rss 디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다 channel 검색 결과를 포함하는 컨테이너입니다. 이 안에 있는 title, link, description 등의 항목은 참고용으로 무시해도 무방합니다. title string 제목 link url 요청 url description string 설명 nns:total integer 검색 결과 문서의 총 개수를 의미합니다. nns:start integer 검색 결과 문서 중, 문서의 시작점을 의미합니다. nns:display integer nns:errorcode integer 오류 발생시 에러코드입니다. 정상일 때는 0입니다. nns:result compound tag 응답 결과 item compound tag 검색 결과 아이템 표 21 내 PC 검색 출력 필드 목록 공통적으로 사용되는 카테고리 정보 ID 카테고리 설명 0 desktop 전체 카테고리 1 webpage 웹 히스토리 2 doc 문서 3 image 이미지 4 music 음악 5 movie 동영상 6 dir 폴더 7 email 이메일 8 etc 기타파일 9 timeline 타임라인 표 22 내 PC 검색에서 사용되는 카테고리 목록 19

Slide 21: NAVER open API | 검색 결과 서비스 openapi_serch 검색을 요청합니다. 요청 URL 및 변수 (request url and parameter) http://127.0.0.1:3001/openapi_search?where=desktop&query=nhn&start=1&display=10 변수 명 설명 where 검색할 카테고리를 지정합니다. 기본값: desktop query 검색할 질의어를 입력합니다. URL encoding이 되어 있어야 합니다. start 검색의 시작위치를 지정합니다. 기본값: 1 display 한번에 반환되는 검색 결과의 개수입니다. 기본값: 환경설정에 지정된 개수 ds 검색 시작일자 (e.g. 20060101) de 검색 종료일자 (e.g. 20061231) st 검색 영역을 지정합니다. 제목(URL, 파일명, 폴더 명) + 본문 (0: 기본값), 제목상세(1) so 검색결과의 정렬방법을 지정합니다. 0: 시간 순 (기본값) 1: 정확도 et 검색에 포함시킬 확장자 목록입니다. ‘|’로 항목 구분을 합니다. (e.g. txt|doc|ppt) tp 지정 폴더 내 검색을 합니다. cat 카테고리를 지정합니다. where가 timeline일 경우 timeline 카테고리를 지정합니다. tl where가 timeline일 경우 날짜를 지정합니다. 표 23 내 PC 검색 openapi_search 요청 변수 목록 출력 결과 필드 (response field) 필드 명 형식 설명 title string item의 제목 link URL 웹 페이지 또는 파일의 위치를 나타내는 URL description string 검색결과. 검색어가 강조 표시됩니다. nns:docid integer 문서의 고유 ID nns:hightlightedurl URL 강조되어 표시된 URL nns:maindocoffset integer 문서의 offset nns:maindocsize integer 문서의 크기 nns:subdocoffset integer 썸네일등 포함된 문서의 offset nns:subdocsize integer 썸네일등 포함된 문서의 크기 nns:itemtime epoch time 문서의 수정된 날짜 또는 색인 시간 nns:category 카테고리 ID 카테고리 nns:extentionid extention ID 문서의 확장자 타입. 타입 id는 openapi_extinfo로 받아올 수 있습니다. nns:metainfo item에 대한 세부적인 정보를 담고 있습니다. 표 24 내 PC 검색 openapi_search 출력 필드 목록 20

Slide 22: NAVER open API | 검색 결과 서비스 openapi_datacache 썸네일 데이터를 Base64 인코딩 형태로 가져옵니다. 요청 URL 및 변수 (request url and parameter) http://127.0.0.1:3001/openapi_datacache?h=1&l=1 변수 명 설명 h 데이터의 offset. 검색 결과의 값(nns:subdocoffset)을 사용합니다. l 데이터의 size. 검색결과의 값(nns:subdocoffset)을 사용합니다. 표 25 내 PC 검색 openapi_datacache 요청 변수 목록 출력 결과 필드 (response field) 필드 명 형식 설명 nns:thumbnail Base 64 encoded string 인코딩된 thumbnail 이미지 표 26 내 PC 검색 openapi_datacache 출력 필드 목록 openapi_status 현재 색인 상태에 대한 정보를 가져옵니다. 요청 URL 및 변수 (request url and parameter) http://127.0.0.1:3001/openapi_status 출력 결과 필드 (response field) 필드 명 형식 설명 nns:progress percent 색인 진행률 nns:totaldocnum integer 전체 색인 문서 개수 nns:catstatus compound tag 각 카테고리별 색인 상태. catid: 카테고리 ID nns:docnum integer 카테고리별 문서 개수 nns:docdate docdate 마지막 문서 갱신 날짜 표 27 내 PC 검색 openapi_status 출력 필드 목록 21

Slide 23: NAVER open API | 검색 결과 서비스 openapi_latestdoc 최근 문서에 대한 정보를 가져옵니다. 요청 URL 및 변수 (request url and parameter) http://127.0.0.1:3001/openapi_latestdoc 변수 명 설명 where 카테고리를 지정합니다. 기본값: desktop display 출력건수를 지정합니다. 기본값: 환경 설정에 지정된 개수 표 28 내 PC 검색 openapi_status 요청 변수 목록 출력 결과 필드 (response field) 필드 명 형식 설명 title string item의 제목 link URL 웹 페이지 또는 파일의 위치를 나타내는 URL description string 검색 속도 향상을 위해 이 값은 출력되지 않습니다. nns:docid integer 문서의 고유 ID nns:hightlightedurl URL 강조되어 표시된 URL nns:maindocoffset integer 문서의 offset nns:maindocsize integer 문서의 크기 nns:subdocoffset integer 썸네일등 포함된 문서의 offset nns:subdocsize integer 썸네일등 포함된 문서의 크기 nns:itemtime epoch time 문서의 수정된 날짜 또는 색인 시간 nns:category 카테고리 ID 카테고리 nns:extentionid extention ID 문서의 확장자 타입. 타입 id는 openapi_extinfo로 받아올 수 있습니다. nns:metainfo item에 대한 세부적인 정보를 담고 있습니다. 표 29 내 PC 검색 openapi_latestdoc 출력 필드 목록 openapi_landmark 랜드마크 정보를 가져옵니다. 요청 URL 및 변수 (request url and parameter) http://127.0.0.1:3001/openapi_landmark 변수 명 설명 doc 기준 문서의 ID 표 30 내 PC 검색 openapi_landmark 요청 변수 목록 22

Slide 24: NAVER open API | 검색 결과 서비스 출력 결과 필드 (response field) 필드 명 형식 설명 title string item의 제목 link URL 웹페이지 또는 파일의 위치를 나타내는 URL description string 검색결과. 검색어가 강조 표시됩니다. nns:docid integer 문서의 고유 ID nns:hightlightedurl URL 강조되어 표시된 URL nns:maindocoffset integer 문서의 offset nns:maindocsize integer 문서의 크기 nns:subdocoffset integer 썸네일등 포함된 문서의 offset nns:subdocsize integer 썸네일등 포함된 문서의 크기 nns:itemtime epoch time 문서의 수정된 날짜 또는 색인 시간 nns:category 카테고리 ID 카테고리 nns:extentionid extension ID 문서의 확장자 타입. 타입 id는 openapi_extinfo로 받아올 수 있습니다. nns:metainfo item에 대한 세부적인 정보를 담고 있습니다. 표 31 내 PC 검색 openapi_landmark 출력 필드 목록 openapi_extinfo 카테고리별로 색인되는 확장자 목록을 가져옵니다. 요청 URL 및 변수 (request url and parameter) http://127.0.0.1:3001/openapi_extinfo 변수 명 설명 where 카테고리를 지정합니다. 기본값: desktop 표 32 내 PC 검색 openapi_extinfo 요청 변수 목록 출력 결과 필드 (response field) 필드 명 형식 설명 nns:extinfo compound tag 각 카테고리별 확장자 정보 catid: 카테고리 ID nns:ext string 색인되는 확장자 id: 확장자의 ID 표 33 내 PC 검색 openapi_extinfo 출력 필드 목록 23

Slide 25: NAVER open API | 검색 결과 서비스 openapi_property 파일의 속성 창을 엽니다. 요청 URL 및 변수 (request url and parameter) http://127.0.0.1:3001/openapi_property 변수 명 설명 path 속성 창을 열 파일의 절대 경로 표 34 내 PC 검색 openapi_property 요청 변수 목록 openapi_open 파일을 엽니다. 파일 오픈 프로그램은 탐색기의 연결 프로그램 설정을 따릅니다. 요청 URL 및 변수 (request url and parameter) http://127.0.0.1:3001/openapi_open 변수 명 설명 path 열 파일의 절대 경로 표 35 내 PC 검색 openapi_open 요청 변수 목록 openapi_readmail 이메일 문서를 Outlook, OutlookExpress 등의 이메일 클라이언트 프로그램으로 엽니다. 요청 URL 및 변수 (request url and parameter) http://127.0.0.1:3001/openapi_readmail 변수 명 설명 eid 열 문서의 entry ID. 검색 결과의 <nns:metainfo name=”entry_id”>의 값을 사용합니다. 표 36 내 PC 검색 openapi_readmail 요청 변수 목록 24

Slide 26: NAVER open API | 검색 결과 서비스 openapi_getoption 환경설정 정보를 가져옵니다. 요청 URL 및 변수 (request url and parameter) http://127.0.0.1:3001/openapi_getoption 변수 명 설명 type 가져올 항목. all, cat_order, displayno, disablefo, disablefe, disablenexearch 기본값: all 표 37 내 PC 검색 openapi_getoption 요청 변수 목록 출력 결과 필드 (response field) 필드 명 형식 설명 nns:cat_order category list 검색 영역에 포함된 카테고리 ID의 목록. ‘|’로 구분 합니다. nns:displayno integer 결과 출력 건수 nns:disablefo boolean value 파일 열기바 막음 여부 nns:disablefe boolean value 폴더 검색바 막음 여부 nns:disablenexearch boolean value NAVER 통합 검색 연동 출력 여부 표 38 내 PC 검색 openapi_getoption 출력 필드 목록 25

Slide 27: 검색 관련 기능

Slide 28: NAVER open API | 검색 관련 기능 실시간 검색어 실시간 검색어는 현재 NAVER에서 많이 검색되고 있는 검색어들을 순서대로 10위까지 보여주는 API 입니다. 요청 URL 및 변수 (request url and parameter) http://openapi.naver.com/search?key=검색용OpenAPI키&target=rank&query=검색어분류 변수 명 설명 key OpenAPI를 사용하기 위해 NAVER에서 발급받은 key입니다. target 실시간 검색어를 이용하기 위해서 이 값은 항상 rank 이어야 합니다. query 보기를 원하는 분류를 입력합니다. nexearch: 통합검색 cafeblog: 카페, 블로그 검색 dic: 사전 검색 image: 이미지 검색 kin: 지식iN 검색 music: 음악 검색 video: 동영상 검색 webkr: 웹 문서 검색 news: 뉴스 검색 표 39 실시간 검색어 요청 변수 목록 출력 결과 필드 (response field) 필드 명 형식 설명 R숫자 R1 ~ R10은 순위를 나타냅니다. R1: 1위 R10: 10위 K string 키워드 S string 순위의 증감 여부 +: 증가 -: 감소 new: 새로운 순위 V integer 변동 값. 0 인 경우 새로운 순위를 의미합니다. 표 40 실시간 검색어 출력 필드 목록 27

Slide 29: NAVER open API | 검색 관련 기능 추천 검색어 추천 검색어는 입력한 검색어에 대해서 NAVER에서 추천하는 검색어들의 목록을 보여주는 API입니다. 요청 URL 및 변수 (request url and parameter) http://openapi.naver.com/search?key=검색용OpenAPI키&target=recmd&query=검색하고자하는키워드 변수 명 설명 key OpenAPI를 사용하기 위해 NAVER에서 발급받은 key입니다. target 추천 검색어를 이용하기 위해서 이 값은 항상 recmd 이어야 합니다. query 검색하려는 질의문 입니다. UTF-8 형식이어야 합니다. 표 41 추천 검색어 요청 변수 목록 출력 결과 필드 (response field) 필드 명 형식 설명 item string 추천 검색어입니다. 이 엘리먼트를 반복적으로 읽어 다수의 추천 검색어를 얻을 수 있습니다. 표 42 추천 검색어 출력 필드 목록 28

Slide 30: NAVER open API | 검색 관련 기능 성인 검색어 판별 성인 검색어 판별은 입력한 검색어에 대해서 NAVER에서 성인 키워드 해당 여부를 알려주는 API입니다. 요청 URL 및 변수 (request url and parameter) http://openapi.naver.com/search?key=검색용OpenAPI키&target=adult&query=검색하고자하는키워드 변수 명 설명 key OpenAPI를 사용하기 위해 NAVER에서 발급받은 key입니다. target 성인 검색어 판별을 이용하기 위해서 이 값은 항상 adult 이어야 합니다. query 검색하려는 질의문 입니다. UTF-8 형식이어야 합니다. 표 43 성인 검색어 판별 요청 변수 목록 출력 결과 필드 (response field) 필드 명 형식 설명 adult integer 성인 키워드의 해당 여부입니다. 0: 비성인 키워드 1: 성인 키워드 표 44 성인 검색어 판별 출력 필드 목록 29

Slide 31: NAVER open API | 검색 관련 기능 오타 변환 오타 변환은 입력한 검색어가 맞춤법에 맞지 않을 경우 맞춤법에 맞는 단어를 추천하는 API입니다. 요청 URL 및 변수 (request url and parameter) http://openapi.naver.com/search?key=검색용OpenAPI키&target=errata&query=검색하고자하는키워드 변수 명 설명 key OpenAPI를 사용하기 위해 NAVER에서 발급받은 key입니다. target 오타 변환을 이용하기 위해서 이 값은 항상 errata 이어야 �