네이버 책 검색 API를 사용해보자

사이드 프로젝트를 하는 도중 시중에 나온 책에 대한 정보를 얻고싶어서 외부 API를 찾게되었다.
그중 네이버 책 검색 API를 사용해보고 싶어서 글을 작성하게 되었다.

1. 네이버에 본인의 애플리케이션 등록

먼저 API를 사용하기 위해서는 네이버에 애플리케이션을 등록해야한다.

https://developers.naver.com/apps/#/list 이 사이트에서 애플리케이션 등록을 누르면 진행할 수 있다.

사용 api는 검색으로 등록하고 비로그인 오픈 API 서비스 환경을 웹으로 선택한 다음 URL을 추가해준다.
현재는 개발중이라 http://localhost:3000으로 등록하였다.

2. 책 검색 API 파라미터

API에 사용될 파라미터는 다음과 같다.

3. 코드

export const searchBookList = async (query: BookSearchParameterType) => {
  const queryString = new URLSearchParams(query).toString();
  const apiUrl = `https://openapi.naver.com/v1/search/book.json?${queryString}`;

  const data = await fetch(apiUrl, {
    headers: {
      'X-Naver-Client-Id': String(process.env.NAVER_CLIENT_ID),
      'X-Naver-Client-Secret': String(process.env.NAVER_CLIENT_SECRET),
    },
  });

  return data.json();
};

쿼리스트링 형식으로 파라미터를 넣어야하기 때문에 new URLSearchParams 를 이용하여 파라미터 객체를 쿼리스트링 형식으로 바꿔주었다.
header에는 해당 코드의 키 값으로 Client ID 와 Client Secret를 넣어줘야 한다.

내 애플리케이션 > 개요 에서 확인할 수 있다.

마무리

이렇게 간단하게 네이버 책 검색 API를 사용해보았다.
일일 호출 건수도 25000회로 많이 제공되고 있고 사용하면서 불편한 점은 없어서 잘 쓰고 있는 중이다.
문서 설명도 잘 되어있고 예제 코드도 잘 작성되어있어서 쉽게 사용할 수 있는 것 같다.

참고 문서

• 네이버 책 검색 API 문서