出品情報取得
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、バリエーション、セラー情報、入札履歴など、リスティングに関するほぼすべての情報が含まれます。DetailLevel や IncludeItemSpecifics などのパラメータで返却データ量を制御可能。
GetItemShipping
指定した配送先(国、郵便番号)に対するアイテムの配送費見積もりを取得します。セラーが設定した配送サービスごとの費用と配送日数が返されます。
セラーリスト(2 コール)
GetSellerList
セラーの出品リスティング一覧を取得します。終了日時の範囲指定で、アクティブ・終了済み・スケジュール済みのリスティングをフィルタリング可能。ページネーション対応。大量出品セラーの在庫管理や出品状況の把握に不可欠。
GetSellerEvents
指定した時間範囲内にセラーのリスティングで発生したイベント(価格変更、数量変更、終了、再出品など)を取得します。差分同期に最適で、GetSellerList のフルスキャンよりもはるかに効率的。定期的なポーリングで変更のみを検出するパターンに使用。
マイ eBay 情報(2 コール)
GetMyeBayBuying
認証ユーザーの「マイ eBay — 購入」情報を取得します。入札中のアイテム、ウォッチリスト、落札済みアイテム、購入済みアイテムなど、バイヤーとしてのアクティビティを一括取得。バイヤー向けアプリケーションに有用。
GetMyeBaySelling
認証ユーザーの「マイ eBay — 販売」情報を取得します。出品中のアイテム、売却済みアイテム、未販売アイテム、スケジュール済みアイテムなど、セラーとしてのアクティビティを一括取得。セラーダッシュボード構築の基本データソース。