購入フィード API（Buy Feed API）

Feed API は、eBay の商品と特定のカテゴリ、日付、マーケットプレイスの 1 時間ごとのスナップショット ファイルを含む TSV_GZIP フィード ファイルをダウンロードする機能を提供します。

API に加えて、.NET で書かれたオープンソースの Feed V1 SDK があり、ダウンロードしてファイルを結合し、フィードファイル全体を解凍できます。フィールドフィルターを指定してファイル内のアイテムをキュレートすることも可能です。

バージョン: v1.2.0

ベースURL: https://api.ebay.com/buy/feed/v1

認証（OAuth スコープ）

この API は クライアント資格情報（Client Credentials） フローを使用します。

リソース一覧

Buy Feed API は以下の 3 リソース、合計 6 エンドポイント（すべて GET）で構成されています。

access — アクセスルール（1 エンドポイント）

GET /access

getAccess — アプリケーションに固有のアクセスルール（権限を持つフィードタイプなど）を取得します。アプリケーションは、特定のマーケットプレイスや、そのマーケットプレイス内の特定の L1 カテゴリに制限される場合があります。この情報を使用して、getFiles メソッドにフィルターを適用できます。

レスポンス: 200 / 204 / 500

feed_type — フィードタイプ（2 エンドポイント）

GET /feed_type

getFeedTypes — ダウンロード可能な 1 つ以上のフィードタイプに関する詳細を取得します。クエリパラメータが未使用の場合は、すべての可能なフィードタイプが返されます。

レスポンス: 200 / 400 / 500

GET /feed_type/{feed_type_id}

getFeedType — 特定のフィードタイプの詳細を取得し、ニーズへの適用性を判断します。レスポンスを使用して、eBay マーケットプレイスとカテゴリをアプリケーションのアクセス権限と比較できます。

レスポンス: 200 / 400 / 403 / 404 / 500

file — フィードファイル（3 エンドポイント）

GET /file

getFiles — ダウンロード可能なフィードファイルのリストを提供します。各フィードの詳細には、生成日、取得頻度、フィードの種類、fileId、形式（現在は TSV のみ）、適用される eBay マーケットプレイス、スキーマバージョン、バイト単位のサイズ、対象期間が含まれます。

レスポンス: 200 / 400 / 403 / 500

GET /file/{file_id}

getFile — ファイルの file_id で指定されたダウンロード可能なフィードファイルの詳細を取得します。

レスポンス: 200 / 400 / 403 / 404 / 500

GET /file/{file_id}/download

downloadFile — 選択した TSV_gzip フィードファイルをダウンロードします。

注: ダウンロードされたファイルは自動的に gzip 圧縮されるため、Accept-Encoding:gzip ヘッダーを指定する必要はありません。指定するとファイルが 2 回圧縮されます。

重要: ファイルが 200 MB を超える場合は、ダウンロードをチャンクでストリーミングする必要があります。Range リクエストヘッダーを使用してチャンクサイズをバイト単位で指定してください。

レスポンス: 200 / 206 / 400 / 403 / 404 / 416 / 500

スキーマ定義（全 16 スキーマ）

ApplicationAccess

Access

FeedType

FeedTypeSearchResponse

FileMetadata

FileMetadataSearchResponse

TimeDuration

Dimension / Constraint / SupportedFeed / SupportedSchema / FeedTypeConstraint / ListingMarketplaceFeedTypeConstraint / OutputStream

その他の補助スキーマ（フィードタイプの制約、サポートされるフィード/スキーマの定義など）。詳細は OpenAPI 仕様を参照してください。

Error / ErrorParameter

標準エラースキーマ（他の API と同一構造）。

エンドポイント一覧（全 6 エンドポイント）