GET/boards/posts/search

권한이 있는 게시판의 게시글을 검색한다.
검색어(query)는 필수이다.

  • 기본 검색 대상: 제목, 본문, 댓글, 첨부 파일(파일명·내용)
  • 검색어는 대소문자를 구분하지 않으며, URL 인코딩을 적용해야 한다.
  • 검색 결과는 관련도(relevance) 내림차순으로 정렬된다.
  • 응답은 게시글 목록 조회와 동일한 모델을 사용하며, 검색 응답에서만 snippet과 boardName이 추가로 제공된다.
  • readCount는 검색 인덱스에 동기화되지 않아 항상 0이며, 필독 정보(isMustRead/mustReadPeriod)는 검색 결과에서 제공되지 않는다.
  • 게시글 등록/수정 후 검색 인덱스 반영까지 수 초간 지연될 수 있다.
  • rate limit은 Open API 공통 rate limit 정책을 따른다.

Authorization

oauth2

OAuth 2.0 인증.
자세한 인증 방식은 인가·인증을 참고한다.

Scope

board
board.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/boards/posts/search

Query Parameters

ParameterTypeDescription
query string 

검색어


required
minLength : 1
maxLength : 100
example : 회의록 
boardIds string 

검색 대상 게시판 ID(쉼표로 구분, 최대 50개)
미지정 시 읽기 권한이 있는 모든 게시판에서 검색한다.


example : 1,2,3 
hasAttachment boolean 

첨부 파일이 있는 게시글만 검색할지 여부


default : false
example : false 
writerId string 

작성자 사용자 ID


example : ba59054b-4345-46f7-19d6-03de1d47fe8f 
startTime string 

검색 기간 시작 날짜(YYYY-MM-DD 형식)
미지정 시 전체 기간을 검색하며, 최대 검색 기간에 제한은 없다.


example : 2026-01-01
format : date 
endTime string 

검색 기간 종료 날짜(YYYY-MM-DD 형식)
미지정 시 오늘까지 검색한다.


example : 2026-04-28
format : date 
count integer 

목록 조회 개수


default : 20
minimum : 1
maximum : 40
example : 40
format : int32 
cursor string 

다음 목록 조회 시 사용하는 값


example : JlIBsfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA== 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

OK

PropertyTypeDescription
posts array (posts) 

게시글 검색 결과 목록

 
responseMetaData object (responseMetaData) 

페이지 매김 처리를 위한 메타데이터

 

posts

PropertyTypeDescription
boardId integer 

게시판 번호


format : int64 
postId integer 

게시글 번호


format : int64 
title string 

제목


required 
readCount integer 

읽은 횟수
게시글 검색 응답에서는 검색 인덱스에 동기화되지 않아 항상 0이다.


format : int64 
commentCount integer 

댓글 수


format : int64 
fileCount integer 

파일 수


format : int64 
createdTime string 

생성 시간

  • 날짜 및 시간, 분, 초 형식(YYYY-MM-DDThh:mm:ssTZD)

required
format : date-time
readOnly : true 
modifiedTime string 

수정 시간

  • 날짜 및 시간, 분, 초 형식(YYYY-MM-DDThh:mm:ssTZD)

format : date-time
readOnly : true 
isMustRead boolean 

현재 필독 여부

 
mustReadPeriod object (mustReadPeriod) 

필독 기간

 
resourceLocation integer 

해당 리소스 위치(지역 코드)


format : int32 
isUnread boolean 

안 읽음 여부

 
userId string 

작성자 ID
탈퇴된 계정인 경우에는 제공되지 않는다.


readOnly : true
nullable : true 
userName string 

작성자 이름


readOnly : true 
snippet string 

검색어와 일치한 부분의 발췌(최대 200자)
일치한 검색어는 <mark> 요소로 강조 표시되며, 그 외 HTML 태그는 포함되지 않는다.

 
boardName string 

게시판 이름

 

mustReadPeriod

PropertyTypeDescription
startDate string 

필독 시작일


format : date
readOnly : true 
endDate string 

필독 종료일


format : date 

responseMetaData

PropertyTypeDescription
nextCursor string 

다음 페이지 조회를 위한 커서

 

Response Example

example

1{2  "posts": [3    {4      "boardId": 100,5      "postId": 1,6      "title": "주간 회의록",7      "readCount": 0,8      "commentCount": 2,9      "fileCount": 1,10      "createdTime": "2026-04-20T10:30:00+09:00",11      "modifiedTime": "2026-04-21T14:15:00+09:00",12      "isMustRead": false,13      "isUnread": true,14      "userId": "userf7da-f82c-4284-13e7-030f3b4c756x",15      "userName": "Susan Nielsen",16      "snippet": "이번 주 <mark>회의록</mark>을 공유합니다.",17      "boardName": "Notice"18    }19  ],20  "responseMetaData": {21    "nextCursor": "JlIBsfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA=="22  }23}