API申請・接続準備

01 / DEVELOPER ACCOUNT

開発者アカウントを用意する

eBay Developers Programに登録し、メール認証とアカウントの有効化を済ませます。通常のeBay出品者アカウントとは別の登録です。登録済みの場合はApplication Keysへ進めます。

開発者登録を開く Application Keysを開く申請用の英文をダウンロード

Application Keysに入力するアプリ名

サブタイトル：Aim for eBay

SandboxキーをAimへ接続する

Application Keysでアプリ名「Aim」を入力し、Sandbox → Create a keysetを選びます。
eBay専用VercelのSettings → Environment Variablesを開き、下の対応表どおりに設定します。App IDとCert IDは機密設定で保存します。
操作コードを作成し、EBAY_OPERATOR_SECRETへ設定します。自分でも安全な場所に控えてください。
再デプロイ後、「設定状況を確認」を押します。Sandboxと本番のキーを区別して確認できます。

eBay側の項目	Vercelに設定する名前
SandboxのApp ID（Client ID）	`EBAY_SANDBOX_CLIENT_ID`
SandboxのCert ID（Client Secret）	`EBAY_SANDBOX_CLIENT_SECRET`
接続先	`EBAY_ENVIRONMENT=sandbox`
Aim専用の操作コード	`EBAY_OPERATOR_SECRET`

eBay専用Vercelを開く Sandbox設定例をダウンロード

操作コードはボタンを押した時だけ、このブラウザーで作成します。Aimへの送信・画面表示・ブラウザー保存は行いません。App ID・Cert IDの値を、このチャットや画面共有へ貼る必要はありません。

登録で使う事業者名・担当者名・連絡先はご本人の情報で入力します。資料内の未記入欄は提出前に埋めてください。公式の登録・キー作成手順

02 / CONNECTION STATUS

接続の準備状況

ボタンを押すと、このアプリの設定状況を確認できます。APIキーの値は表示しません。

NEXT ACTION

現在の接続設定を確認

まず設定状況を確認してください。

次に進む

まだ設定を確認していません。

接続先	未確認
接続先のAPIキー	未確認
Sandbox用のAPIキー	未確認
本番用のAPIキー	未確認
アプリ用の操作コード	未確認
本番の用途承認	未確認
本番のデータ取扱準備	未確認
このブラウザーの利用状態	未確認

承認・データ取扱の表示は、運用者が証跡を確認して設定した状態です。eBayの審査状況を自動で照会するものではありません。

キー設定後：操作コードを入力して接続テスト

新規取得を使う方に渡す、このアプリ専用の操作コードです。eBayのパスワードやClient Secretはこの欄へ入力しないでください。

入力内容は送信後に消去されます。このブラウザーでの利用期限は4時間です。

認証・商品検索1回（最大1件）・カテゴリ確認1回を実行します。取得結果はDBに保存しません。Sandboxで0件でも通信が成功すれば接続成功です。本番のテストにも用途承認とデータ取扱準備が必要です。

接続テストはまだ実行していません。

運用担当者向け：共通保存・API使用量

共通保存の稼働状態、期限切れデータの削除、アプリ全体のAPI使用量を確認できます。共通保存の本番利用は承認・削除対応の完了後に開始します。

未確認。操作コードを確認後に利用できます。

運用担当者向け：削除通知の状態

操作コードを確認した担当者だけが、通知の受付件数と未処理件数を確認できます。eBayへの通信やデータの削除は行いません。

未確認。操作コードを確認後、削除通知の状態を確認できます。

03 / NEXT STEPS

申請から利用開始まで

開発者登録・メール認証事業で使用するメールアドレスで登録します。規約の同意や登録者の本人情報は、ご本人の内容で手続きを進めます。
Sandbox用のキーを作成Application Keysでアプリ名「Aim」を入力し、SandboxのCreate a keysetを選びます。App ID（Client ID）とCert ID（Client Secret）が接続に必要です。
テスト環境で接続を確認キーをeBay専用Vercelへ保存後、上の接続テストと手動リサーチを確認します。Sandboxは架空のテスト出品を扱い、日本セラーの実数確認には使いません。
セラーリサーチ用途の利用可否を確認・申請下の説明資料をもとに、会員向け商品調査・セラー別表示・CSV/JSON出力の許可範囲を確認します。eBayの本番申請案内にはEPN・Buy API申請・画面とデータの流れの提出が記載されています。今回の商用会員サービス用途に適用される申請経路を先に確認します。
本番キーとデータの取扱を整備本番キーを作成し、削除通知の購読・削除処理・保管と書き出しデータの扱いを仕上げます。削除通知の受信口と受付状態の確認機能は実装済みですが、受信は無効です。ID照合・実データ削除・再取得防止は未完了です。保存済みのセラー情報もあるため、通知の免除対象とは判断していません。公式の削除通知設定
承認内容を反映して本番へ切り替え実際の用途承認とデータ取扱の準備を確認し、本番接続テストを実行します。その後「セラーリサーチ」でキーワード検索 → セラー選択 → 商品抽出を確認します。

キーの発行と、セラーリサーチ用途の許可は別です。対象セラー情報や分析・書き出しについて、必要な許可を確認します。API利用規約のデータ利用条件

04 / APPLICATION BRIEF

申請用に整理したアプリの説明

アプリ名	Aim
サブタイトル	Aim for eBay
画面URL	https://ebay-delta-henna.vercel.app/ 基礎調査データはログイン後に閲覧可能。個人の仕入候補・プラン・メモは会員別に保存。新規API取得は未接続。
用途	キーワードで日本・海外の出品からセラーを探し、選んだセラーの出品を国内仕入れに向けた商品調査へ利用する。日本所在地に絞った検索も可能。
希望するAPI	Browse API（商品検索）、Taxonomy API（カテゴリ取得）、Application access token（アプリ認証）。対象はEBAY_US。
取得項目	出品ID、商品名、状態、表示価格・通貨、送料、商品所在地、出品URL、セラー名・アカウント識別子、評価数・高評価率、取得日時。
操作と保管	実行ボタンによる取得。セラーごとのチェックボックスで選択し商品抽出。作業中の結果をこのタブで最大24時間一時保持。選んだセラーは明示操作で保存（未ログインは端末内、会員は個人領域）。必要時にCSV/JSONへ出力。自動巡回なし。今後、検索で得た公開情報の共通再利用を予定（現在停止中、再利用15分・期限切れ削除5分間隔）。個人のメモ・仕入情報は共通化しない。
確認を依頼する点	会員向け商品調査・セラー別整理・評価表示・既存の価格比較画面・書き出しが許可される範囲、追加許可・削除対応・保管条件。

操作とデータの流れ

01 / 検索担当者がキーワードを入力して実行。アプリサーバーが認証と検索を行う。

02 / 選択取得できたセラーを一覧に整理。担当者がチェックボックスで選ぶ。

03 / 抽出選択セラーの出品を取得。画面で確認し、必要な結果を出力する。

商品所在地と登録国は区別します。Browseの現在出品から、実際の成約価格・期間内販売数・日本の全セラー数は確定できません。

英文説明・申請確認項目設定と検証の詳細手順

Vercelに設定する項目

設定先はeBay専用プロジェクトです。キーと操作コードは機密の環境変数として保存し、設定変更後に再デプロイします。

`EBAY_ENVIRONMENT`	最初は `sandbox`。本番利用開始時に `production`。
`EBAY_SANDBOX_CLIENT_ID` `EBAY_SANDBOX_CLIENT_SECRET`	SandboxのApp ID / Cert ID。
`EBAY_CLIENT_ID` `EBAY_CLIENT_SECRET`	本番のApp ID / Cert ID。
`EBAY_OPERATOR_SECRET`	ランダム生成した32文字以上の操作コード。
`EBAY_PRODUCTION_APPROVED`	用途承認の証跡を確認後に `true`。
`EBAY_DATA_HANDLING_READY`	削除通知・削除処理・保管と出力の取扱を検証後に `true`。

これらの確認項目をtrueに設定すること自体は、eBayへの申請や承認にはなりません。

準備資料の確認日：2026年9月22日。審査条件はeBayの案内と個別回答に従って更新します。