プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
eBayの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | keywordに一致するeBayの出品を検索します。出品価格、通貨、状態、配送条件、出品者を取得できます。状態、サイトドメイン、価格帯で絞り込めます。sold_onlyを指定すると、売却済みと確認された出品のみに絞り込まれます。市場全体の取引量を測るものではありません。 | 1,000リクエストあたり$1.39 | 正常 |
ストアstore | eBay出品者のストアから、正確なsellerユーザー名を指定して出品一覧を取得します。各商品の価格、状態、送料、画像が含まれます。取得できるのは出品のみで、出品者の残高、非公開の評価情報、内部在庫は含まれません。 | 1,000リクエストあたり$1.39 | 正常 |
レビューreviews | eBayの出品1件に対する購入者の評価を取得します。出品はsellerのユーザー名とitem_idで指定します。評価、出品者の返信、評価者自身の評価スコア、商品の詳細を取得できます。評価履歴をすべて取得できるとは限りません。 | 1,000リクエストあたり$1.39 | 正常 |
販売済みの出品sold | keywordに一致するeBayの成立済み取引を、指定した日数分さかのぼって取得します。販売価格、送料、合計金額、販売日、出品形式、出品者の評価を取得できます。これらは取引が成立した各出品の情報であり、純収益や今後の需要を推定するものではありません。 | 1,000リクエストあたり$1.39 | 正常 |
商品詳細product_detail | eBayの出品1件を、リンクまたは数値のアイテムIDから詳細に取得します。価格、状態、在庫状況、出品形式、ベストオファーの可否、配送情報と返品条件、ウォッチ数、ブランドとカタログコード、カテゴリパス、すべての画像、出品者の評価スコアと高評価率を取得できます。bid_countやends_atなどのオークション関連フィールド、およびgtinなどのコードは、出品ページに表示されている場合のみ含まれます。 | 1,000リクエストあたり$0.96 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
eBayの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索
| keyword | condition, country, domain, max_price, min_price, sold_only | Sync配信 | カタログ値：defaultLimit=20、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | item_id · title · url · price · price_text · currency · condition · shipping · seller · image_url · scraped_at · platform |
storeストア eBay出品者のストアから、正確な | seller | country, domain, store, url, username | Sync配信 | カタログ値：defaultLimit=20、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | item_id · title · url · price · price_text · currency · condition · shipping · seller · image_url · scraped_at · platform |
reviewsレビュー eBayの出品1件に対する購入者の評価を取得します。出品は | seller, item_id | country, domain, product_id, q, seller_name, url, username | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | text · rating · rating_scale · username · submitted_at · seller_reply · image_count · reviewer_feedback_score · reviewer_feedback_star · product_name · product_id · product_price · platform · image_url · images |
sold販売済みの出品
| keyword | days, min_price, site, sort | Sync配信 | カタログ値：defaultLimit=20、maxLimit=200。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · name · sold_price · shipping_price · total_price · currency · sold_at · condition · listing_type · best_offer_accepted · category · seller_username · seller_feedback_score · seller_positive_percent · image_url · platform |
product_detail商品詳細 eBayの出品1件を、リンクまたは数値のアイテムIDから詳細に取得します。価格、状態、在庫状況、出品形式、ベストオファーの可否、配送情報と返品条件、ウォッチ数、ブランドとカタログコード、カテゴリパス、すべての画像、出品者の評価スコアと高評価率を取得できます。 | url | — | Sync配信 | — | 1,000リクエストあたり$0.96 | item_id · title · subtitle · url · price · currency · condition · availability · listing_type · bid_count · best_offer_enabled · ends_at · quantity_available · quantity_sold · watchers · brand · model · mpn · gtin · product_id · categories · image_url · images · item_location · shipping_price · free_shipping · returns_accepted · seller · seller_url · seller_feedback_score · seller_positive_percent · updated_at · platform |
eBayのsearchのパラメータはそれぞれどういう意味ですか？
keywordに一致するeBayの出品を検索します。出品価格、通貨、状態、配送条件、出品者を取得できます。状態、サイトドメイン、価格帯で絞り込めます。sold_onlyを指定すると、売却済みと確認された出品のみに絞り込まれます。市場全体の取引量を測るものではありません。
keyword必須searchアクションでは出品中の商品、soldアクションでは終了済み・落札済みの出品を検索するための検索語です。出品中の希望価格が最終的な取引金額と一致するとは限りません。condition任意- 検索結果を商品の状態で絞り込みます。値はNew、Used、Refurbished、For parts or not workingのいずれかで、大文字・小文字とスペースはそのまま指定してください。これは商品の状態のフィルターで、高評価・低評価のレビューを絞り込むものではありません。
country任意- domainの互換入力で、同じくebay.comのようなeBayサイトのドメインを受け付けます。USやDEのような国コードではありません。両方を指定した場合はdomainが優先されます。
domain任意- eBayサイトのドメインを、スキームやパスを付けずに指定します（例：ebay.com、ebay.de、ebay.co.uk）。デフォルトはebay.comで、search、store、reviewsのページの生成に使われます。
max_price任意- 検索における商品価格の上限を数値で設定します。min_priceと組み合わせて範囲を指定できます。送料や税金が含まれているとは想定しないでください。
min_price任意- 商品価格の下限を数値で設定します。
searchアクションでは出品中の価格、soldアクションでは終了済み・落札済みの出品価格を絞り込みます。通貨は対象のマーケットプレイスサイトと出品データによって決まり、APIの課金とは関係ありません。soldでは整数で絞り込まれ、小数は切り捨てられます。 sold_only任意searchアクションでtrueにすると、取引が成立した商品のみを返すブール値の切り替えです。文字列（"false"）ではなく、JSONのブール値で渡す必要があります。
eBayのstoreのパラメータはそれぞれどういう意味ですか？
eBay出品者のストアから、正確なsellerユーザー名を指定して出品一覧を取得します。各商品の価格、状態、送料、画像が含まれます。取得できるのは出品のみで、出品者の残高、非公開の評価情報、内部在庫は含まれません。
seller必須- eBayの出品者アカウントのユーザー名を正確に指定します。ストアの表示名や会社名ではありません。
storeクエリでは出品者の出品一覧の取得に、reviewsクエリではitem_idと組み合わせて購入者の評価の取得に使われます。 country任意- domainの互換入力で、同じくebay.comのようなeBayサイトのドメインを受け付けます。USやDEのような国コードではありません。両方を指定した場合はdomainが優先されます。
domain任意- eBayサイトのドメインを、スキームやパスを付けずに指定します（例：ebay.com、ebay.de、ebay.co.uk）。デフォルトはebay.comで、search、store、reviewsのページの生成に使われます。
store任意- 出品者アカウントのユーザー名を表す
sellerの互換エイリアスで、任意のショップ名ではありません。storeアクションでは、引き続きメインのsellerパラメータが必須です。 url任意- URLの自動生成の代わりに、
storeアクションではeBayのストア・出品者の出品一覧ページ、reviewsアクションでは/fdbk/の評価ページを直接指定します。URLを指定しても、sellerやitem_idパラメータが必須であることに変わりはありません。 username任意storeおよびreviewsアクションにおける、出品者アカウントのユーザー名sellerの互換エイリアスです。sellerパラメータが優先され、引き続き必須です。このフィールドは購入者やレビュー投稿者のハンドルを表すものではありません。
eBayのreviewsのパラメータはそれぞれどういう意味ですか？
eBayの出品1件に対する購入者の評価を取得します。出品はsellerのユーザー名とitem_idで指定します。評価、出品者の返信、評価者自身の評価スコア、商品の詳細を取得できます。評価履歴をすべて取得できるとは限りません。
seller必須- eBayの出品者アカウントのユーザー名を正確に指定します。ストアの表示名や会社名ではありません。
storeクエリでは出品者の出品一覧の取得に、reviewsクエリではitem_idと組み合わせて購入者の評価の取得に使われます。eBay：取引評価プロフィール — eBayの取引評価は、ポジティブ、ニュートラル、ネガティブのいずれかの評価と短いコメントで構成されます。メンバーの評価プロフィールは、一般的な5つ星の商品レビューとは別の概念です。 · 確認日 item_id必須- 出品者の出品に紐づく数値のeBay商品ID（通常は
/itm/のURLから取り出します）で、reviewsクエリでsellerと組み合わせて使います。特定の出品を表すもので、汎用的なカタログ商品IDやレビューのIDではありません。 country任意- domainの互換入力で、同じくebay.comのようなeBayサイトのドメインを受け付けます。USやDEのような国コードではありません。両方を指定した場合はdomainが優先されます。
domain任意- eBayサイトのドメインを、スキームやパスを付けずに指定します（例：ebay.com、ebay.de、ebay.co.uk）。デフォルトはebay.comで、search、store、reviewsのページの生成に使われます。
product_id任意- 数値のeBay商品IDを受け付ける
item_idの互換エイリアスです。reviewsアクションでは、引き続きitem_idが必須です。 q任意reviewsアクションで数値のeBay商品IDを受け付けるitem_idの互換エイリアスです。自由テキストの検索クエリとしては使えません。商品検索にはkeywordを使ってください。seller_name任意- eBayの出品者アカウントのユーザー名です。
url任意- URLの自動生成の代わりに、
storeアクションではeBayのストア・出品者の出品一覧ページ、reviewsアクションでは/fdbk/の評価ページを直接指定します。URLを指定しても、sellerやitem_idパラメータが必須であることに変わりはありません。 username任意storeおよびreviewsアクションにおける、出品者アカウントのユーザー名sellerの互換エイリアスです。sellerパラメータが優先され、引き続き必須です。このフィールドは購入者やレビュー投稿者のハンドルを表すものではありません。
eBayのsoldのパラメータはそれぞれどういう意味ですか？
keywordに一致するeBayの成立済み取引を、指定した日数分さかのぼって取得します。販売価格、送料、合計金額、販売日、出品形式、出品者の評価を取得できます。これらは取引が成立した各出品の情報であり、純収益や今後の需要を推定するものではありません。
keyword必須searchアクションでは出品中の商品、soldアクションでは終了済み・落札済みの出品を検索するための検索語です。出品中の希望価格が最終的な取引金額と一致するとは限りません。days任意soldクエリで過去何日分までさかのぼるかを表す整数です（デフォルトは30）。出品期間や返される件数ではなく、検索対象とする過去の期間を表します。指定した日数の範囲について、すべての記録が取得できるとは限りません。min_price任意- 商品価格の下限を数値で設定します。
searchアクションでは出品中の価格、soldアクションでは終了済み・落札済みの出品価格を絞り込みます。通貨は対象のマーケットプレイスサイトと出品データによって決まり、APIの課金とは関係ありません。soldでは整数で絞り込まれ、小数は切り捨てられます。 site任意soldクエリで使うeBayのドメインを指定します（例：ebay.com、ebay.co.uk）。デフォルトはebay.comです。search、store、reviewsアクションで使うdomainパラメータとは別のものです。価格の通貨は、返される出品レコードに準じます。sort任意soldアクションの並び順です。指定できる値はnewest（終了日が新しい順）とdistance（近い順）です。元の出品の作成日では並べ替えません。省略した場合は、終了日が新しい順になります。指定可能な値:distancenewest
eBayのproduct_detailのパラメータはそれぞれどういう意味ですか？
eBayの出品1件を、リンクまたは数値のアイテムIDから詳細に取得します。価格、状態、在庫状況、出品形式、ベストオファーの可否、配送情報と返品条件、ウォッチ数、ブランドとカタログコード、カテゴリパス、すべての画像、出品者の評価スコアと高評価率を取得できます。bid_countやends_atなどのオークション関連フィールド、およびgtinなどのコードは、出品ページに表示されている場合のみ含まれます。
url必須- eBayの出品1件を指定します。https://www.ebay.com/itm/133576802017 のようなリンク（トラッキングパラメータとタイトル部分は除去されます）、または数値の商品IDのみを渡します。商品IDのみの場合はebay.comで読み取ります。他のeBayサイトのリンクはそのサイトで読み取ります。ストアページ、検索ページ、一覧ページは呼び出しの実行前に拒否されます。
eBay APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"ebay","action":"search","params":{"keyword":"<keyword>"}}'
eBay APIに関する質問
eBay APIでは何を取得できますか？
platformをebayに設定します。現在のカタログには検索、ストア、レビュー、販売済みの出品、商品詳細が掲載されています。これらのアクション名はそれぞれ異なるeBayのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
eBayのsearchリクエストを開始するには、どの入力を使用しますか？
searchアクションでは出品中の商品、soldアクションでは終了済み・落札済みの出品を検索するための検索語です。出品中の希望価格が最終的な取引金額と一致するとは限りません。params内のkeywordとして送信してください。
eBayのsearchはどのフィールドを返しますか？
宣言されたスキーマにはitem_id、title、price、price_textが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
eBayのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。