よくある質問

TCG Price Lookupは、トレーディングカードゲームのリアルタイム価格データを提供するREST APIです。TCGPlayerとeBayから価格を集約し、開発者に現在対応しているゲームの単一の正規化されたマーケットビューを提供します。

現在8つのTCGに対応: Pokemon、Pokemon Japan、Magic: The Gathering、Yu-Gi-Oh!、One Piece Card Game、Disney Lorcana、Star Wars: Unlimited、Flesh and Blood。

TCGPlayerとeBayから24時間365日価格データを収集する独自のスクレイパーを使用しています。スクレイパーはリクエストを制限し、プロキシローテーションを使用し、ソースプラットフォームに害を与えない方法で運用するよう設計されています。データはその後正規化、検証され、APIを通じて提供されます。

TCGPlayer価格は、TCGPlayerマーケットプレイスで販売者が現在要求している価格を反映 — 各コンディションの市場価格、最低価格、中間価格、最高価格。eBay価格は実際に完了した販売に基づく集計平均（日次、週次、月次） — 購入者が実際に支払った金額。合わせると、小売市場価格と実際の取引価格の完全な全体像が得られます。

各プランには日次リクエスト制限と秒間レート制限があります。Free: 1日200リクエスト、3秒に1リクエスト。Trader: 1日10,000リクエスト、1秒に1リクエスト。Business: 1日100,000リクエスト、1秒に3リクエスト。日次制限はUTC午前0時にリセット。いずれかの制限を超えると429レスポンスが返されます。

生カードの場合、5つのコンディションの価格を提供: Near Mint、Lightly Played、Moderately Played、Heavily Played、Damaged。各コンディションにはTCGPlayer（市場/最低/中間/最高）とeBay（1日、7日、30日平均）が含まれます。グレードカードの場合、PSA（グレード1-10）、BGS（グレード1-10および9.5）、CGC（グレード1-10）をeBay集計平均でカバーしています。

Freeプランは個人的な非商用利用のみです。TraderプランとBusinessプランには商用利用権が含まれているため、当社のデータを組み込んだ製品、アプリ、サービスを構築できます。特定のライセンスに関する質問がある場合はお問い合わせください。

スクレイパーは24時間365日継続的に稼働しています。TCGPlayer価格は通常数時間ごとに更新されます。eBay集計価格（日次、週次、月次平均）は新しい販売データが入ると再計算されます。ほとんどのカードについて、データは数時間以内のものです。

JavaScript/TypeScript、Python、Go向けの公式SDKを開発中です。それまでの間、APIは任意のHTTPクライアントで動作する標準的なREST APIです。ドキュメントにはcURL、JavaScript、Pythonのサンプルが含まれています。

TraderプランとBusinessプランには過去の価格データへのアクセスが含まれています。任意のカードの価格履歴をさまざまな期間（7日、30日、90日、1年）で照会できます。このデータにはコンディション別のTCGPlayerとeBayの両方の価格ポイントが含まれ、トレンド分析と市場追跡が可能です。