백과사전 검색 결과 조회

Classic/VPC 환경에서 이용 가능합니다.

네이버 검색의 백과사전 검색 결과를 조회합니다.

참고

백과사전 검색은 검색 API를 사용하며, 검색 API의 하루 호출 한도는 25,000회입니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드	URI
GET	/search/v1/encyc

요청 헤더

NAVER API HUB에서 공통으로 사용하는 헤더에 대한 정보는 NAVER API HUB 요청 헤더를 참조해 주십시오.

요청 쿼리 파라미터

요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`query`	String	Required	검색어 UTF-8로 인코딩
`display`	Integer	Optional	한 번에 표시할 검색 결과 개수 `1`~`100` (기본값: `10`)
`start`	Integer	Optional	검색 시작 위치 `1`~`1000` (기본값: `1`)
`format`	String	Optional	응답 형식 `json` (기본값) \| `xml`

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request GET https://naverapihub.apigw.ntruss.com/search/v1/encyc?query=커피&display=2&start=1&format=json
--header X-NCP-APIGW-API-KEY-ID: {Client ID}
--header X-NCP-APIGW-API-KEY: {Client Secret}

응답

응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`lastBuildDate`	String	-	검색 결과를 생성한 시간
`total`	Integer	-	총 검색 결과 개수
`start`	Integer	-	검색 시작 위치
`display`	Integer	-	한 번에 표시할 검색 결과 개수
`items`	Array	-	개별 검색 결과 목록: items

items

items에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`title`	String	-	백과사전 표제어 검색어와 일치하는 부분은 `<b>` 태그로 감쌈
`link`	String	-	백과사전 항목 설명의 URL
`description`	String	-	백과사전 항목 설명 내용을 요약한 패시지 정보 검색어와 일치하는 부분은 `<b>` 태그로 감쌈
`thumbnail`	String	-	섬네일 이미지 URL

응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

HTTP 상태 코드	코드	메시지	설명
400	`SE01`	Incorrect query request (잘못된 쿼리요청입니다.)	API 요청 URL의 프로토콜, 파라미터 등에 오류가 있는지 확인
400	`SE02`	Invalid display value (부적절한 display 값입니다.)	`display` 값이 허용 범위인지 확인
400	`SE03`	Invalid start value (부적절한 start 값입니다.)	`start` 값이 허용 범위인지 확인
400	`SE04`	Invalid sort value (부적절한 sort 값입니다.)	`sort` 값에 오타가 있는지 확인
400	`SE06`	Malformed encoding (잘못된 형식의 인코딩입니다.)	검색어를 UTF-8로 인코딩
404	`SE05`	Invalid search api (존재하지 않는 검색 api 입니다.)	API 요청 URL에 오타가 있는지 확인
500	`SE99`	System Error (시스템 에러)	서버 내부에서 오류 발생

참고

NAVER API HUB에서 공통으로 사용하는 응답 상태 코드에 대한 설명은 NAVER API HUB 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

{
    "lastBuildDate": "Thu, 11 Jun 2026 18:43:27 +0900",
    "total": 8101,
    "start": 1,
    "display": 2,
    "items": [
        {
            "title": "<b>커피</b>",
            "link": "https://terms.naver.com/entry.naver?docId=1596581&cid=50346&categoryId=50346",
            "description": "<b>커피</b>영양학사전 <b>커피</b>콩을 볶아 분쇄하여, 독특한 빛깔과 풍미를 뜨거운 물로 추출한 기호음료. 추출액을 분무건조 또는 동결건조로 분말화하면 인스턴트 <b>커피</b>(instant coffee)가 된다. 카페인의 각성 ",
            "thumbnail": ""
        },
        {
            "title": "<b>커피</b>",
            "link": "https://terms.naver.com/entry.naver?docId=3572338&cid=58988&categoryId=58988",
            "description": "2000년대 들어서부터 사람들이 모이는 장소에 <b>커피</b> 한잔은 빼놓을 수 없을 정도로 <b>커피</b>는 대중적인 음료로 자리잡았다. 이제는 프랜차이즈 <b>커피</b> 전문점이 2000개가 넘어섰을 정도로 <b>커피</b>에 대한 관 ",
            "thumbnail": "http://openapi-dbscthumb.phinf.naver.net/4749_000_5/20170316145457666_J4BH4NW44.jpg/02_0.jpg?type=m160_160"
        }
    ]
}

Documentation Index