製品レビュー API クエリキューに ASIN/ISBN を追加
最近の Amazon の変更により、製品レビュー API は利用できなくなりました。
ASIN/ISBN を製品レビュー クエリ キューに追加するリクエスト。 製品レビュー API は、ユーザー定義のクエリ パラメーターに基づいて結果をフィルタリングする機能を使用して製品レビューをクエリします。
制限
API はフィルターの組み合わせごとに最大 100 件のレビューのみを取得できます。
クレジット控除
データの取得が成功すると、(製品レビューのページごとに) 1 クレジットが差し引かれます。 5 ページの製品レビューは、取得に成功すると 5 クレジットを消費します。
要求
| URI | /api/query/reviews/{ASIN/ISBN}?domain={ドメイン}&secretKey={secretKey} | {ASIN/ISBN} – 必須 – 追跡リストに追加する ASIN または ISBN
{ドメイン} – オプション – 有効な値が指定されていない場合、デフォルトは www.amazon.com になります [ http://www.amazon.com、/www.amazon.com ] {位置} – オプション – Amazon に示されているように、場所によってレビューをフィルタリングします。 例 (「米国」、「メキシコ」、「英国」など) {デートから} – オプション – 指定された日付以降に投稿されたレビューをフィルターします (有効なパターン「yyyy-MM-dd」) {デートト} – オプション – 指定された日付までに投稿されたレビューをフィルターします (有効なパターン「yyyy-MM-dd」) {確認済み購入のみ} – オプション – 購入済みの検証済みレビューのみをフィルターします (有効な値: 「true」または「false」) {評価} – オプション – 星評価でレビューをフィルターします (有効な値: 「1」、「2」、「3」、「4」、「5」) {最新のみ} – オプション – true の場合、最新の上位 10 件のレビューのみを取得します |
| 例 | /api/query/reviews/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx&location=Mexico&datefrom=2021-01-01&dateto=2021-12-31&verifiedpurchaseonly=true&rating=5&latestonly=true | |
応答
| ヘッダ | |
| メディアタイプ | アプリケーション/ json |
| JSONデータ |
JSONの
{
"status": "OK",
"allowed": 4971,
"messageId": null,
"message": null,
"data": null,
"rid": "58eb4fb8bfc2333894ce7dc7",
"dateProcessed": null
}注意: コールバック中に、rid を使用してコールバック データを元のリクエスト呼び出しにリンクできます。
製品レビュー クエリ コールバック
製品レビュー クエリ コールバック リクエスト
| URI | 例: https://your.server.com/amzpecty_result | {設定ページに URL を入力してください} URL は SSL が有効になっている必要があります。 AMZPECTY-API-SECRET-KEY (ヘッダー名) – コールバック サーバーがリクエストの発信元を検証するために秘密キー ヘッダーが含まれます。 |
| メディアタイプ | アプリケーション/ json |
製品レビュー クエリ コールバック JSON サンプル データ
| ヘッダ | |
| メディアタイプ | アプリケーション/ json |
| JSONデータ |
JSONの
{
"status": "OK",
"responsefor": "productreviews",
"allowed": 108974,
"dailyAllowed": 9903,
"messageId": null,
"message": null,
"data": {
"asin": "B01M5IK8M9",
"searchStatus": "completed",
"reviewPagesScanned": 4,
"requestFilters": {
"location": "United States",
"verifiedPurchaseOnly": true,
"fromDate": "Jan 01, 2021",
"toDate": "Dec 31, 2021",
"starRating": "5"
},
"totalReviews": 21,
"totalVerifiedPurchase": 21,
"reviewLocations": [
{
"location": "United States",
"reviewCount": 21
}
],
"ratings": [
{
"rating": "5.0 out of 5 stars",
"reviewCount": 21
}
],
"reviews": [
{
"reviewId": "R5N2Q27S1WE1P",
"customerName": "Spirit_Child",
"customerProfileLink": "https://www.amazon.com/gp/profile/amzn1.account.AFE7FQ7FOLUVIUTTUKVF3MVMUPFQ/ref=cm_cr_getr_d_gw_btm?ie=UTF8",
"customerProfileAvatar": "https://images-na.ssl-images-amazon.com/images/G/01/x-locale/common/grey-pixel.gif",
"reviewTitle": "I love it!",
"reviewBody": "It delivered on time & it’s what I was expecting!!",
"reviewLocation": "United States",
"reviewDate": "Dec 22, 2021",
"verifiedPurchase": true,
"variant": "Size: Standard",
"starRating": 5,
"starRatingString": "5.0 out of 5 stars"
}
]
},
"rid": "628c4494e4b06e3bbeaa8b5b",
"dateProcessed": 1653359777214,
"domain": "www.amazon.com",
"totalCreditsDeducted": 1
}製品レビュー クエリ コールバック レスポンス JSON 属性
| 属性名 | 詳細 |
|---|---|
| status | リクエストのステータス。 |
| 応答のための | 製品バリエーションのクエリ結果の「productvariations」値 |
| 許可されて | 現在許可されているリクエスト数。 毎月リセットされます。 |
| 毎日許可 | 現在許可されている XNUMX 日あたりのリクエスト数。 毎日リセットされます。 |
| メッセージID | メッセージの ID (存在する場合)。 |
| メッセージ | 実際のメッセージ (存在する場合)。 参照してください エラーメッセージ. |
| 取り除く | リクエストID。 これを使用して、この応答を元の要求と照合することができます。 |
| 処理された日付 | リクエストが処理された日付 (Unix 時間形式)。 |
| ドメイン | ターゲットの Amazon ドメイン。 |
| 差し引かれる合計クレジット数 | このフィールドは、このリクエストを満たすために使用された Amzpecty API クレジットの数を示します。 |
| データ.asin | 商品のASIN。 |
| データ。 検索ステータス | 検索ステータス。 [「進行中」、「完了」、「エラー」] |
| データ。 レビュースキャンされたページ | スキャンされたレビュー ページの数 |
| データ。 リクエストフィルター | このクエリリクエストに対してユーザーが指定したフィルター |
| データ。 requestFilters。 位置 | 場所フィルター。 【Amazonで表示される「米国」、「メキシコ」など】 |
| データ。 requestFilters。 確認済み購入のみ | true – 確認済みの購入のみを返します |
| データ。 requestFilters。 開始日 | フィルターから日付を確認します。 [“yyyy-MM-dd” 例: “2021-01-01”] |
| データ。 requestFilters。 現在まで | フィルターする日付を確認します。 [“yyyy-MM-dd” 例: “2021-12-31”] |
| データ。 requestFilters。 スター評価 | 星評価フィルター [「1」、「2」、「3」、「4」、「5」] |
| データ.合計レビュー数 | レビューの合計がカウントされます。 |
| データ。 合計認証済み購入しました | 確認済みの購入レビューの合計数。 |
| データ。 レビュー場所[] | 対応するレビュー数を含む場所のリスト |
| データ。 reviewLocations[n].location | レビューの場所 |
| データ。 reviewLocations[n].reviewCount | レビュー場所の数 |
| データ。 評価 [] | 評価のリストと対応する評価数 |
| データ。 評価[n].評価 | レビューの評価は |
| データ。 評価[n].reviewCount | レビュー評価数 |
| データ。 レビュー[] | ユーザーレビューのリストとそれに対応する情報の詳細 |
| data.reviews[n].reviewId | レビューID |
| data.reviews[n].customerName | レビューのお客様のお名前 |
| data.reviews[n].customerProfileLink | レビュープロフィールのリンク |
| data.reviews[n].customerProfileアバター | レビュープロフィールのアバターリンク |
| data.reviews[n].reviewTitle | レビューのタイトル |
| data.reviews[n].reviewBody | 審査機関 |
| data.reviews[n].reviewLocation | レビューの場所 |
| data.reviews[n].reviewDate | レビュー日 |
| data.reviews[n].verifiedPurchase | レビュー確認済み購入フラグ (確認済みの場合は「true」) |
| data.reviews[n].variant | レビュー製品のバリエーション |
| data.reviews[n].starRating | レビューの星評価 |
| data.reviews[n].starRatingString | 文字列形式のレビューの星評価 |
ASIN/ISBN ごとに製品レビューの結果を取得する
ASIN/ISBN ごとに最新の製品レビュー結果を取得するリクエスト。
クレジット控除
Get 呼び出しに対する 0 (ゼロ) クレジット控除。
要求
| URI | /api/query/reviews/asin/{ASIN/ISBN}?domain={ドメイン}&secretKey={secretKey} | {ASIN/ISBN} – 最新の追跡リストを取得するための ASIN {domain} – オプション – 有効な値が指定されていない場合は、デフォルトで www.amazon.com になります [ http://www.amazon.com、/www.amazon.com ] |
| 例 | /api/query/reviews/asin/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx | |
応答
詳細はこちら： 製品レビューの結果クエリ コールバック JSON サンプル データ
RID による製品レビューの結果を入手
RID による最新の製品レビュー結果を取得するリクエスト。
クレジット控除
Get 呼び出しに対する 0 (ゼロ) クレジット控除。
要求
| URI | /api/query/reviews/rid/{rid}?domain={ドメイン}&secretKey={secretKey} | { RID } – 最新のバリアント リストを取得するためのリクエスト ID {domain} – オプション – 指定しない場合、デフォルトは www.amazon.com です。 見る サポートされている Amazon ドメイン リスト用。 |
| 例 | /api/query/reviews/rid/628c4494e4b06e3bbeaa8b5b?domain=www.amazon.com&secretKey= xxxxxxxxxx | |
