eBay Research — Members

eBay 売れ筋リサーチ

発送元 日本 × カテゴリー × 価格帯で、販売数が条件以上 且つ 評価数が条件以上の商品だけ

eBay API キー（App ID・Cert ID）の取り方

このツールは、あなた自身の eBay API キーで eBay を検索します。キーは eBay の「開発者プログラム」で無料で取れます。

かかる時間は 入力 10分 ＋ 承認待ち 約1営業日 ＋ キー作成 5分。必要なのは App ID（Client ID） と Cert ID（Client Secret） の2つだけです。

0全体の流れ

図0: 6つのステップ。3〜6は承認メールが届いてから

① 開発者登録10分 ② 承認待ち約1営業日 ③ 本番キー作成2分 ④ キーを控える1分 ⑤ 有効化2分 ⑥ 貼る1分 ここで一度止まります（メールを待つ）
⚠️ 開発者登録は、承認が下りるまで約1営業日かかります。登録した日には先へ進めません。承認のメールが届いてから ③ に進んでください。
ℹ️ いつもの eBay アカウントと、開発者アカウントは別物です。開発者サイトは eBay の売買用の ID・パスワードではログインできません。開発者サイトで新しく登録します（メールアドレスは eBay と同じものを使って構いません）。

1開発者プログラムに登録する

目安 10分 ／ 場所: developer.ebay.com（画面は 01 → 02 → 03 の順に進みます）

01. 登録フォームを埋めて Join を押す

  1. ブラウザで eBay Developers Program を開き、Register（登録）を押す

  2. 「Create a Username and Password for your eBay developer account」の画面が出る。

    登録は無料（Membership is free!）

  3. 4つの欄を埋める:

    Username（ユーザー名）／Password（パスワード）

    Email（メールアドレス。サインインとパスワード再設定に使う）／Re-enter Email（同じメールアドレスをもう一度）

  4. I have read and accept the eBay API License Agreement（利用許諾契約に同意）にチェックを入れる
  5. Join（参加）を押して送信

図1-01: 登録フォーム（画面: eBay Developers Program）

eBay 開発者アカウントの登録フォーム。Username・Password・Email・Re-enter Email の4欄と、License Agreement の同意チェック、Join ボタン
パスワードには条件（長さ・記号など）があります。はねられたら画面の指示に合わせて作り直してください。

02. 届いたメールのリンクを押す

  1. Join を押すと「Confirm Your Email Address」の画面に変わり、入力したメールアドレスに確認メールが送られる（画面のアドレスは一部が伏せ字で出ます）

    図1-02: 確認メールを送った画面。

    メールのリンクを押すまで先に進まない

    Confirm Your Email Address の画面。</p><p>確認メールを送った旨と Re-send it ボタン

  2. メールを開き、本文の Click to Confirm Email を押す。

    これで登録が完了する（ボタンが押せないときは、その下の長いリンクを開く。リンクは送信から24時間で切れる）

    図1-02b: 届く確認メール（画面: eBay Developers Program からのメール。名前とメールアドレスは伏せてあります）

    eBay Developers Program からの確認メール。Click to Confirm Email のボタンと、代わりに開ける確認リンク、24時間で切れる旨
  3. 届かないときは迷惑メールフォルダを確認。それでも無ければ Re-send it（再送）を押す

03. 「Welcome」の画面が出たら申請は完了。承認を待つ

  1. リンクを押すと「Welcome to eBay Developers Program!」の画面になる。

    メールアドレスの確認が済み、登録が eBay の審査に回ったという意味

  2. 審査には少なくとも約1営業日かかる（This usually takes at least one business day）
  3. Login to access your account は、承認されるまで押しても入れない（Available once your registration is approved）

図1-03: 申請完了の画面。ここまで来たら、あとは承認メールを待つだけ

Welcome to eBay Developers Program の画面。メール確認済み・審査中、少なくとも1営業日かかる旨と、承認後に使える Login ボタン

2メールを確認して、承認を待つ

目安 約1営業日（土日祝をはさむと長くなります）

  1. 承認のメールが届く。このメールが届けば申請完了

    図2-01: 届くメール（画面: eBay Developers Program からのメール。名前は伏せてあります）

    eBay Developers Program からのメール。Your eBay developer account has been created! と、次にできること・注意点の案内
✋ 承認のメールが来る前に ③ へ進んでも、キーは作れません。焦らず待ってください。

3本番（Production）のキーを作る

目安 2分 ／ 場所: 開発者サイトにサインイン → 右上の名前 → Application Keysets

  1. eBay Developers Program に、①で作った開発者アカウントでログインする。
    ログインを行うと、「Create a keyset」の画面に自動遷移する。

    図3-01: Create a keyset の画面（画面: eBay Developers Program）

    Create a keyset の画面。Application Title の入力欄と、Environment の Sandbox／Production の選択（Production にチェック）、Create keyset ボタン
  2. Application Title は「イーベイリサーチ」「ebay research」「ツール」等、任意のタイトルを入れる。
  3. Production を選択し、Create a keyset を押す

    図3-02: 連絡先の確認（Confirm the Primary Contact）の画面（画面: eBay Developers Program。氏名・メール・電話は伏せてあります）

    Confirm the Primary Contact の画面。First Name・Last Name・Email・Phone の入力欄、Individual／Business の選択、Continue to Create Keys ボタン
  4. 必要事項を入力して Continue to Create Keys を押す。Individual と Business は Individual を選択。
実際に登録者が Individual（個人）か Business（企業）かの正真性（本当かどうか）は問われないようです。入力項目が増えるだけなので、ここでは Individual を選んでおきましょう。

4App ID と Cert ID を控える

目安 1分

  1. 作成すると Production の枠に App ID (Client ID)・Dev ID・Cert ID (Client Secret) が表示される

    図4-01: キー作成直後の画面「Your Production keyset is ready」（画面: eBay Developers Program。ID の値は伏せてあります）

    Your Production keyset is ready の画面。App ID (Client ID)・Dev ID・Cert ID (Client Secret) の3行と、コピーのアイコン、Cert ID の目のマーク
  2. このツールで使うのは App ID と Cert ID の2つ。Dev ID は使わない
  3. 2つとも、メモ帳などにコピーして安全な場所に保存する（Cert ID はパスワードと同じ扱い。人に見せない）
🔑 Cert ID は「一度しか表示されない」場合があります。作成した画面を閉じる前に必ず控えてください。控え忘れたら、その keyset を削除して作り直します。

5本番キーを有効化する

目安 2分 ／ 場所: 画面上部の名前 → Alerts and Notifications

作ったばかりの本番キーは 「disabled（無効）」 の状態です。eBay の決まりで「利用者の削除通知をどう扱うか」を申告すると有効になります。

このツールは eBay の利用者データを保存しないので、「免除（Exempted）」にチェックを入れるだけで済みます。

  1. 画面上部の 「Hi ○○」（自分の名前） のメニューから Alerts and Notifications（通知設定）を開く。

    開いた直後は Environment が Sandbox になっている

    図5-01: Alerts & Notifications を開いた直後（画面: eBay Developers Program。名前は伏せてあります）

    Alerts & Notifications の画面。Environment は Sandbox が選ばれ、右のプルダウンは空。下に User Tokens と Alerts & Notifications のタブ

  2. Environment で Production を選び、右のプルダウンで③で作ったアプリ名（例: いーべいりさーち）を選ぶ。

    選ぶと下に App ID / Client ID が出る（有効化の前は、アプリ名の横に「Non Compliant」と付いている）

  3. タブが Alerts & Notifications になっているのを確認し、Event Notification Delivery Method で Marketplace Account Deletion を選ぶ
  4. Exempted from Marketplace Account Deletion のスイッチを ON にする

  5. Exemption reason は I do not persist eBay data（eBay のデータを保存しない）を選ぶ。

    Additional information は空のままでよい

    図5-02: Production を選んだあとの申告画面。スイッチを ON にして理由を選び、Submit（画面: eBay Developers Program。App ID は伏せてあります）

    Alerts & Notifications の画面。Production を選択、アプリ名のプルダウン、App ID、Marketplace Account Deletion を選択、Exempted のスイッチ ON、Exemption reason は I do not persist eBay data、Additional information の空欄、Submit ボタン
  6. Submit を押す。Application Keys に戻って「disabled」の表示が消えていれば有効化できています
画面には「正しい情報を申告しないとペナルティやアカウント停止になることがある」という注意書きがあります。このツールは eBay の利用者データを保存しないので、I do not persist eBay data を選ぶのが正しい申告です。

6ツールの設定画面に貼る

目安 1分 ／ 場所: このサイトの「設定」

  1. このサイトにログインして 設定 を開く

  2. 「eBay 公式 API キー」の欄で、左の Client ID（App ID） に④で控えた App ID、右の Client Secret（Cert ID） に Cert ID を貼って 保存 を押す。

    上に「eBay API キーを保存しました。「接続テスト」で確認してください」と出て、状態が 登録済み になる

    図6-01: 保存した直後の設定画面（App ID は伏せてあります）

    設定画面。上部に「eBay API キーを保存しました」の通知、状態は登録済み、Client ID と Client Secret の入力欄、保存ボタン、接続テストボタン

  3. 接続テスト を押す。

    上に「接続テスト: トークン: OK ／ 検索: OK（該当 ◯ 件・取得 ◯ 件）／ 単品照会: OK（例: 商品名 / 販売数 / 評価）」と出れば完了

    図6-02: 接続テストが通ったときの表示（App ID は伏せてあります）

    設定画面。上部に「接続テスト: トークン: OK ／ 検索: OK ／ 単品照会: OK」の通知
  4. 「リクエスト」タブから、見たい条件を出せるようになります
接続テストが「401 client authentication failed」になるときは、⑤の有効化がまだです。⑤をやり直してから数分おいて、もう一度テストしてください。

よくある質問

いつもの eBay アカウントで開発者サイトにログインできますか？
できません。開発者アカウントは別に登録します。メールアドレスは同じものを使えます。
お金はかかりますか？
かかりません。開発者登録もキーの作成も無料で、このツールでの利用にも eBay からの請求はありません。
Sandbox のキーは要りますか？
要りません。このツールで使うのは Production（本番）のキーだけです。App ID の途中に PRD が入っているものが本番です（SBX は練習用）。
承認のメールが来ません
土日祝をはさむと2〜3日かかることがあります。迷惑メールフォルダも確認してください。1週間来なければ eBay の開発者サポートに問い合わせます。
Cert ID を控え忘れました
Application Keysets の画面で、その keyset を削除して新しく作り直します。新しい App ID と Cert ID をツールに貼り直してください。
キーは他の人と共有していいですか？
いけません。Cert ID はパスワードと同じです。1人1つ、自分のキーだけを使ってください。

画面の名称は eBay の開発者サイトの英語表記に合わせています。eBay 側の画面は予告なく変わることがあります。

設定画面へ戻る