GET/boards/posts/search

権限のある掲示板の投稿を検索する。

  • 検索対象 : タイトル、本文、コメント、添付ファイル (ファイル名・コンテンツ)
  • 検索結果は、関連度の降順でソートされる。
  • 既読数 (readCount) は常に 0 で、必読情報 (isMustRead / mustReadPeriod) は検索結果に含まれない。

Authorization

oauth2

Access Token を指定します。
指定の方法や Access Token の取得方法は 共通仕様 を参照してください。

Scope

board
board.read

HTTP Request

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

Query Parameters

ParameterTypeDescription
query string 

検索語

  • 大文字・小文字は区別されない。
  • URL encode して指定する

required
minLength : 1
maxLength : 100
example : 議事録 
boardIds string 

検索対象の掲示板 ID

  • 複数を指定する場合にはカンマ (,) で区切る
  • 指定しない場合には、読み取り権限のあるすべての掲示板を対象に検索する

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 

次のリストのカーソル値 (URL エンコードする)


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}