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 (undefined) 

게시글 검색 결과 목록

 
responseMetaData object (responseMetaData) 

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

 

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}