This is a cache of https://fess.codelibs.org/ja/15.2/api/api-suggest.html. It is a snapshot of the page at 2025-10-25T00:13:29.098+0000.

サジェストAPI

サジェストAPI

サジェストワード一覧の取得

Fess に、 http://<Server Name>/api/v1/suggest-words?q=サジェストワード のリクエストを送ることで、Fess に登録されているサジェストワードの一覧をJSON形式で受け取ることができます。サジェストワードAPIを利用するには、管理画面のシステム全般の設定でドキュメントでサジェスト、検索語でサジェストを有効にしておく必要があります。

リクエストパラメーター

使用できるリクエストパラメーターは以下の通りです。

リクエストパラメーター
q	サジェストを行うキーワード。 (例) `q=fess`
num	サジェストされる単語の数。デフォルト10。 (例) `num=20`
label	フィルターされたラベル名。 (例) `fields=java,python`
fields	サジェスト対象を絞り込むフィールド名。デフォルト絞り込みなし。 (例) `fields=content,title`
lang	検索言語の指定。 (例) `lang=en`

レスポンス

以下のようなレスポンスが返ります。

{
  "query_time": 18,
  "record_count": 355,
  "page_size": 10,
  "data": [
    {
      "text": "fess",
      "labels": [
        "java",
        "python"
      ]
    }
  ]
}

各要素については以下の通りです。

レスポンス情報
query_time	クエリ処理時間。
record_count	サジェストワードのの登録件数。
data	検索結果の親要素。
text	サジェストワード。
labels	ラベルの値。