AJOUTER un ASIN/ISBN à la file d'attente de requêtes de l'API d'évaluation des produits
La demande d'ajout d'un ASIN/ISBN à la file d'attente des requêtes d'évaluation des produits. L'API Product Reviews interrogera les avis sur les produits avec la possibilité de filtrer les résultats en fonction des paramètres de requête définis par l'utilisateur.
Limitation
L'API ne peut récupérer qu'un maximum de 100 avis par combinaison de filtres.
DÉDUCTION DE CRÉDIT
1 (un) crédit de déduction (par page d'évaluation du produit) après une récupération réussie des données. 5 pages de Product Review consommeront 5 crédits si la récupération réussit.
DEMANDE
| URI | /api/query/reviews/{ASIN/ISBN}?domain={domain}&secretKey={secretKey} | {ASIN/ISBN} – obligatoire – l'ASIN ou l'ISBN à ajouter à la liste de suivi
{domaine} – facultatif – la valeur par défaut est www.amazon.com si des valeurs valides non spécifiées [ http://www.amazon.com,/www.amazon.com ] {emplacement} – facultatif – filtrez les avis par emplacement, comme indiqué sur Amazon. Par exemple (« États-Unis », « Mexique », « Royaume-Uni », etc.) {datede} – facultatif – filtre les avis publiés depuis la date indiquée (modèle valide « aaaa-MM-jj ») {dateà} – facultatif – filtre les avis publiés jusqu'à la date indiquée (modèle valide « aaaa-MM-jj ») {achat vérifié uniquement} – facultatif – filtre uniquement les avis achetés vérifiés (Valeur valide : « vrai » ou « faux ») {notation} – facultatif – filtre les avis par nombre d'étoiles (valeurs valides : « 1 », « 2 », « 3 », « 4 », « 5 ») {dernièrement} – facultatif – si c'est vrai, n'obtiendra que les 10 avis les plus récents |
| Exemple | /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 | |
RÉPONSE
| En-têtes | |
| Type de support | application / json |
| Données JSON |
JSON
{
"status": "OK",
"allowed": 4971,
"messageId": null,
"message": null,
"data": null,
"rid": "58eb4fb8bfc2333894ce7dc7",
"dateProcessed": null
}Notes: Lors du rappel, le rid peut être utilisé pour lier les données de rappel à l'appel de la demande d'origine.
RAPPEL DE REQUÊTE SUR LES AVIS SUR LES PRODUITS
EXAMENS PRODUIT DEMANDE DE RAPPEL
| URI | Exemple : https://your.server.com/amzpecty_result | {Veuillez fournir l'URL dans la page Préférences} L'URL doit être activée pour SSL. AMZPECTY-API-SECRET-KEY (nom de l'en-tête) – l'en-tête de clé secrète sera inclus pour que le serveur de rappel valide l'origine de la demande |
| Type de support | application / json |
AVIS SUR LES PRODUITS REQUETE DE RAPPEL DE DONNÉES JSON
| En-têtes | |
| Type de support | application / json |
| Données 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
}EXAMEN DU PRODUIT REQUÊTE RÉPONSE DE RAPPEL ATTRIBUTS JSON
| Nom d'attribut | Détails |
|---|---|
| statuts | Le statut de la demande. |
| réponsepour | Valeur « productvariations » pour le résultat de la requête Variations de produit |
| permis | Le nombre de demandes actuellement autorisées. Se réinitialise mensuellement. |
| quotidiennementAutorisé | Nombre de demandes quotidiennes actuellement autorisées. Se réinitialise quotidiennement. |
| ID du message | L'identifiant du message (le cas échéant). |
| message | Le message réel (le cas échéant). Veuillez vous référer à Messages d'erreur. |
| débarrasser | L’identifiant de la demande. Cela peut être utilisé pour faire correspondre cette réponse à la demande initiale. |
| dateTraité | Date à laquelle la demande a été traitée au format d'heure Unix. |
| domaine | Le domaine Amazon cible. |
| totalCréditsDéduit | Ce champ indique combien de crédits API Amzpecty ont été utilisés pour répondre à cette demande. |
| données.asin | L'ASIN du produit. |
| données. état de recherche | L'état de la recherche. [ "en cours", "terminé", "erreur"] |
| données. revuePagesScannées | Le nombre de pages d'avis analysées |
| données. requêteFiltres | L'utilisateur a spécifié les filtres pour cette demande de requête |
| données. requestFilters. emplacement | Filtre de localisation. [« États-Unis », « Mexique », etc. comme indiqué sur Amazon] |
| données. requestFilters. vérifiéAchat uniquement | vrai – retourner l'achat vérifié uniquement |
| données. requestFilters. partir de la date | Date de révision à partir du filtre. [« aaaa-MM-jj » par exemple « 2021/01/01 »] |
| données. requestFilters. à ce jour | Date de révision à filtrer. [« aaaa-MM-jj » par exemple « 2021-12-31 »] |
| données. requestFilters. Évaluation étoilée | Filtre de notation par étoiles [« 1 », « 2 », « 3 », « 4 », « 5 »] |
| data.totalAvis | Le total des avis compte. |
| données. totalAchat vérifié | Le nombre total d’avis d’achat vérifiés. |
| données. reviewEmplacements[] | La liste des emplacements avec leur nombre d'avis correspondant |
| données. reviewLocations[n].location | Le lieu de l'examen |
| données. reviewLocations[n].reviewCount | Le nombre d'emplacements d'examen |
| données. notes [] | La liste des notes avec leur nombre de notes correspondant |
| données. notes[n].note | La note des critiques |
| données. notes[n].reviewCount | Le nombre de notes des avis |
| données. Commentaires[] | La liste des avis des utilisateurs avec leurs informations correspondantes |
| data.reviews[n].reviewId | L'identifiant de l'avis |
| data.reviews[n].customerName | Le nom du client de l'avis |
| data.reviews[n].customerProfileLink | Le lien du profil d'évaluation |
| data.reviews[n].customerProfileAvatar | Le lien de l'avatar du profil d'évaluation |
| data.reviews[n].reviewTitle | Le titre de la revue |
| data.reviews[n].reviewBody | L'organisme de révision |
| data.reviews[n].reviewLocation | Le lieu de l'examen |
| data.reviews[n].reviewDate | La date de révision |
| data.reviews[n].verifiedPurchase | L'indicateur d'achat vérifié de l'avis (« vrai » si vérifié) |
| data.reviews[n].variante | La variante du produit d'évaluation |
| data.reviews[n].starRating | Le nombre d'étoiles de l'avis |
| data.reviews[n].starRatingString | Le nombre d'étoiles de l'avis sous forme de chaîne |
OBTENIR LE RÉSULTAT DES AVIS SUR LES PRODUITS PAR ASIN/ISBN
La demande pour obtenir le dernier résultat des avis sur les produits par ASIN/ISBN.
DÉDUCTION DE CRÉDIT
0 (zéro) déduction de crédit pour l’appel Get.
DEMANDE
| URI | /api/query/reviews/asin/{ASIN/ISBN}?domain={domain}&secretKey={secretKey} | {ASIN/ISBN} – l'ASIN permettant d'obtenir la liste de suivi la plus récente {domaine} – facultatif – par défaut www.amazon.com si des valeurs valides non spécifiées [ http://www.amazon.com,/www.amazon.com ] |
| Exemple | /api/query/reviews/asin/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx | |
RÉPONSE
See Avis sur les produits Résultat de la requête Rappel Exemples de données JSON
OBTENIR LE RÉSULTAT DES AVIS SUR LES PRODUITS PAR RID
La demande pour obtenir le dernier résultat des avis sur les produits par RID.
DÉDUCTION DE CRÉDIT
0 (zéro) déduction de crédit pour l’appel Get.
DEMANDE
| URI | /api/query/reviews/rid/{rid}?domain={domain}&secretKey={secretKey} | { RID } – l'ID de demande pour obtenir la liste de variantes la plus récente {domaine} – facultatif – par défaut www.amazon.com s'il n'est pas spécifié. Voir Domaines Amazon pris en charge pour la liste. |
| Exemple | /api/query/reviews/rid/628c4494e4b06e3bbeaa8b5b?domain=www.amazon.com&secretKey= xxxxxxxxxx | |
RÉPONSE
See Avis sur les produits Résultat de la requête Rappel Exemples de données JSON
