メインコンテンツへスキップ
GET
/
endpoint
検索結果の取得
curl --request GET \
  --url https://api.example.com/endpoint
Kameleoon Search サービスは 2 種類の検索を提供します。
  • 即時検索(タイプアヘッド検索): ユーザーが検索クエリを入力するたびに結果を表示および更新します。
  • 完全検索: ユーザーが検索クエリを送信した後に完全でフィルタリングされた検索結果を返します。
両方のオプションは同じエンドポイントを使用します。検索タイプを指定するには type パラメーターを使用します。

​
リクエスト

GET https://api.products.kameleoon.com/search

​
クエリパラメーター

これらのクエリパラメーターは完全検索と即時検索の両方に適用されます。追加のパラメーターは完全検索でのみ使用してください。
パラメーター型必須説明
didStringTrueデバイス ID。KameleoonProducts_device_id クッキーからこの ID を取得します。このエンドポイントを呼び出す前に、バックエンドから取得してください。“Recently Viewed” や “Recommended for You” など、過去のデバイスデータに依存するフィルターまたはアルゴリズムを使用する場合にのみ did を提供します。
sidStringTrue一時的なユーザーセッション ID。KameleoonProducts_session_code クッキーからこの ID を取得します。このエンドポイントを呼び出す前に、バックエンドから取得してください。“Recently Viewed” や “Recommended for You” など、過去のユーザーデータに依存するフィルターまたはアルゴリズムを使用する場合にのみ sid を提供します。
shop_idStringTrueストアキー。Kameleoon アプリの Recommendations > Settings > Store settings で確認できます。必要に応じてカスタマーサクセスマネージャーにキーをお問い合わせください。
typeStringTrue検索タイプを指定します: instant_search または full_search。
search_queryStringTrue現在の検索クエリ。
locationsListOptional場所 ID のカンマ区切りリスト。

​
追加のクエリパラメーター(完全検索のみ)

これらの追加パラメーターは完全検索リクエスト(type=full_search)で使用してください。
パラメーター型必須説明
limitIntegerOptionalAPI が返す結果の最大数。
offsetIntegerOptional結果のオフセット。
category_limitIntegerOptionalサイドバーフィルターのカテゴリの最大数。
categoriesListOptionalフィルタリング用のカテゴリのカンマ区切りリスト。
extendedInteger or emptyOptional商品結果の拡張情報を追加します。サポートされる値: 1 または空。1 の場合、API はすべての商品情報を返します。空の場合、API は商品 ID のみを返します。Kameleoon は完全検索の場合これを 1 に設定することをお勧めします。
sort_byStringOptionalソートパラメーター。サポートされる値: popular、price、discount、sales_rate、date。
orderStringOptionalソート方向: asc(昇順)または desc(降順)。デフォルトは desc です。
brandsListOptionalフィルタリング用のブランドのカンマ区切りリスト。
filtersStringOptionalフィルターパラメーターを含むエスケープされた JSON 文字列。例: {"bluetooth":["yes"],"offers":["15% cashback"],"weight":["1.6"]}
price_minIntegerOptional最低価格。
price_maxIntegerOptional最高価格。
colorsIntegerOptional色のカンマ区切りリスト。
excludeIntegerOptional検索結果から除外する商品 ID のカンマ区切りリスト。

​
レスポンス(即時検索)

名前型説明
search_querystring検索クエリ。
categoriesarrayカテゴリ情報。各オブジェクトには次のプロパティが含まれます:
  • id – カテゴリ ID (string)
  • name – カテゴリ名 (string)
  • url – カテゴリ URL (string)
  • count – カテゴリ内の商品数 (number)
filtersarrayフィルター情報。各オブジェクトには次のプロパティが含まれます:
  • filter – 次のプロパティを含むフィルターオブジェクト:
  • count – これらのパラメーターにマッチする商品の合計数 (number)
  • values – 次のプロパティを含む値オブジェクトの配列:
  • value – 値ラベル (string)
  • count – このパラメーターを持つ商品の数 (number)
htmlstring商品ブロックの HTML コード。Kameleoon の個人アカウントでテンプレートをカスタマイズします。
price_rangeobject商品価格の最小値と最大値。次のプロパティが含まれます:
  • min – 最低価格 (number)
  • max – 最高価格 (number)
productsarray商品情報。各オブジェクトには次のプロパティが含まれます:
  • description – 商品の説明 (string)
  • url – 商品の絶対 URL (string)
  • url_handle – 商品の相対 URL (string)
  • picture – Kameleoon ストレージ内の商品画像 URL (string)
  • name – 商品名 (string)
  • price – 商品価格 (integer)
  • price_full – 商品価格 (float)
  • price_formatted – 通貨付きの商品価格 (string)
  • price_full_formatted – 通貨付きフォーマット済み商品価格 (string)
  • image_url - Kameleoon ストレージ内の商品画像の絶対 URL (string)
  • image_url_handle - Kameleoon ストレージ内の商品画像の相対 URL (string)
  • image_url_resized - リサイズされた画像 URL の配列
  • currency – 商品の通貨 (string)
  • id – 商品 ID (string)
  • old_price – 商品の以前の価格 (integer、デフォルトは 0)
  • old_price_full – 商品の以前の価格 (float)
  • old_price_formatted – 通貨付きの商品の以前の価格 (string)
  • old_price_full_formatted – 通貨付きフォーマット済み商品の以前の価格 (string)
  • リクエストに extended を含めた場合の追加プロパティ:
    • id – カテゴリ ID (string)
    • name – カテゴリ名 (string)
    • parent_id – 親カテゴリ ID (string)
    • url - カテゴリ URL
    • category_ids - 商品カテゴリ ID (array)
search_query_redirectsarrayリダイレクト情報。各オブジェクトには次のプロパティが含まれます:
  • query – 検索クエリ (string)
  • redirect_link – リダイレクト用 URL (string)
  • deep_link – モバイルアプリ用 URL (string)
products_totalnumber商品の合計数。

​
レスポンス(完全検索)

名前型説明
brandsarrayブランド情報。各オブジェクトには次のプロパティが含まれます:
  • name – ブランド名 (string)
  • picture – ブランド画像 URL (string)
categoriesarrayカテゴリ情報。各オブジェクトには次のプロパティが含まれます:
  • alias – カテゴリエイリアス (string)
  • id – カテゴリ ID (string)
  • name – カテゴリ名 (string)
  • parent – 親カテゴリ ID (string)
  • url – カテゴリ URL (string)
filtersarrayフィルター情報。各オブジェクトには次のプロパティが含まれます:
  • filter – 次のプロパティを含むフィルターオブジェクト:
    • count – これらのパラメーターにマッチする商品の合計数 (number)
    • values – value (string) と count (number) を含む値オブジェクト
htmlstring商品ブロックの HTML コード。Kameleoon の個人アカウントでテンプレートをカスタマイズします。
price_rangeobject商品価格の最小値と最大値。次のプロパティが含まれます:
  • min – 最低価格 (number)
  • max – 最高価格 (number)
productsarray商品情報。各オブジェクトには次のプロパティが含まれます:
  • brand – 商品ブランド (string)
  • currency – 商品通貨 (string)
  • id – 商品 ID (string)
  • is_new – 商品プロパティ (boolean、デフォルトは null)
  • name – 商品名 (string)
  • old_price – 商品の以前の価格 (string、デフォルトは 0)
  • picture – Kameleoon ストレージ内の商品画像 URL (string)
  • price – 商品価格 (number)
  • price_formatted – 通貨付きの商品価格 (string)
  • url – 商品 URL (string)
  • リクエストに extended を含めた場合の追加プロパティ:
    • barcode – 商品のバーコード (string)
  • categories – 商品カテゴリ (array)。id、name、parent ID が含まれます。
  • params – パラメーター情報。各オブジェクトには key (string) と values (array) が含まれます。
products_totalnumber商品の合計数。
search_querystring検索クエリ。