검색

Daum의 방대한 웹문서, 동영상, 이미지, 블로그, 팁, 책, 카페 서비스에 대한 검색 결과를 전달하는 API 입니다.

현재 제공되는 검색 API는 다음과 같습니다.

웹문서 검색

[Request]

GET /v2/search/web HTTP/1.1
Host: dapi.kakao.com
Authorization: KakaoAK {app_key}

앱키를 헤더에 담아 GET으로 요청합니다. 원하는 검색어와 함께 결과 형식 파라미터의 값을 선택적으로 추가할 수 있습니다.

설명 필수 타입
query 검색을 원하는 질의어 O String
sort 결과 문서 정렬 방식 X (accuracy) accuracy (정확도순) or recency (최신순)
page 결과 페이지 번호 X(기본 1) 1-50 사이 Integer
size 한 페이지에 보여질 문서의 개수 X(기본 10) 1-50 사이 Integer


예를 들면,

curl -v -X GET "https://dapi.kakao.com/v2/search/web" \
--data-urlencode "query=이효리" \
-H "Authorization: KakaoAK kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk"

[Response]

응답 바디는 JSON 객체로 meta와 documents로 구성됩니다.

meta

설명 타입
total_count 검색어에 검색된 문서수 Integer
pageable_count total_count 중에 노출가능 문서수 Integer
is_end 현재 페이지가 마지막 페이지인지 여부. 값이 false이면 page를 증가시켜 다음 페이지를 요청할 수 있음. Boolean

document

설명 타입
title 문서 제목 String
contents 문서 본문중 일부 String
url 문서 URL String
datetime 문서 글 작성시간. ISO 8601. [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].000+[tz] String

예를 들면,

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
  "meta": {
    "total_count": 897323,
    "pageable_count": 775,
    "is_end": false
  },
  "documents": [
    {
      "datetime": "2017-06-14T00:00:00.000+09:00",
      "contents": "이름 <b>이효리</b>(李孝利) 출생 1979년 5월 10일, 충청북도 청주시 흥덕구 오송읍[1] 나이 39세 (만 38세) 본관 광주 이씨 [2] 신체 164cm, 53kg, A형 학력 서울동작초등학교 서문여자중학교 서문여자고등학교...",
      "title": "<b>이효리</b> - 나무위키",
      "url": "https://namu.wiki/w/%EC%9D%B4%ED%9A%A8%EB%A6%AC"
    },
    ...
  ]
}

동영상 검색

[Request]

GET /v2/search/vclip HTTP/1.1
Host: dapi.kakao.com
Authorization: KakaoAK {app_key}

앱키를 헤더에 담아 GET으로 요청합니다. 원하는 검색어와 함께 결과 형식 파라미터의 값을 선택적으로 추가할 수 있습니다.

설명 필수 타입
query 검색을 원하는 질의어 O String
sort 결과 문서 정렬 방식 X (accuracy) accuracy (정확도순) or recency (최신순)
page 결과 페이지 번호 X(기본 1) 1-15 사이 Integer
size 한 페이지에 보여질 문서의 개 X(기본 15) 1-30 사이 Integer


예를 들면,

curl -v -X GET "https://dapi.kakao.com/v2/search/vclip?query=AOA" \
-H "Authorization: KakaoAK kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk"

[Response]

응답 바디는 JSON 객체로 meta와 documents로 구성됩니다.

meta

설명 타입
total_count 검색어에 검색된 문서수 Integer
pageable_count total_count 중에 노출가능 문서수 Integer
is_end 현재 페이지가 마지막 페이지인지 여부. 값이 false이면 page를 증가시켜 다음 페이지를 요청할 수 있음. Boolean

document

설명 타입
title 동영상 제목 String
url 동영상 링크 String
datetime 동영상 등록일. ISO 8601. [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].000+[tz] String
play_time 동영상 재생시간 (단위 : 초) Integer
thumbnail 동영상 썸네일 URL String
author 동영상 업로더 String

예를 들면,

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
  "meta": {    
    "total_count": 6033,
    "pageable_count" : 800,
    "is_end": false
  },
  "documents": [
    {
      "title": "AOA 지민·김용만, 돼지꼬리 맛에 정신혼미 ‘극찬세례’",
      "play_time": 185,
      "thumbnail": "https://search2.kakaocdn.net/argon/138x78_80_pr/FRkbdWEKr4F",
      "url": "http://tv.kakao.com/channel/2653417/cliplink/304487728?playlistId=87634",
      "datetime": "2017-05-06T00:36:45+09:00",
      "author": "_SBS"
    },
    ...
  ]
}

이미지 검색

[Request]

GET /v2/search/image HTTP/1.1
Host: dapi.kakao.com
Authorization: KakaoAK {app_key}

앱키를 헤더에 담아 GET으로 요청합니다. 원하는 검색어와 함께 결과 형식 파라미터의 값을 선택적으로 추가할 수 있습니다.

설명 필수 타입
query 검색을 원하는 질의어 O String
sort 결과 문서 정렬 방식 X (accuracy) accuracy (정확도순) or recency (최신순)
page 결과 페이지 번호 X(기본 1) 1-50 사이 Integer
size 한 페이지에 보여질 문서의 개수 X(기본 80) 1-80 사이 Integer


예를 들면,

curl -v -X GET "https://dapi.kakao.com/v2/search/image" \
--data-urlencode "query=설현" \
-H "Authorization: KakaoAK kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk"

[Response]

응답 바디는 JSON 객체로 meta와 documents로 구성됩니다.

meta

설명 타입
total_count 검색어에 검색된 문서수 Integer
pageable_count total_count 중에 노출가능 문서수 Integer
is_end 현재 페이지가 마지막 페이지인지 여부. 값이 false이면 page를 증가시켜 다음 페이지를 요청할 수 있음. Boolean

document

설명 타입
collection 컬렉션 String
thumbnail_url 이미지 썸네일 URL String
image_url 이미지 URL String
width 이미지의 가로 크기 Integer
height 이미지의 세로 크기 Integer
display_sitename 출처명 String
doc_url 문서 URL String
datetime 문서 작성시간. ISO 8601. [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].000+[tz] String

예를 들면,

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
  "meta": {
    "total_count": 422583,
    "pageable_count": 3854,
    "is_end": false
  },
  "documents": [
    {
      "collection": "news",
      "thumbnail_url": "https://search2.kakaocdn.net/argon/130x130_85_c/36hQpoTrVZp",
      "image_url": "http://t1.daumcdn.net/news/201706/21/kedtv/20170621155930292vyyx.jpg",
      "width": 540,
      "height": 457,
      "display_sitename": "한국경제TV",
      "doc_url": "http://v.media.daum.net/v/20170621155930002",
      "datetime": "2017-06-21T15:59:30.000+09:00"
    },
    ...
  ]
}

블로그 검색

[Request]

GET /v2/search/blog HTTP/1.1
Host: dapi.kakao.com
Authorization: KakaoAK {app_key}

앱키를 헤더에 담아 GET으로 요청합니다. 원하는 검색어와 함께 결과 형식 파라미터의 값을 선택적으로 추가할 수 있습니다.

설명 필수 타입
query 검색을 원하는 질의어. 특정 블로그 글만 검색하고 싶은 경우 블로그 url과 검색어를 ' '(공백) 구분자로 넣을 수 있음. O String
sort 결과 문서 정렬 방식 X (accuracy) accuracy (정확도순) or recency (최신순)
page 결과 페이지 번호 X(기본 1) 1-50 사이 Integer
size 한 페이지에 보여질 문서의 개수 X(기본 10) 1-50 사이 Integer


예를 들면,

curl -v -X GET "https://dapi.kakao.com/v2/search/blog" \
--data-urlencode "query=https://brunch.co.kr/@tourism 집짓기" \
-H "Authorization: KakaoAK kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk"

[Response]

응답 바디는 JSON 객체로 meta와 documents로 구성됩니다.

meta

설명 타입
total_count 검색어에 검색된 문서수 Integer
pageable_count total_count 중에 노출가능 문서수 Integer
is_end 현재 페이지가 마지막 페이지인지 여부. 값이 false이면 page를 증가시켜 다음 페이지를 요청할 수 있음. Boolean

document

설명 타입
title 블로그 글 제목 String
contents 블로그 글 요약 String
url 블로그 글 URL String
blogname 블로그의 이름 String
thumbnail 검색시스템에서 추출한 대표썸네일. (썸네일 크기/화질은 변경될 수 있음.) String
datetime 블로그 글 작성시간. ISO 8601. [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].000+[tz] String

예를 들면,

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
  "meta": {
    "total_count": 5,
    "pageable_count": 5,
    "is_end": true
  },
  "documents": [
    {
    "title": "작은 <b>집</b> <b>짓기</b> 기본컨셉 - <b>집</b><b>짓기</b> 초기구상하기",    
    "contents": "이 점은 <b>집</b>을 지으면서 고민해보아야 한다. 하지만, 금액에 대한 가성비 대비 크게 문제되지 않을 부분이라 생각하여 설계로 극복하자고 생각했다. 전체 <b>집</b><b>짓기</b>의 기본방향은 크게 세 가지이다. 우선은 여가의 영역 증대이다. 현대 시대 일도 중요하지만, 여가시간 <b>집</b>에서 어떻게 보내느냐가 중요하니깐 이를 기본적...",
    "url": "https://brunch.co.kr/@tourism/91",
    "blogname": "정란수의 브런치",
    "thumbnail": "http://search3.kakaocdn.net/argon/130x130_85_c/7r6ygzbvBDc",
    "datetime": "2017-05-07T18:50:07.000+09:00"
    },
    ...
  ]
}

팁 검색

[Request]

GET /v2/search/tip HTTP/1.1
Host: dapi.kakao.com
Authorization: KakaoAK {app_key}

앱키를 헤더에 담아 GET으로 요청합니다. 원하는 검색어와 함께 결과 형식 파라미터의 값을 선택적으로 추가할 수 있습니다.

설명 필수 타입
query 검색을 원하는 질의어 O String
sort 결과 문서 정렬 방식 X (accuracy) accuracy (정확도순) or recency (최신순)
page 결과 페이지 번호 X(기본 1) 1-50 사이 Integer
size 한 페이지에 보여질 문서의 개수 X(기본 10) 1-50 사이 Integer


예를 들면,

curl -v -X GET "https://dapi.kakao.com/v2/search/tip" \
--data-urlencode "query=카카오톡" \
-H "Authorization: KakaoAK kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk"

[Response]

응답 바디는 JSON 객체로 meta와 documents로 구성됩니다.

meta

설명 타입
total_count 검색어에 검색된 문서수 Integer
pageable_count total_count 중에 노출가능 문서수 Integer
is_end 현재 페이지가 마지막 페이지인지 여부. 값이 false이면 page를 증가시켜 다음 페이지를 요청할 수 있음. Boolean

document

설명 타입
title 글 제목 String
contents 팁 본문 일부(스니핏 추출) String
q_url 팁 질문 글 URL String
a_url 팁 답변 글 URL String
thumbnails 팁 글에 대한 이미지 썸네일들 Array of String
type 검색된 글이 답변인지 질문인지 여부 Q or A
datetime 팁 질문 글 작성시간. ISO 8601. [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].000+[tz] String

예를 들면,

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
  "meta": {
    "is_end": false,
    "pageable_count": 991,
    "total_count": 103474
  },
  "documents": [
    {
      "title": "&#39;<b>카카오톡</b>&#39; 질문합니다 <b>카카오톡</b>이지워졋으요 설치해주세요",
      "contents": "<b>카카오톡</b>이 지워졌다는것은 크게 두가지로 볼 수 있습니다. 1. 바탕화면에서 지워졌다. 이는 <b>카카오톡</b>이 설치되어 있지만 아이콘만 사라졌음을 알 수 있습니다. 이 경우...",
      "a_url": "http://tip.daum.net/answer/93699202",
      "q_url": "http://tip.daum.net/question/93688106",
      "thumbnails": [],
      "type": "A",
      "datetime": "2017-03-31T08:35:44.000+09:00"
    },
    ...
  ]
}

책 검색

[Request]

GET /v2/search/book HTTP/1.1
Host: dapi.kakao.com
Authorization: KakaoAK {app_key}

앱키를 헤더에 담아 GET으로 요청합니다. 원하는 검색어와 함께 결과 형식 파라미터의 값을 선택적으로 추가할 수 있습니다.

설명 필수 타입
query 검색을 원하는 질의어 O String
sort 결과 문서 정렬 방식 X (accuracy) accuracy (정확도순) or recency (최신순) or sales (판매량순)
page 결과 페이지 번호 X(기본 1) 1-50 사이 Integer
size 한 페이지에 보여질 문서의 개수 X(기본 10) 1-50 사이 Integer
target 검색 필드 제한 X (all) all (전체) or title (제목에서 검색) or isbn (ISBN에서 검색) or keyword (주제어에서 검색) or contents (목차에서 검색) or overview (책소개에서 검색) or publisher (출판사에서 검색)
category 카테고리 필터링 X Integer. 아래 category table에 정의된 값 참조.
category
대분류 중분류 category
국내도서 소설 1
국내도서 시/에세이 3
국내도서 인문 5
국내도서 가정/생활 7
국내도서 요리 8
국내도서 건강 9
국내도서 취미/스포츠 11
국내도서 경제/경영 13
국내도서 자기계발 15
국내도서 정치/사회 17
국내도서 정부간행물 18
국내도서 역사/문화 19
국내도서 종교 21
국내도서 예술/대중문화 23
국내도서 중/고등학습 25
국내도서 기술/공학 26
국내도서 외국어 27
국내도서 과학 29
국내도서 취업/수험서 31
국내도서 여행/기행 32
국내도서 컴퓨터/IT 33
국내도서 잡지 35
국내도서 사전 37
국내도서 청소년 38
국내도서 초등참고서 39
국내도서 유아 41
국내도서 아동 42
국내도서 어린이영어 45
국내도서 만화 47
국내도서 대학교재 50
국내도서 어린이전집 51
국내도서 한국소개도서 53
e북 소설 901
e북 장르소설 902
e북 시/에세이 903
e북 경제/경영 904
e북 자기계발 905
e북 인문 906
e북 정치/사회 907
e북 로맨스/무협/판타지 908
e북 종교 909
e북 예술/대중문화 910
e북 가정/생활 911
e북 건강 912
e북 여행/취미 913
e북 청소년 914
e북 학습/수험서 915
e북 유아 916
e북 아동 917
e북 외국어/사전 918
e북 과학 919
e북 컴퓨터/IT 920
e북 잡지 921
e북 만화 922
e북 외국도서 923
e북 무료eBook 924
e북 개인출판 925
e북 오디오북 926
e북 연재 951
e북 eReader Free 953
영미도서 문학 101
영미도서 취미/실용/여행 103
영미도서 생활/요리/건강 105
영미도서 예술/건축 107
영미도서 인문/사회 109
영미도서 경제/경영 111
영미도서 과학/기술 113
영미도서 아동 115
영미도서 한국관련도서 117
영미도서 NON_BOOK 119
영미도서 UMI 120
영미도서 ELT/영어교재 181
영미도서 어린이영어 183
영미도서 대학교재 191
영미도서 중국관련도서 194
일본도서 일서메인 239
일본도서 잡지 241
일본도서 엔터테인먼트 243
일본도서 만화 245
일본도서 문학 247
일본도서 라이트노벨 249
일본도서 문고(포켓북) 251
일본도서 신서(포켓북) 253
일본도서 아동 255
일본도서 실용서/예술 257
일본도서 인문/사회 259
일본도서 자연/기술과학 261
일본도서 어학/학습/사전 263
일본도서 문구/멀티/기타 264
일본도서 중국관련도서 267
프랑스도서 프랑스종합 486
독일도서 독일종합 588
스페인도서 스페인종합 690
미분류 미분류 0


예를 들면,

curl -v -X GET "https://dapi.kakao.com/v2/search/book?target=title" \
--data-urlencode "query=미움받을 용기" \
-H "Authorization: KakaoAK kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk"

[Response]

응답 바디는 JSON 객체로 meta와 documents로 구성됩니다.

meta

설명 타입
total_count 검색어에 검색된 문서수 Integer
pageable_count total_count 중에 노출가능 문서수 Integer
is_end 현재 페이지가 마지막 페이지인지 여부. 값이 false이면 page를 증가시켜 다음 페이지를 요청할 수 있음. Boolean

document

설명 타입
title 도서 제목 String
contents 도서 소개 String
url 책 링크 (URL) String
isbn ISBN 번호. 국제 표준 도서번호(ISBN10,ISBN13) (ISBN10,ISBN13 중에 하나 이상 존재하면 ' '(공백)을 구분자로 출렴됨) String
datetime 도서 출판날짜. ISO 8601. [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].000+[tz] String
authors 도서 저자 리스트 Array of String
publisher 출판사 String
translators 번역자 리스트 Array of String
price 도서 정가 String
sale_price 도서 판매가 String
sale_yn 도서 판매 여부 Y or N
category 도서 카테고리 정보 String
thumbnail 도서 표지 썸네일 String
barcode 교보문고 바코드 정보 String
ebook_barcode 교보문고 전자책 바코드 정보 String
status 도서 상태 정보(정상, 품절, 절판 등). 변경 가능성이 있으니 노출용으로만 사용 권장. String

예를 들면,

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
  "meta": {
    "total_count": 49,
    "pageable_count": 49,
    "is_end": false
  },
  "documents": [
    {
      "title": "미움받을 용기",
      "contents": "다음 웹툰 X 《미움받을 용기》 스페셜 리커버 에디션!  청춘들이 가장 사랑하는 웹툰작가 만물상과 S_owl, 김경, 이은재가 선보이는 《미움받을 용기》 스페셜 리커버 에디션이 출간되었다...",
      "url": "http://book.daum.net/detail/book.do?bookid=KOR9788996991342",
      "isbn": "8996991341 9788996991342",
      "datetime": "2014-11-17T00:00:00.000+09:00",
      "authors": [
        "기시미 이치로",
        "고가 후미타케"
      ],
      "publisher": "인플루엔셜",
      "translators": [
        "전경아"
      ],
      "price": 14900,
      "sale_price": 13410,
      "sale_yn": "Y",
      "category": "인문",
      "thumbnail": "http://t1.daumcdn.net/thumb/R72x100/?fname=http%3A%2F%2Ft1.daumcdn.net%2Fbook%2FKOR9788996991342%3Fmoddttm=20170620104117",
      "barcode": "KOR9788996991342",
      "ebook_barcode": "DGT4808996991342",
      "status": "정상판매"
    },
    ...
  ]
}

카페 검색

[Request]

GET /v2/search/cafe HTTP/1.1
Host: dapi.kakao.com
Authorization: KakaoAK {app_key}

앱키를 헤더에 담아 GET으로 요청합니다. 원하는 검색어와 함께 결과 형식 파라미터의 값을 선택적으로 추가할 수 있습니다.

설명 필수 타입
query 검색을 원하는 질의어 O String
sort 결과 문서 정렬 방식 X (accuracy) accuracy (정확도순) or recency (최신순)
page 결과 페이지 번호 X(기본 1) 1-50 사이 Integer
size 한 페이지에 보여질 문서의 개수 X(기본 10) 1-50 사이 Integer


예를 들면,

curl -v -X GET "https://dapi.kakao.com/v2/search/cafe" \
--data-urlencode "query=아이유" \
-H "Authorization: KakaoAK kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk"

[Response]

응답 바디는 JSON 객체로 meta와 documents로 구성됩니다.

meta

설명 타입
total_count 검색어에 검색된 문서수 Integer
pageable_count total_count 중에 노출가능 문서수 Integer
is_end 현재 페이지가 마지막 페이지인지 여부. 값이 false이면 page를 증가시켜 다음 페이지를 요청할 수 있음. Boolean

document

설명 타입
title 카페 글 제목 String
contents 카페 글 내용중 일부 String
url 카페 글 URL String
cafename 카페 이름 String
thumbnail 카페 글 대표 썸네일 String
datetime 도서 출판날짜. ISO 8601. [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].000+[tz] String

예를 들면,

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
  "meta": {
    "is_end": false,
    "pageable_count": 983,
    "total_count": 218662
  },
  "documents": [
    {
      "cafename": "쭉빵카페",
      "contents": "무대의상들 정보 궁금해하는 게녀들이 있길래 가져왔어! 이번에는 레드벨벳이랑 <b>아이유</b> 의상만 가져왔는데 기회가 되면 다음에 다른 연예인들 의상도 가져올게~ 링크가...",
      "datetime": "2017-01-31T16:57:33.000+09:00",
      "thumbnail": "https://search1.kakaocdn.net/thumb/P100x100/?fname=http%3A%2F%2Fsearch1.kakaocdn.net%2Fargon%2F130x130_85_c%2FFJtvuJLusO",
      "title": "연예인 무대의상 정보 가져왔어! (feat. 레드벨벳, <b>아이유</b>)",
      "url": "http://cafe.daum.net/ok1221/9fQk/39709"
    },
    ...
  ]
}

Last Modified : 2017-10-10