開発者向けの変更です。
ベータの Catalog API で、Shopify で販売していないブランドの商品も検索結果に入れられるようになりました。
search_catalog に sources パラメータが加わりました
掲載は2026年10月27日、Shopify の developer changelog。
フラグは「Update」で、対象の面は Catalog です。
出典: Shopify developer changelog「Search brands that don’t sell on Shopify in the Catalog API (beta)」2026年10月27日
https://shopify.dev/changelog/posts/search-brands-that-don-t-sell-on-shopify-in-the-catalog-api-beta
You can now return products from brands that don’t sell on Shopify when you search the beta Catalog API. Add the new sources parameter to search_catalog to include external products in the same response as products from Shopify merchants. If you omit sources, results stay limited to Shopify merchant products and you don’t need to change any existing calls.
(ベータの Catalog API の検索で、Shopify で販売していないブランドの商品も返せるようになりました。search_catalog に新しい sources パラメータを足すと、Shopify の店の商品と同じ応答に外部の商品が入ります。sources を省けば結果は Shopify の店の商品だけのままで、既存の呼び出しを変える必要はありません)
新しいエンドポイントは無く、今の search_catalog に足すだけ。
返す商品の範囲は3通りです
sources の値で、返す範囲が決まります。
- Shopify の店の商品だけ = 省く、または
["shopify"] - Shopify の店の商品と外部の商品 =
["shopify", "external"] - Shopify で販売していないブランドだけ =
["external"]
ID を渡せば、get_product でも外部の商品が返ります。
lookup_catalog への対応は、後日。
The get_product method returns an external product when you pass its ID, and lookup_catalog support is coming later.
(get_product は、ID を渡せば外部の商品を返します。lookup_catalog への対応は今後です)
外部の商品は、Shopify のチェックアウトでは買えません
External products always return eligible.native_checkout: false, so shoppers can’t buy them through Shopify checkout and these products don’t earn Promoted Placements commission. Each external product includes a description, an image, a price, and a link to the brand’s product page so the shopper completes the purchase on the brand’s own site.
(外部の商品は常に eligible.native_checkout: false を返します。購入者は Shopify のチェックアウトで買えず、これらの商品は Promoted Placements の手数料(commission)の対象になりません。外部の商品には説明・画像・価格と、ブランドの商品ページへのリンクが入り、購入者はブランドのサイトで購入を終えます)
購入の場は、ブランド自身のサイト。
外部の商品に入る情報は次の4つです。
- 説明
- 画像
- 価格
- ブランドの商品ページへのリンク
ベータ中、外部の商品が返るのは米国の購入者だけです
During the beta, external product data comes from each brand’s website, and external products only return when the shopper is in the United States. Searches for shoppers in other countries continue to return Shopify merchant products only.
(ベータの間、外部の商品のデータは各ブランドのサイトから取ります。外部の商品が返るのは、購入者が米国にいるときだけです。ほかの国の購入者の検索では、これまでどおり Shopify の店の商品だけが返ります)
データの取り元は、各ブランドのサイト。
米国以外の購入者には、今までと同じ結果が返ります。
今の呼び出しは、変えなくても動きます
No action is required if you only want to keep returning products from Shopify merchants. Your existing search_catalog calls work without changes.
(Shopify の店の商品だけを返し続けるなら、対応は要りません。既存の search_catalog の呼び出しは変更なしで動きます)
対象は、Catalog API でサイト内の検索やおすすめを動かしているアプリ。
そのうち、Shopify で販売していないブランドの商品も入れたいアプリです。
外部の商品を入れたいときだけ、sources を足します。
🔴 公式に書かれていないこと
次の点は、一次ソースにありません。
- Shopify の店の商品と外部の商品が、結果の中でどの順に並ぶかは書かれていません
- 外部の商品として載るブランドを、どう選んでいるかは書かれていません
- 米国以外への広がりや、正式な提供の時期は書かれていません
- Shopify の店の側で、外部の商品と並ぶことを止められるかは書かれていません
- 本文のリンク先の Catalog API の資料は、本記事では読んでいません
- 🔴 本記事は Catalog API を呼んで確かめていません。記載が無いことをもって「できる」とも「できない」とも書きません
開発者と店がやること
- 外部の商品を入れたい開発者は、
search_catalogのsourcesに["shopify", "external"]か["external"]を渡す - 商品ページへのリンクを出しているなら、外部の商品の URL でブランドのサイトに移れるようにする
- 外部の商品は Shopify のチェックアウトで買えず、Promoted Placements の手数料(commission)の対象にならないことを踏まえる
- 店は、Catalog API の検索結果に Shopify 外のブランドの商品も並び得ることを知っておく。条件は、購入者が米国にいて、アプリが
sourcesにexternalを入れた場合
🔵 上の手順はキクシル編集部の整理で、公式の記載ではありません。1〜2 は一次ソースの「What to do」、3 は「What changed」、4 は「What changed」と「Who’s affected」の記載を店向けに整理したものです。
出典
- Shopify developer changelog「Search brands that don’t sell on Shopify in the Catalog API (beta)」2026年10月27日
https://shopify.dev/changelog/posts/search-brands-that-don-t-sell-on-shopify-in-the-catalog-api-beta
上記の Shopify 公式の情報だけを一次情報として使っています。
次の事項は「未確認」として扱い、推測で補っていません。
- 結果の中での並び順
- 外部のブランドの選び方
- 米国以外への広がりと正式な提供の時期
- 店の側で並びを止められるか

