Kakao Developers

페이지 이동경로

문서>
Daum 검색>
REST API

Daum 검색

REST API

이 문서는 다음(Daum) 검색 API 구현 방법을 소개합니다.

이 문서에 포함된 기능은 [도구] > [REST API 테스트]를 통해 사용해 볼 수 있습니다.

웹문서 검색하기

기본 정보

메서드	URL	인증 방식
`GET`	`https://dapi.kakao.com/v2/search/web`	REST API 키

권한	사전 설정	카카오 로그인	사용자 동의
-	-	-	-

다음 검색 서비스에서 질의어로 웹 문서를 검색합니다. 원하는 검색어와 함께 결과 형식 파라미터를 선택적으로 추가할 수 있습니다. 응답 본문은 meta, documents로 구성된 JSON 객체입니다.

요청

헤더

이름	설명	필수
Authorization	`Authorization: KakaoAK ${REST_API_KEY}` 인증 방식, 서비스 앱에서 REST API 키로 인증 요청	O

쿼리 파라미터

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

응답

본문

이름	타입	설명
meta	`Meta`	응답 관련 정보
documents	`Document[]`	응답 결과

Meta

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

Document

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

예제

요청

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

응답

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"
    },
    ...
  ]
}

동영상 검색하기

기본 정보

메서드	URL	인증 방식
`GET`	`https://dapi.kakao.com/v2/search/vclip`	REST API 키

권한	사전 설정	카카오 로그인	사용자 동의
-	-	-	-

카카오 TV, 유투브(Youtube) 등 서비스에서 질의어로 동영상을 검색합니다. 원하는 검색어와 함께 결과 형식 파라미터를 선택적으로 추가할 수 있습니다. 응답 본문은 meta, documents로 구성된 JSON 객체입니다.

요청

헤더

이름	설명	필수
Authorization	`Authorization: KakaoAK ${REST_API_KEY}` 인증 방식, 서비스 앱에서 REST API 키로 인증 요청	O

쿼리 파라미터

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

응답

본문

이름	타입	설명
meta	`Meta`	응답 관련 정보
documents	`Document[]`	응답 결과

Meta

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

Document

이름	타입	설명
title	`String`	동영상 제목
url	`String`	동영상 링크
datetime	`Datetime`	동영상 등록일, ISO 8601 [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].000+[tz]
play_time	`Integer`	동영상 재생시간, 초 단위
thumbnail	`String`	동영상 미리보기 URL
author	`String`	동영상 업로더

예제

요청

curl -v -X GET "https://dapi.kakao.com/v2/search/vclip" \
--data-urlencode "query=AOA" \
-H "Authorization: KakaoAK ${REST_API_KEY}"

응답

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"
    },
    ...
  ]
}

이미지 검색하기

기본 정보

메서드	URL	인증 방식
`GET`	`https://dapi.kakao.com/v2/search/image`	REST API 키

권한	사전 설정	카카오 로그인	사용자 동의
-	-	-	-

다음 검색 서비스에서 질의어로 이미지를 검색합니다. REST API 키를 헤더에 담아 GET으로 요청합니다. 원하는 검색어와 함께 결과 형식 파라미터를 선택적으로 추가할 수 있습니다. 응답 본문은 meta, documents로 구성된 JSON 객체입니다.

요청

헤더

이름	설명	필수
Authorization	`Authorization: KakaoAK ${REST_API_KEY}` 인증 방식, 서비스 앱에서 REST API 키로 인증 요청	O

쿼리 파라미터

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

응답

본문

이름	타입	설명
meta	`Meta`	응답 관련 정보
documents	`Document[]`	응답 결과

Meta

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

Document

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

예제

요청

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

응답

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"
    },
    ...
  ]
}

블로그 검색하기

기본 정보

메서드	URL	인증 방식
`GET`	`https://dapi.kakao.com/v2/search/blog`	REST API 키

권한	사전 설정	카카오 로그인	사용자 동의
-	-	-	-

다음 블로그 서비스에서 질의어로 게시물을 검색합니다. 원하는 검색어와 함께 결과 형식 파라미터를 선택적으로 추가할 수 있습니다. 응답 본문은 meta, documents로 구성된 JSON 객체입니다.

요청

헤더

이름	설명	필수
Authorization	`Authorization: KakaoAK ${REST_API_KEY}` 인증 방식, 서비스 앱에서 REST API 키로 인증 요청	O

쿼리 파라미터

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

응답

본문

이름	타입	설명
meta	`Meta`	응답 관련 정보
documents	`Document[]`	응답 결과

Meta

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

Document

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

예제

요청

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

응답

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"
    },
    ...
  ]
}

책 검색하기

기본 정보

메서드	URL	인증 방식
`GET`	`https://dapi.kakao.com/v3/search/book`	REST API 키

권한	사전 설정	카카오 로그인	사용자 동의
-	-	-	-

다음 책 서비스에서 질의어로 도서 정보를 검색합니다. 원하는 검색어와 함께 결과 형식 파라미터를 선택적으로 추가할 수 있습니다. 응답 본문은 meta, documents로 구성된 JSON 객체입니다.

요청

헤더

이름	설명	필수
Authorization	`Authorization: KakaoAK ${REST_API_KEY}` 인증 방식, 서비스 앱에서 REST API 키로 인증 요청	O

쿼리 파라미터

이름	타입	설명	필수
query	`String`	검색을 원하는 질의어	O
sort	`String`	결과 문서 정렬 방식, accuracy(정확도순) 또는 latest(발간일순), 기본값 accuracy	X
page	`Integer`	결과 페이지 번호, 1~50 사이의 값, 기본 값 1	X
size	`Integer`	한 페이지에 보여질 문서 수, 1~50 사이의 값, 기본 값 10	X
target	`String`	검색 필드 제한 사용 가능한 값: title(제목), isbn (ISBN), publisher(출판사), person(인명)	X

응답

본문

이름	타입	설명
meta	`Meta`	응답 관련 정보
documents	`Document[]`	응답 결과

Meta

이름	타입	설명
total_count	`Integer`	검색된 문서 수
pageable_count	`Integer`	중복된 문서를 제외하고, 처음부터 요청 페이지까지의 노출 가능 문서 수
is_end	`Boolean`	현재 페이지가 마지막 페이지인지 여부, 값이 `false`면 page를 증가시켜 다음 페이지를 요청할 수 있음

Document

이름	타입	설명
title	`String`	도서 제목
contents	`String`	도서 소개
url	`String`	도서 상세 URL
isbn	`String`	ISBN10(10자리) 또는 ISBN13(13자리) 형식의 국제 표준 도서번호(International Standard Book Number) ISBN10 또는 ISBN13 중 하나 이상 포함 두 값이 모두 제공될 경우 공백(' ')으로 구분
datetime	`Datetime`	도서 출판날짜, ISO 8601 형식 [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].000+[tz]
authors	`String[]`	도서 저자 리스트
publisher	`String`	도서 출판사
translators	`String[]`	도서 번역자 리스트
price	`Integer`	도서 정가
sale_price	`Integer`	도서 판매가
thumbnail	`String`	도서 표지 미리보기 URL
status	`String`	도서 판매 상태 정보 (정상, 품절, 절판 등) 상황에 따라 변동 가능성이 있으므로 문자열 처리 지양, 단순 노출 요소로 활용 권장

예제

요청

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

응답

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
  "meta": {
    "is_end": true,
    "pageable_count": 9,
    "total_count": 10
  },
  "documents": [
    {
      "authors": [
        "기시미 이치로",
        "고가 후미타케"
      ],
      "contents": "인간은 변할 수 있고, 누구나 행복해 질 수 있다. 단 그러기 위해서는 ‘용기’가 필요하다고 말한 철학자가 있다. 바로 프로이트, 융과 함께 ‘심리학의 3대 거장’으로 일컬어지고 있는 알프레드 아들러다. 『미움받을 용기』는 아들러 심리학에 관한 일본의 1인자 철학자 기시미 이치로와 베스트셀러 작가인 고가 후미타케의 저서로, 아들러의 심리학을 ‘대화체’로 쉽고 맛깔나게 정리하고 있다. 아들러 심리학을 공부한 철학자와 세상에 부정적이고 열등감 많은",
      "datetime": "2014-11-17T00:00:00.000+09:00",
      "isbn": "8996991341 9788996991342",
      "price": 14900,
      "publisher": "인플루엔셜",
      "sale_price": 13410,
      "status": "정상판매",
      "thumbnail": "https://search1.kakaocdn.net/thumb/R120x174.q85/?fname=http%3A%2F%2Ft1.daumcdn.net%2Flbook%2Fimage%2F1467038",
      "title": "미움받을 용기",
      "translators": [
        "전경아"
      ],
      "url": "https://search.daum.net/search?w=bookpage&bookId=1467038&q=%EB%AF%B8%EC%9B%80%EB%B0%9B%EC%9D%84+%EC%9A%A9%EA%B8%B0"
    },
    ...
  ]
}

카페 검색하기

기본 정보

메서드	URL	인증 방식
`GET`	`https://dapi.kakao.com/v2/search/cafe`	REST API 키

권한	사전 설정	카카오 로그인	사용자 동의
-	-	-	-

다음 카페 서비스에서 질의어로 게시물을 검색합니다. 원하는 검색어와 함께 결과 형식 파라미터를 선택적으로 추가할 수 있습니다. 응답 본문은 meta, documents로 구성된 JSON 객체입니다.

요청

헤더

이름	설명	필수
Authorization	`Authorization: KakaoAK ${REST_API_KEY}` 인증 방식, 서비스 앱에서 REST API 키로 인증 요청	O

쿼리 파라미터

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

응답

본문

이름	타입	설명
meta	`Meta`	응답 관련 정보
documents	`Document[]`	응답 결과

Meta

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

Document

이름	타입	설명
title	`String`	카페 글 제목
contents	`String`	카페 글 내용중 일부
url	`String`	카페 글 URL
cafename	`String`	카페 이름
thumbnail	`String`	카페 글 대표 미리보기 이미지 URL
datetime	`Datetime`	카페 글 작성시간, ISO 8601 형식 [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].000+[tz]

예제

요청

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

응답

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"
    },
    ...
  ]
}

menu

시작하기

로그인

커뮤니케이션

지도/로컬

내비게이션

검색

인공지능

광고

결제

더 보기

Daum 검색

REST API

웹문서 검색하기

기본 정보

요청

헤더

쿼리 파라미터

응답

본문

Meta

Document

예제

요청

응답

동영상 검색하기

기본 정보

요청

헤더

쿼리 파라미터

응답

본문

Meta

Document

예제

요청

응답

이미지 검색하기

기본 정보

요청

헤더

쿼리 파라미터

응답

본문

Meta

Document

예제

요청

응답

블로그 검색하기

기본 정보

요청

헤더

쿼리 파라미터

응답

본문

Meta

Document

예제

요청

응답

책 검색하기

기본 정보

요청

헤더

쿼리 파라미터

응답

본문

Meta

Document

예제

요청

응답

카페 검색하기

기본 정보

요청

헤더

쿼리 파라미터

응답

본문