Shopify の検索結果を、御社のデザインでストアのどこにでも。

検索窓に入力する人は、買いたいものがほぼ決まっている人です。見つかれば買い、見つからなければ別の店へ離脱してしまいます。第三者の調査でも、その差ははっきり出ています。

44%

検索を使った訪問者は全体の24%でしたが、サイト全体の売上の44%を占めていました。購入率は、検索しない人の2.5倍です。

出典：Constructor「Beyond Relevance」（113の小売サイト・検索6億900万回、2024年10〜12月）

92%

検索で目的の商品が見つかると、92%がその商品を購入すると答えました（米国の消費者）。

出典：Google Cloud × The Harris Poll（14か国・約13,500人の調査のうち米国の回答、2022年11〜12月）

63%

サイト内検索を使う人の63%が、ブランドの公式ECサイトで検索が使いにくく、購入をあきらめたことがあると答えました（「よくある」9.2%と「たまにある」53.7%の合計）。

出典：サイナブル調べ（20〜50代のEC利用者1,030人、2025年12月）

いずれも第三者による調査で、まるっと検索を導入したときの効果を示すものではありません。導入後の効果は、管理画面の「検索経由売上」で確かめられます。

検索APIは、まるっと検索のエンジンがJSONで検索結果を返します。これにより検索結果ページ専用ではなく、ヘッダー、商品ページ、カート、ブログ記事など、ストアフロントのどのページからでも呼ぶことができ、デザインのカスタマイズも自由です。

Shopify にも、オンラインストアの検索と、検索に使える API があります。違いが出るのは、日本語の照合と、呼び出せる場所です。標準のほうが向いている場面もあるので、あわせて書きます。

日本語の商品名で探されることが多いストアなら検索API、Hydrogen やアプリなどストアの外から検索を呼びたいなら Storefront API が向いています。

• 出典：Shopify ヘルプセンター「オンラインストア検索の動作」
• 出典：まるっと検索 無料診断による実測（2026年9月、Pepin 調べ）
• 出典：Shopify.dev「Predictive Search API」
• 出典：Shopify.dev「Storefront API: search」

検索API は、検索結果ページ専用ではありません。ストアフロントのページなら、どこからでも呼べます。効きやすい置き場所を6つ、動く見本にしました。

見本の店と商品は架空です。検索語の結果は、まるっと検索の実際のエンジンで確かめたものです。

01検索結果02ヘッダー03コレクション04商品ページ05カート06記事・特集

検索結果ページを、テーマと同じ見た目に

アプリの画面ではなく、テーマの部品で検索結果を組めます。カラー、素材、価格帯、セール中の件数まで集計済みで届くので、絞り込みもそのまま作れます。0件で終わった検索には、ほかのお客様が続けて検索した語も届きます。

効くところ検索からの購入率

試してみるワンピースわんぴーす（ひらがな）レインコート（0件になる語）

カラーや素材を押すと、絞り込んだ結果と件数に替わります。

atelier-noa.jp/search?q=ワンピース

ATELIER NOA

ワンピース

「ワンピース」の検索結果8件

並び替えおすすめ順価格の安い順価格の高い順新着順

すべて8商品6読みもの1ページ1

読みものワンピースの着回しコーデ 12選スタッフ 田中

SALEリネンブレンド ロングワンピース

¥12,800¥16,000税込

コットン シャツワンピース

¥14,300税込

ティアード ロングワンピース

¥16,500税込

SALEキャミソールワンピース

¥9,900¥13,200税込

SOLD OUTウール ニットワンピース

¥19,800税込

もっと見る（6 / 8件）

開発者向け：リクエストと JSON を見る

次の置き場所：ヘッダー

見えます。検索したときと結果を押したときの2つのイベントを送れば、カートへの追加と購入はまるっと検索が紐付け、管理画面の「検索経由売上」に出ます。効果を確かめながら、置き場所を増やしていけます。

1. 01

   検索したとき

   検索リクエストと同じ session_id と、応答の query_id・measurement_proof を渡します。

2. 02

   結果を押したとき

   押された商品の product_id と、それが何番目の結果か（0 始まり）を渡します。

3. 03

   カートに入れた・買ったとき

   送る必要はありません。まるっと検索の Web Pixel が measurement_proof を付け直し、どの検索が売上につながったかを紐付けます。

4. 04

   管理画面で見る

   検索経由売上、クリック率、クリックされた商品のランキングに反映されます。

この2つを送らないと、検索は動いても検索経由売上は計上されません。検索リクエストに session_id を付け忘れた場合も、分析には数えられません。

1. 1

   設定場所を決める

   活用パターンを見ながら、まず1か所を選びます。迷ったら弊社にご相談ください。

2. 2

   仕様書を確認

   仕様書と参照実装（search-api-sample.js）は、インストールしなくてもお読みいただけます。

3. 3

   Pro プランで同期する

   インストールして Pro プランの無料体験を始めると、商品の索引づくりが始まります。degraded: true が返らなくなったら準備完了です。

4. 4

   描画を書き、イベントを送る

   参照実装の描画を御社のデザインに置き換え、marutto_search と marutto_result_clicked を送ります。

5. 5

   検索経由売上を見る

   管理画面で検索からの売上を確かめながら、置き場所を増やしていきます。

無料体験は14日間です。置き場所と見た目を先に決めておくと、期間のうちに効果まで確かめやすくなります。

仕様書から、つまずきやすいところだけを抜き出しました。細かい定義は仕様書をご覧ください。

仕様の要点

呼び出し先

/apps/marutto-search/search（ストア自身のドメイン上。Shopify のアプリプロキシ）

認証

不要です。ショップは Shopify の署名で特定され、API キーも CORS の設定も要りません

必須のパラメータ

type=search、contract=v1、q（検索語。全件は *）、session_id

返る形

JSON。商品・記事・ページの結果、絞り込みの集計、total・offset・limit

件数

1回に最大50件。開始位置（offset）は2,000まで

回数の上限

10秒あたり、ショップごとに50回・訪問者ごとに20回（type=search）

応答の速さ

検索処理の p95 は100〜250ms（2026年8月の本番実測。稼働は東京リージョン）

仕様の維持

v1 は少なくとも12か月維持し、廃止するときは6か月前にお知らせします

呼べない場所

チェックアウト、サンキューページ、注文状況ページ、ストアの外（Hydrogen・ネイティブアプリ）

使えるプラン

Pro（月額 $49.99・14日間無料体験）。Free・Basic では使えません

// 検索したとき
Shopify.analytics.publish("marutto_search", {
  query: data.query,
  query_id: data.query_id,
  session_id: sessionId, // 検索リクエストに付けたものと同じ値
  measurement_proof: data.measurement_proof,
  result_count: data.total,
});

// 検索結果を押したとき
Shopify.analytics.publish("marutto_result_clicked", {
  query_id: data.query_id,
  session_id: sessionId,
  measurement_proof: data.measurement_proof,
  product_id: item.product_id,
  position: index, // 0 始まり
});

導入初日と、プランが Pro でないとき

新しいストアは、索引ができるまで degraded: true を返します。Pro 以外のプランでは 403 と code: plan_required が返ります。どちらも検索が壊れたわけではないので、買い物客にエラーを見せない作りにします。

通常導入初日（degraded）Pro 以外（403）

atelier-noa.jp/search?q=ワンピース

ATELIER NOA

ワンピース

SALEリネンブレンド ロングワンピース

¥12,800¥16,000税込

コットン シャツワンピース

¥14,300税込

ティアード ロングワンピース

¥16,500税込

索引ができていれば、仕様どおりの形で結果が返ります。

開発者向け：リクエストと JSON を見る