出品情報取得

Trading API — 商品情報取得(Item & Seller Retrieval)

商品情報取得カテゴリには、eBay 上のアイテム詳細やセラーのリスティング一覧、マイ eBay の購入・販売状況を取得する 6 つのコールが含まれます。出品管理ツールやデータ分析に不可欠な情報を提供します。

RESTful 代替: アイテム情報の取得には Browse API(Buy)も利用可能です。ただし、セラー専用の詳細情報(未公開フィールド等)は Trading API でのみ取得できます。

よくある利用シナリオ

  • 在庫管理: GetSellerList で全アクティブリスティングを取得 → 自社在庫 DB と突合
  • リスティング変更検知: GetSellerEvents を定期ポーリングして、価格変更・終了・再出品などのイベントを検知
  • アイテム詳細表示: GetItem で商品の全情報(説明、画像、配送、バリエーション等)を取得し、独自 UI に表示
  • 配送費計算: GetItemShipping で特定の配送先への送料見積もりを取得
  • ダッシュボード: GetMyeBaySelling で販売中・売却済み・未販売のアイテムを一括取得し、セラーダッシュボードを構築

アイテム詳細(2 コール)

GetItem

Trading API で最も多用されるコールの一つ。単一アイテムの完全な詳細情報を取得します。タイトル、説明、価格、カテゴリ、配送オプション、商品状態、画像 URL、バリエーション、セラー情報、入札履歴など、リスティングに関するほぼすべての情報が含まれます。DetailLevelIncludeItemSpecifics などのパラメータで返却データ量を制御可能。

原文リファレンスを読む →

GetItemShipping

指定した配送先(国、郵便番号)に対するアイテムの配送費見積もりを取得します。セラーが設定した配送サービスごとの費用と配送日数が返されます。

原文リファレンスを読む →

セラーリスト(2 コール)

GetSellerList

セラーの出品リスティング一覧を取得します。終了日時の範囲指定で、アクティブ・終了済み・スケジュール済みのリスティングをフィルタリング可能。ページネーション対応。大量出品セラーの在庫管理や出品状況の把握に不可欠。

原文リファレンスを読む →

GetSellerEvents

指定した時間範囲内にセラーのリスティングで発生したイベント(価格変更、数量変更、終了、再出品など)を取得します。差分同期に最適で、GetSellerList のフルスキャンよりもはるかに効率的。定期的なポーリングで変更のみを検出するパターンに使用。

原文リファレンスを読む →

マイ eBay 情報(2 コール)

GetMyeBayBuying

認証ユーザーの「マイ eBay — 購入」情報を取得します。入札中のアイテム、ウォッチリスト、落札済みアイテム、購入済みアイテムなど、バイヤーとしてのアクティビティを一括取得。バイヤー向けアプリケーションに有用。

原文リファレンスを読む →

GetMyeBaySelling

認証ユーザーの「マイ eBay — 販売」情報を取得します。出品中のアイテム、売却済みアイテム、未販売アイテム、スケジュール済みアイテムなど、セラーとしてのアクティビティを一括取得。セラーダッシュボード構築の基本データソース。

原文リファレンスを読む →

トップに戻る