achangsulee / search.blog

검색 API

블로그 검색 API 를 이용하여 블로그 글을 검색하는 API 서버입니다.

Daum 블로그 글을 먼저 검색하고 오류 발생시 Naver 블로그를 검색합니다. (source 파라미터로 검색 위치를 변경할 수 있습니다.)

인기 검색어 상위 10개를 빈도수와 함께 조회할 수 있습니다.

블로그 검색

GET /search HTTP/1.1

Request

Parameter

Name	Type	Description	Required
keyword	String	검색을 원하는 질의어	O
size	Integer	한 페이지에 보여질 문서 수, 1~50 사이의 값, 기본값 10	X
page	Integer	결과 페이지 번호, 1~50 사이의 값, 기본 값 1	X
sort	String	결과 문서 정렬 방식, accuracy(정확도순) 또는 recency(최신순), 기본 값 accuracy	X
source	String	Daum or Naver 블로그 선택값, daum(다음) 또는 naver(네이버), 기본값 daum	X

• Response 는 소스별로 상이하나, 페이지 기반으로 블로그 검색 결과를 응답.

인기 키워드 조회

GET /popular HTTP/1.1

• 검색된 키워드를 빈도수로 정렬하여 상위 10개의 키워드를 응답
• 빈도수가 같은 경우 키워드로 정렬

---

• Java version: 17
• spring boot version: 3.0.4

---

프로젝트 루트에 있는 jar 파일을 이용해 서버를 실행시킬 수 있습니다.

• java -jar search.blog-0.0.1-SNAPSHOT.jar

swagger: http://localhost:8080/swagger-ui/index.html