CATALOG API / BETA
Catalog APIベータ：Shopify外ブランドの商品検索が解禁
sourcesパラメータ1つで、外部ブランド商品を既存の検索フローに組み込める
このアップデートはCatalog APIベータ版を利用するアプリ開発者が対象です。2026年10月27日より、search_catalogにsourcesパラメータが追加され、Shopifyに出店していない外部ブランドの商品を同一レスポンスに含められるようになりました。既存の呼び出しはパラメータ省略のままで動作し続けるため、変更は任意です。
1Before / After：sourcesパラメータの対応範囲
2外部商品のデータ構造と制約
| フィールド | 内容 | 備考 |
|---|---|---|
| description | 商品説明文 | ブランドWebサイトから取得 |
| image | 商品画像 | 同上 |
| price | 価格 | 同上 |
| URL | ブランド自社サイトのPDP URL | 購入はブランドサイトで完結 |
| eligible.native_checkout | 常にfalse | Shopifyチェックアウト不可 |
| Promoted Placements手数料 | 対象外 | 外部商品はコミッション発生なし |
| 提供地域（ベータ） | 米国のみ | 他国ではShopify商品のみ返却 |
| lookup_catalog対応 | 未対応（予定） | 記載なし＝現時点は未対応 |
3業務に活かせる具体ユースケース
- 課題
- 自社ストアにない商品カテゴリを探しているユーザーが離脱してしまい、サイト内検索のカバレッジが不足している
- 打ち手
- sourcesを["shopify","external"]に設定し、関連する外部ブランド商品を自社商品と並べてサジェスト表示する
- 効果
- ユーザーの「見つからない」体験を減らし、外部ブランドへの送客を通じたパートナーシップ強化にも活用できる
- 技術メモ
- external商品のURLはブランド自社サイトへのリンクのため、フロントエンドで
eligible.native_checkoutを判定してカートボタンと外部リンクを出し分ける実装が必要
- 課題
- コンテンツメディア型のShopifyストアで、記事内に関連商品をレコメンドしたいが、提携ブランドがShopifyに出店していないケースが多い
- 打ち手
- sources:["external"]を使って外部ブランド商品のみを取得し、アフィリエイト感覚でコンテンツ内にインライン商品カードを差し込む
- 効果
- Shopify非出店ブランドとの協業が可能になり、コンテンツ収益化の選択肢が広がる
- 技術メモ
- ベータ期間中は米国ユーザーにのみ外部商品が返るため、ロケーション判定ロジックを組み合わせてUI出し分けを行うこと
- 課題
- マルチブランド型のレコメンドアプリで、Shopify加盟店の商品だけでは品揃えのロングテールをカバーしきれない
- 打ち手
- 既存のsearch_catalog呼び出しにsourcesパラメータを追加するだけで外部商品をレスポンスに含め、アプリのカタログ幅を拡張する
- 効果
- エンドポイントの新設なしに機能拡張できるため、実装コストを最小化しつつカタログの多様性を高められる
- 技術メモ
- get_productも外部商品IDを受け付けるようになったため、商品詳細取得フローに大きな変更は不要。lookup_catalogの外部商品対応は現時点では記載なし
4技術者向け実装ポイント
sourcesを省略またはshopifyのみ指定すれば既存の挙動を維持。既存アプリの改修は不要です。
外部商品は現時点で米国のショッパーのみ返却されます。他国からのリクエストはShopify商品のみ返るため、地域判定ロジックの考慮が必要です。
外部商品は常にeligible.native_checkout: false。購入フローをShopifyカートに乗せることは不可です。ブランド自社サイトURLへ誘導する実装が必須です。
外部商品はPromoted Placementsのコミッション対象外です。収益モデルの設計時に注意してください。
外部商品のIDをget_productに渡すと外部商品データを返します。lookup_catalogの外部商品対応は現時点で記載なしです。
ベータ期間中、外部商品データは各ブランドのWebサイトから取得されます。データの鮮度・精度については公式ドキュメントを確認してください。
Catalog APIのsourcesパラメータを1行追加するだけで、Shopify非出店ブランドの商品もサイト内検索・レコメンドに組み込め、カタログの幅をShopifyエコシステム外にまで広げられます。
Source: https://shopify.dev/changelog/search-brands-that-don-t-sell-on-shopify-in-the-catalog-api-beta | 公開日: 2026年10月27日
Share:
Dev DashboardでPayouts・Billing管理へ移行
TOMLでメタオブジェクトのAnalytics連携を設定