eBay Finding API廃止後の代替手段｜Browse APIに移行できないツールの見分け方
2025年2月5日、eBayは「Finding API」を正式に廃止した。
公式アナウンスはあったが、日本語の詳細情報は少なかった。「うちのツールは今も動いている」と思っているセラーほど、実は壊れた状態で使い続けているケースがある。
この記事では、Finding API廃止が何を変えたのか、自分のツールが影響を受けているかどうかの見分け方、そして現時点での現実的な代替手段を整理する。
Finding APIとは何だったか
Finding APIとは、セラーIDや検索キーワードを指定してeBayの出品・落札データを取得できるAPIだ。
開発者向けの機能だが、実質的にはeBayのリサーチツールの根幹を担ってきた。
具体的には以下の3つが主な用途だった。
| メソッド | 何ができたか |
|---|---|
| `findItemsAdvanced` | セラーIDを指定して出品中商品を全件取得 |
| `findItemsIneBayStores` | ストア名で全在庫を取得 |
| `findCompletedItems` | セラーの落札済み商品を取得 |
「競合セラーが何を売っているか」「どの商品が売れているか」を自動で追跡するには、これらのメソッドが必要だった。多くのリサーチツールがここに依存していた。
何が廃止されて、何が残ったか
2025年2月5日をもって、上記3つのメソッドを含むFinding API全体が廃止された。Shopping APIも同時に終了している。
代替として提供されているのが「Browse API」だ。
| 項目 | Finding API | Browse API |
|---|---|---|
| セラーIDだけで全出品を取得 | ✅ できた | ❌ できない |
| キーワード検索 | ✅ | ✅ |
| 認証方式 | App ID | OAuth Bearer Token |
| データ形式 | XML | JSON |
| 廃止 | 2025年2月5日 | 現行 |
最も重要な変化は「セラーIDだけでは検索できない」という制約だ。
Browse APIでは、キーワード・カテゴリID・GTINのいずれかが必須パラメータとなっている。セラーIDを絞り込み条件に使うことはできるが、それ単体では機能しない。
Browse APIに移行できないツールが存在する理由
「Browse APIに移行すればいい」と思うかもしれないが、実際にはそう簡単ではない。
Finding APIで「セラーIDだけ渡せば全商品が返ってきた」のに対し、Browse APIでは同等のことをするにはカテゴリごとに繰り返しAPIを叩く必要がある。
たとえば、あるセラーの全出品を取得するには：
- eBay全カテゴリ（数十〜数百）をリストアップ
- カテゴリごとに「このカテゴリ × このセラー」で検索を繰り返す
- 結果を統合する
この設計は複雑で処理コストも高い。安価なリサーチツールや古いツールほど、この移行ができていないまま放置されているケースがある。
また、落札済み商品（Sold）の取得はさらに厳しい。
Browse APIには落札データを取得するエンドポイントが一般公開されておらず、Marketplace Insights APIという代替があるがeBay側の審査・承認が必要で、個人開発者やニッチなツールはほぼ却下される状況だ。
あなたのツールが「壊れている」サインを確認する
自分が使っているリサーチツールが影響を受けているかどうかを確認するには、以下を試してほしい。
① 競合セラーの出品数が急に減った（または変化しなくなった）
Finding API廃止後、セラーIDによる検索が機能しなくなったツールは出品数を正常に取得できていない場合がある。
② 落札データが2025年2月以降から更新されていない
findCompletedItemsが廃止されたため、落札データの取得が止まっているケースがある。
③ ツールのサポートページやアップデートログが2025年以降更新されていない
開発が止まっているツールは廃止対応がされていない可能性が高い。
④ エラーが出ずに「0件」と表示される
APIが正しくエラーを返さずに空の結果を返すことがある。正常に見えて実は何も取れていないケースだ。
現時点での現実的な代替手段
Finding APIの廃止後、現実的に使われている代替手段は主に3つだ。
① Browse APIのカテゴリループ
複数カテゴリをループして近似的にセラーの全出品を取得する。完全ではないが実用レベルには使える。処理が遅いのが難点。
② eBayの公開ページをスクレイピング
APIを使わずにeBayの検索結果ページを直接取得する方法。ScraperAPIなどのサービスを使うことが多い。落札済み商品の取得にはこちらが現実的な選択肢になっている。
③ Terapeak（eBay Seller Hub内）
eBay公式の市場分析ツール。Seller Hubにアクセスできる出品者なら無料で使える。APIとは別の話だが、リサーチ目的であれば手動で確認する方法として有効。
まとめ
- eBay Finding APIは2025年2月5日に廃止済み
- Browse APIへの完全移行は技術的に困難で、多くのツールが対応不完全のまま
- 「ツールが動いている」ように見えても落札データや全出品取得が機能していないケースがある
- 現実的な代替はBrowse APIカテゴリループ＋スクレイピングの組み合わせ
- 使っているツールのアップデート状況を確認することが先決
eBayのAPIは今後も変わり続ける。特定のAPIに依存したツールは、ある日突然機能しなくなるリスクを常に持っている。複数の手段を組み合わせた設計が、長く使えるリサーチ環境の条件になってきている。
