API ドキュメント
アカウントで API キーを作成すると、レビュー、商品詳細、売れ筋ランキングのデータを取得できます。以下はリクエスト形式のサンプルです。このページからリクエストが送信されることはありません。
独立したデータ API はまだ提供されていません。以下のドキュメントは参考情報です。現在は MCP とログイン済みのブラウザー拡張機能でデータを収集できます。
curl --request POST \
--url 'https://sellerside.ai/api/v1/developer/products' \
--header "Authorization: Bearer $SELLERSIDE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"asin":"<ASIN>","market":"US","async":true}'サンプルをコピーして、ご自身の環境でご利用ください。このページからリクエストは送信されません。
認証とリクエストヘッダー
Authorization: Bearer <SELLERSIDE_API_KEY>
SellerSide.ai の API キーを使用してください。キーは作成時に一度だけ表示されます。不要になったキーは API キーの設定画面で無効化できます。
Idempotency-Key: <your-key>
同じリクエストを再試行する際は、同じ冪等性キーを使用してください。キーとパラメーターが一致する場合は既存のタスクが返され、重複して作成されません。
取得できる 3 種類のデータ
| データの種類 | エンドポイント | パラメーター | 必要な権限 |
|---|---|---|---|
| レビュー | POST /api/v1/developer/reviews | asin, market, pageCount, filterByStar, sortBy, async | api:reviews |
| 商品詳細 | POST /api/v1/developer/products | asin, market, async | api:products |
| ベストセラー | POST /api/v1/developer/best-sellers | content, market, async | api:best-sellers |
market の初期値は US です。レビューは US、CA、MX、UK、DE、JP、AU、IN、EG、AE に対応し、pageCount は 1〜10 を指定できます。filterByStar では、すべての評価、1〜5 つ星の指定評価、高評価、低評価で絞り込めます。sortBy は recent または helpful を指定します。商品詳細と売れ筋ランキングは 13 のマーケットプレイスに対応しています。商品詳細の asin には 10 桁の英数字を指定してください。売れ筋ランキングの content にはカテゴリーのキーワードを指定します。カテゴリーノード ID やページ番号は不要です。
結果には、フィールド名、型、入れ子構造が保持されます。レビューの totalReviews、ランキングの category、offset、nextPage に加え、タスクの状態とページ情報が返されます。null は取得できる値がないことを表します。
POST · タスクの送信
SellerSide.ai のタスク ID、状態、エラーコードが返されます。async: true を指定すると、収集の完了を待たずに処理待ちのタスクが返されます。
GET · 状態の確認
/api/v1/developer/tasks/<id>
自分のアカウントのタスクが処理待ち、完了、失敗のいずれの状態かを確認できます。
GET · 結果の取得
/api/v1/developer/tasks/<id>/results?page=1&size=50
完了したタスクの結果をページ単位で取得します。レスポンスには results、total、hasNextPage が含まれます。
利用枠とエラー
キーの作成と API の利用には、有効な有料会員資格が必要です。受け付けられたレビュータスクはリクエストしたページ数分、商品詳細とランキングのタスクはそれぞれ 1 回分の利用枠を消費します。状態の確認や保存済みの結果の取得では、利用枠を追加で消費しません。利用枠を使い切ると ALLOWANCE_EXHAUSTED が返されます。その他のエラーコードには AUTH_REQUIRED、RATE_LIMITED、INVALID_ARGUMENT、TASK_NOT_FOUND があります。