---
title: "SXA Searchサービス"
slug: "the-sxa-search-service"
abstract: "SXA検索APIパラメータとその使用方法について詳しく学びましょう。"
---
# SXA Searchサービス

SXA Searchサービスは検索コンポーネントで使用されるエンドポイントです。SXAツールボックスから利用可能なほとんどの検索コンポーネントはエンドポイントのデータを利用します。このトピックでは、SXA検索APIパラメータとその目的について説明します。

## サービスURL

各定義されたサイトに対して、SXA Searchサービスは以下のエンドポイントURLでルートを登録します。これらのエンドポイントはSitecore.XA.Feature.Search.Controllers.SearchControllerクラスの公開メソッドに対応します。

-   site/sxa/search/results - [検索結果](https://doc.sitecore.com/xp/ja/developers/sxa/100/sitecore-experience-accelerator/the-sxa-search-service.html#UUID-c054d0d9-3a26-a790-1181-744b2d2c15e1_section-idm4568079983163231568183595518 "Results")を手に入れる。
-   site/sxa/search/facets - [ファセットデータ](https://doc.sitecore.com/xp/ja/developers/sxa/100/sitecore-experience-accelerator/the-sxa-search-service.html#UUID-c054d0d9-3a26-a790-1181-744b2d2c15e1_section-idm4480052142043231568183724555 "Facets")を提供します。
-   site/sxa/search/suggestions\- [提案データ](https://doc.sitecore.com/xp/ja/developers/sxa/100/sitecore-experience-accelerator/the-sxa-search-service.html#UUID-c054d0d9-3a26-a790-1181-744b2d2c15e1_section-idm4608855064208033905815628732 "Suggestions")を提供します。

## 結果

結果エンドポイントは検索を実行し、結果を返します。以下のパラメータを使用できます:

クエリパラメータ

概要

例の値

q

クエリ - 指定された単語で結果を返します。

レンダリング

v

バリアント - 結果をレンダリングするために使用されたバリアント定義項目のID。

{A907975A-8C25-4433-A8ED-02B5FC1EBA29}

s

スコープ - あらかじめ定義されたフィルタリングを提供するスコープ定義項目のID。

{A907975A-8C25-4433-A8ED-02B5FC1EBA29}

l

言語 - 検索結果に含まれる言語バージョン。

英語|PL  
  
英語、プル語

o

順序付け - 指定されたファセットに基づいて結果をソートします。

タイトル、下降

e

オフセット - リターン結果から指定された数の要素を除外します。

30

p

ページサイズ - 指定されたページ数を返します。デフォルト値は20です。

20

g

ジオロケーション - 空間探索に使われるジオロケーションの緯度と経度。

55.676098|12.568337

sc\_site

Sitecoreサイト - コンテキストサイトの名称です。

ショーケース

項目

item ID - 現在のコンテキスト中のアイテムID。

{A907975A-8C25-4433-A8ED-02B5FC1EBA29}

シグ

署名 - 検索結果の署名。

my\_signature\_search

例えば:

https://sxa94\_003432/playground/sxa/search/results/?s={BAFF04C0-7332-4B72-A108-EE9814C62F16}&itemid={81003E8D-4232-433D-849E-6CA9574B5BD1}&v={2CA6BDE6-69BC-4D2A-AC6B-6DD88E300CF9}&p=20&o=Title,Ascending

## ファセット

ファセットサービスは名前に基づいてファセットを検索します。以下のパラメータを使用できます:

クエリパラメータ

概要

例の値

q

クエリ - 検索用のユーザー文字列入力。

レンダリング

s

スコープ - あらかじめ定義されたフィルタリングを提供するスコープ定義項目のID。

{A907975A-8C25-4433-A8ED-02B5FC1EBA29}

f

ファセット - ファセットアイテム名を返す予定です。

更新日、タグ

l

言語 - 検索結果に含まれる言語バージョン。

英語|PL

g

ジオロケーション - 空間探索に使用されるジオロケーションの緯度と経度

55.676098|12.568337

シグ

シグネチャー - 検索結果のシグネチャ

my\_signature\_search

例えば:

https://sxa94\_003432/playground/sxa/search/facets/?f=movie%20type,movie%20rated,movie%20genre&s={BAFF04C0-7332-4B72-A108-EE9814C62F16}&itemid={81003E8D-4232-433D-849E-6CA9574B5BD1}

## 提案

提案エンドポイントは検索提案を返します。このオプションを設定するには、Experience Editorの[Search Box](https://doc.sitecore.com/xp/en/users/sxa/100/sitecore-experience-accelerator/walkthrough--adding-search-functionality-to-your-page.html)レンダリングでコントロール **プロパティ** を開き、**Suggestionsモード** のフィールドで **「予測を表示」** オプションを選択してください。

> !注この機能はsxaSuggesterを使う際に[Solr検索プロバイダー](https://doc.sitecore.com/xp/en/developers/100/platform-administration-and-architecture/configure-the-solr-search-provider.html)でのみ利用可能です。詳細は「[Solrの自動提案を使いましょう](https://doc.sitecore.com/xp/en/developers/100/platform-administration-and-architecture/using-solr-auto-suggest.html)」をご覧ください。

クエリパラメータ

概要

例の値

q

クエリ - 指定された単語で結果を返します。

レンダリング。

v

バリアント - 結果をレンダリングするために使用されたバリアント定義項目のID。

{A907975A-8C25-4433-A8ED-02B5FC1EBA29}

p

ページサイズ - 指定されたページ数を返します。デフォルト値は5です。

5

項目

item ID - 現在のコンテキスト中のアイテムID。

{A907975A-8C25-4433-A8ED-02B5FC1EBA29}

## キャッシュ

デフォルトでは、検索およびファセットリクエストのキャッシュは無効化されています。 Sitecore.XA.Feature.Search.configファイル内の設定を更新できます:

![SXA-search-service-enable.png](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/sxa/100/sitecore-experience-accelerator/images/SXA-search-service-enable.png)