eBay Public API一覧

eBay APIは、開発者が世界最大級のオンラインマーケットプレイスであるeBayのプラットフォームと直接連携するための強力なインターフェースです。このAPIを利用することで、自身のウェブサイトやアプリケーションにeBayの機能を組み込み、出品、在庫管理、注文処理、商品検索といった様々な操作を自動化・カスタマイズすることが可能になります。

かつてはXML形式でのやり取りが主流でしたが、現在のeBay APIは、より現代的で扱いやすいRESTful APIが中心となっており、データ形式にはJSONが標準的に採用されています。これにより、開発者は迅速かつ効率的にアプリケーションを構築できます。

Sell APIs — 販売者向けAPI群

Sell APIsは、eBayでの販売業務を包括的にサポートするAPIの集合体です。出品から注文処理、財務管理、マーケティングまで、販売者が必要とするあらゆる機能をカバーしています。

出品・在庫管理

• Inventory API — 商品情報、価格、在庫数の一括管理・同期を行います。複数のSKU（在庫管理単位）やバリエーションを持つ複雑な商品も効率的に出品・更新できます。在庫アイテムの作成、オファーの公開、在庫アイテムグループ（多バリエーション出品）の管理が主な機能です。
• Feed API — 数千〜数百万件規模の在庫データを一括処理するためのAPIです。大量の出品作成・更新・削除をファイルベースで効率的に行えるため、大規模セラーに最適です。
• Metadata API — 各マーケットプレイスのポリシー情報、出品可能なカテゴリ条件、返品ポリシー要件、商品コンプライアンス要件などのメタデータを取得します。正確な出品を行うための事前情報収集に不可欠です。
• Recommendation API — 出品内容の改善提案を提供します。タイトル、カテゴリ、Item Specifics（商品詳細）の最適化に関するeBayからの推奨事項を取得できます。

注文処理とフルフィルメント

• Fulfillment API — 支払い済みの注文情報をリアルタイムで取得し、追跡番号のアップロード、配送ステータスの更新を行います。返品・返金処理や紛争管理にも対応し、注文ライフサイクル全体をカバーします。
• Logistics API — eBayの配送サービスとの連携を提供します。配送見積もりの取得、配送ラベルの作成・管理が可能です。
• eDelivery API（International Shipping） — eBay International Shipping プログラムに対応し、国際配送のパッケージ作成、ラベル取得、追跡情報の管理、投递站点の検索などを行います。越境ECを展開するセラーにとって重要なAPIです。

財務管理

• Finances API — 販売者の財務情報を包括的に管理します。取引明細、支払い履歴、手数料の詳細、送金情報の取得が可能で、経理業務の自動化と売上分析に活用できます。

マーケティングと販売促進

• Marketing API — Promoted Listings（プロモーテッドリスティング）広告キャンペーンの作成・管理、価格割引プロモーション、クーポンの発行、広告レポートの取得を行います。販売戦略の実行と効果測定に不可欠なAPIです。
• Negotiation API — 購入希望者との価格交渉機能を提供します。オファーの送受信を自動化し、成約率の向上をサポートします。
• Analytics API（Sell） — 販売実績、トラフィックデータ、顧客行動を詳細に分析できます。販売戦略の最適化に役立つ売上レポートやトラフィックレポートを取得できます。

アカウント管理とコンプライアンス

• Account API — 支払いポリシー、返品ポリシー、配送ポリシーの一元管理を行います。また、オプトインプログラムの管理、販売者の権限情報の取得、カスタムポリシーの設定なども可能です。
• Compliance API — 出品がeBayのポリシーや規約に準拠しているかを確認し、違反がある場合はその詳細を取得します。コンプライアンスリスクの早期発見と対応に役立ちます。
• Stores API — eBayストアの設定とカスタマイズを行います。ストアカテゴリの管理、ストアプロフィールの更新などが可能です。

Buy APIs — 購入者向けAPI群

Buy APIsは、購入者の視点からeBayの商品データにアクセスするためのAPI群です。商品検索、注文処理、市場データの取得に活用できます。

• Browse API — eBay上の膨大な商品をキーワード、カテゴリ、GTIN（国際取引商品番号）、画像、商品属性など多様な条件で検索できます。商品の詳細情報、画像、価格、仕様、販売者の評価情報なども取得でき、自社サイトやアプリケーションへの商品情報の組み込みに最適です。
• Order API — eBayのチェックアウト・注文処理をアプリケーションに統合します。ゲストチェックアウトおよび会員チェックアウトの両方のフローに対応しています。
• Deal API — eBayで現在開催中のセールイベントや特価商品の情報を取得します。お得な商品を顧客に紹介するアプリケーションの構築に活用できます。
• Offer API — 購入者からの価格提案や交渉機能を提供します。
• Marketplace Insights API — 過去の販売データに基づく市場分析情報を取得します。特定の商品カテゴリにおける販売価格の推移、販売数量、人気トレンドなどを分析し、価格設定や仕入れ判断に役立てることができます。
• Buy Feed API — 大量の商品データやカテゴリ情報をフィード形式で効率的に取得します。定期的なデータ同期が必要なアプリケーションに最適です。

Commerce APIs — 共通基盤API群

Commerce APIsは、販売者・購入者の双方が利用できるeBayの共通基盤サービスを提供します。カテゴリ情報、商品カタログ、メディア管理、通知システムなど、プラットフォーム全体で共有される機能にアクセスできます。

• Taxonomy API — eBayのカテゴリツリー構造を取得し、適切なカテゴリの検索・選択を行います。カテゴリごとのItem Specifics（商品詳細属性）の取得にも対応しており、正確な出品に不可欠な情報を提供します。
• Catalog API — eBay商品カタログの検索と参照を行います。既存のカタログ商品にマッチングすることで、商品タイトル、説明文、画像などの情報を自動的に取得・補完できます。
• Notification API — eBayプラットフォームからのイベント通知（注文の作成、支払い完了、商品の落札など）をWebhook形式で受信するための設定を管理します。リアルタイムなイベント駆動型アプリケーションの構築に不可欠です。
• Media API — 商品画像や動画などのメディアファイルのアップロードと管理を行います。出品に使用するメディアコンテンツの一元管理が可能です。
• Translation API — 出品タイトルや説明文の翻訳サービスを提供し、多言語対応の出品作成を支援します。越境ECにおける言語の壁を低減します。
• Charity API — eBayのチャリティ団体情報を検索・取得します。チャリティ出品を行う際に利用します。
• Identity API — eBayユーザーの基本的な識別情報を取得します。
• Feedback API — 取引に関する評価（フィードバック）の取得と管理を行います。
• VeRO API — VeRO（Verified Rights Owner）プログラムを通じた知的財産権の保護機能を提供します。権利侵害の報告と管理が可能です。

Developer APIs — 開発者向けAPI群

Developer APIsは、API利用状況のモニタリングやセキュリティ関連の機能を提供する、開発者自身のためのAPIです。

• Analytics API（Developer） — APIコールのレート制限情報やAPI使用量の統計データを取得します。アプリケーションのパフォーマンス監視やレート制限の管理に活用できます。
• Key Management API — デジタル署名に使用する暗号鍵の作成と管理を行います。APIリクエストのセキュリティ強化に必要です。
• Client Registration API — OAuth 2.0クライアントの登録と管理を行います。

Trading API — 伝統的かつ強力なレガシーAPI

最新のRESTful API群と並行して、eBayには「Trading API」と呼ばれる非常に強力で歴史のあるAPIが存在します。

• 形式：RESTful APIとは異なり、SOAP（Simple Object Access Protocol）ベースで、データ形式にはXMLを使用します。
• 機能：eBayのほぼ全てのコア機能にアクセスできる、最も包括的で高機能なAPIです。出品（AddItem / AddFixedPriceItem）、注文管理（GetOrders / CompleteSale）、ユーザー間のメッセージ交換、評価（フィードバック）の送受信、カテゴリ情報の取得など、非常に細かいレベルでの操作が可能です。
• 用途：長年にわたり多くの大規模セラーやサードパーティツールで利用されてきた実績があります。RESTful APIではまだ提供されていない特定の機能や、複雑な業務フローを自動化する必要がある場合に今でも不可欠な選択肢となります。

Post-Order API — 取引後の管理

Post-Order APIは、取引完了後に発生する各種プロセスを管理するためのAPIです。

• 返品管理：返品リクエストの作成、承認、エスカレーション、返金処理を行います。
• キャンセル管理：注文のキャンセルリクエストの処理と管理を行います。
• ケース管理：購入者と販売者間の紛争（ケース）の作成、対応、解決を支援します。
• お問い合わせ管理：取引に関するお問い合わせの処理を行います。

どちらのAPIを使うべきか？

• 新規開発の場合：まずはRESTful API（Sell APIs / Buy APIs / Commerce APIs）の利用を推奨します。JSON形式で扱いやすく、学習コストが低いため、現代的な開発環境との親和性が高いです。
• 特定の高度な機能が必要な場合：RESTful APIで目的の機能が見つからない場合は、Trading APIのドキュメントを確認してください。両者を組み合わせて利用することも可能です。
  ※注意：出品に関するAPIについては、Trading API（AddItem系）とInventory APIで出品モデルが異なります。一つの出品に対して、どちらか一方のAPIを選択してご利用ください。混在させると予期せぬ動作が発生する可能性があります。

eBay APIの利用を開始する方法

開発を始めるための手順はシンプルです。

1. 開発者プログラムへの登録： eBay Developer Programの公式サイトにアクセスし、無料で開発者アカウントを登録します。
2. アプリケーションキーの取得：ログイン後、あなたのプロジェクト用のアプリケーションを作成します。これにより、APIアクセスに必要となる認証キー（App ID、Cert ID、Dev ID）が発行されます。
3. OAuth認証の設定：RESTful APIを利用する場合は、OAuth 2.0トークンの取得が必要です。Application Access Token（アプリケーショントークン）またはUser Access Token（ユーザートークン）を取得して、APIリクエストに使用します。
4. サンドボックス環境の活用：eBayは、実際の取引に影響を与えないテスト専用のSandbox（サンドボックス）環境を提供しています。ここでAPIリクエストのテストやアプリケーションの動作検証を安全に行うことができます。
5. 公式ドキュメントの参照： 公式開発者サイトには、各APIの詳細なリファレンス、開発者ガイド、SDK（ソフトウェア開発キット）、コードサンプルが豊富に用意されています。

eBay API 一覧

以下の表は、利用可能なeBay APIの全体像を示しています。

eBay APIは、単なるツール連携に留まらず、ビジネスの自動化、効率化、そして新たな価値創造を実現するための強力なパートナーです。さあ、あなたもeBay開発者コミュニティに参加して、Eコマースの未来を創造しましょう!