ASIN/ISBN zur API-Abfragewarteschlange für Produktüberprüfungen hinzufügen
Die Anfrage zum Hinzufügen einer ASIN/ISBN zur Produktbewertungs-Abfragewarteschlange. Die Produktbewertungs-API fragt die Produktbewertungen ab und bietet die Möglichkeit, Ergebnisse basierend auf benutzerdefinierten Abfrageparametern zu filtern.
Einschränkung
Die API kann nur maximal 100 Bewertungen pro Filterkombination abrufen.
KREDITABZUG
1 (ein) Credit-Abzug (pro Seite der Produktbewertung) nach erfolgreichem Abruf der Daten. Für 5 Seiten Produktbewertung werden bei erfolgreichem Abruf 5 Credits verbraucht.
ANTRAG
URI | /api/query/reviews/{ASIN/ISBN}?domain={domain}&secretKey={secretKey} | {ASIN/ISBN} – erforderlich – die ASIN oder ISBN, die zur Tracking-Liste hinzugefügt werden soll
{Domain} – optional – standardmäßig www.amazon.com, wenn keine gültigen Werte angegeben sind [ http://www.amazon.com,/www.amazon.com ] {Standort} – optional – Bewertungen nach Standort filtern, wie in Amazon angezeigt. ZB („Vereinigte Staaten“, „Mexiko“, „Vereinigtes Königreich“ usw.) {stammen aus} – optional – filtert Bewertungen, die seit dem angegebenen Datum gepostet wurden (gültiges Muster „JJJJ-MM-TT“) {Datum bis} – optional – filtert Bewertungen, die bis zum angegebenen Datum gepostet wurden (gültiges Muster „JJJJ-MM-TT“) {verifiedpurchaseonly} – optional – filtert nur verifizierte gekaufte Bewertungen (gültiger Wert: „true“ oder „false“) {Bewertung} – optional – filtert Bewertungen nach Sternebewertung (gültige Werte: „1“, „2“, „3“, „4“, „5“) {aktuell} – optional – wenn wahr, werden nur die Top 10 der neuesten Bewertungen angezeigt |
Beispiel | /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 |
RESPONSE
Headers | |
Medientyp | Anwendung / Json |
JSON-Daten |
{
"status": "OK",
"allowed": 4971,
"messageId": null,
"message": null,
"data": null,
"rid": "58eb4fb8bfc2333894ce7dc7",
"dateProcessed": null
}
Note: Während des Rückrufs kann das Rid verwendet werden, um die Rückrufdaten mit dem ursprünglichen Anforderungsaufruf zu verknüpfen.
PRODUKTBEWERTUNGEN ABFRAGE RÜCKRUF
PRODUKTBEWERTUNGEN ANFRAGE RÜCKRUFANFRAGE
URI | Beispiel: https://your.server.com/amzpecty_result | {Bitte geben Sie die URL auf der Seite „Einstellungen“ an} Die URL muss SSL-aktiviert sein. AMZPECTY-API-SECRET-KEY (Header-Name) – Der Header des geheimen Schlüssels wird für den Rückrufserver zur Validierung des Anforderungsursprungs eingefügt |
Medientyp | Anwendung / Json |
PRODUKTBEWERTUNGEN ABFRAGE RÜCKRUF JSON BEISPIELDATEN
Headers | |
Medientyp | Anwendung / Json |
JSON-Daten |
{
"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
}
PRODUKTBEWERTUNG, ABFRAGE, RÜCKRUF, ANTWORT, JSON-ATTRIBUTE
Attributname | Details |
---|---|
Status | Der Status der Anfrage. |
Antwortfür | „productvariations“-Wert für das Abfrageergebnis „Produktvariationen“. |
erlaubt | Die aktuell zulässige Anforderungsanzahl. Wird monatlich zurückgesetzt. |
täglichErlaubt | Die aktuell zulässige tägliche Anforderungsanzahl. Wird täglich zurückgesetzt. |
Nachrichten ID | Die ID der Nachricht (falls vorhanden). |
Nachricht | Die eigentliche Nachricht (falls vorhanden). Bitte beziehen Sie sich auf Fehlermeldungen. |
zu befreien | Die Anfrage-ID. Dies kann verwendet werden, um diese Antwort der ursprünglichen Anfrage zuzuordnen. |
DatumVerarbeitet | Das Datum, an dem die Anfrage im Unix-Zeitformat verarbeitet wurde. |
Domain | Die Zieldomäne von Amazon. |
totalCreditsAbgezogen | Dieses Feld gibt an, wie viele Amzpecty API-Credits zur Erfüllung dieser Anfrage verwendet wurden. |
data.asin | Die ASIN des Produkts. |
Daten. Suchstatus | Der Suchstatus. [ „in Bearbeitung“, „abgeschlossen“, „Fehler“] |
Daten. reviewPagesScanned | Die Anzahl der gescannten Rezensionsseiten |
Daten. requestFilters | Der Benutzer hat Filter für diese Abfrageanforderung angegeben |
Daten. requestFilters. Standort | Standortfilter. [„Vereinigte Staaten“, „Mexiko“ usw. wie in Amazon gezeigt] |
Daten. requestFilters. verifiziertKaufNur | wahr – nur verifizierte Käufe zurückgeben |
Daten. requestFilters. ab Datum | Überprüfen Sie das Datum aus dem Filter. [„jjjj-MM-tt“, z. B. „2021-01-01“] |
Daten. requestFilters. miteinander ausgehen | Überprüfen Sie das Datum, um es zu filtern. [„JJJJ-MM-TT“, z. B. „2021-12-31“] |
Daten. requestFilters. Bewertung in Sternen | Sternebewertungsfilter [„1“, „2“, „3“, „4“, „5“] |
data.totalReviews | Es zählt die Gesamtzahl der Bewertungen. |
Daten. insgesamtVerifizierter Kauf | Die Gesamtzahl der verifizierten Kaufbewertungen. |
Daten. RezensionStandorte[] | Die Liste der Standorte mit der entsprechenden Bewertungsanzahl |
Daten. reviewLocations[n].location | Der Bewertungsort |
Daten. reviewLocations[n].reviewCount | Die Anzahl der Bewertungsorte |
Daten. Bewertungen [] | Die Liste der Bewertungen mit der entsprechenden Bewertungsanzahl |
Daten. bewertungen[n].bewertung | Die Rezensionsbewertung |
Daten. Ratings[n].reviewCount | Die Bewertungsbewertung zählt |
Daten. Bewertungen[] | Die Liste der Benutzerbewertungen mit den entsprechenden Informationsdetails |
data.reviews[n].reviewId | Die Rezensions-ID |
data.reviews[n].customerName | Der Name des Bewertungskunden |
data.reviews[n].customerProfileLink | Der Link zum Bewertungsprofil |
data.reviews[n].customerProfileAvatar | Der Avatar-Link für das Bewertungsprofil |
data.reviews[n].reviewTitle | Der Rezensionstitel |
data.reviews[n].reviewBody | Das Prüfgremium |
data.reviews[n].reviewLocation | Der Bewertungsort |
data.reviews[n].reviewDate | Das Überprüfungsdatum |
data.reviews[n].verifiedPurchase | Die Markierung für den verifizierten Kauf durch die Rezension („wahr“, wenn verifiziert) |
data.reviews[n].variant | Die Testproduktvariante |
data.reviews[n].starRating | Die Sternebewertung der Rezension |
data.reviews[n].starRatingString | Die Sternebewertung der Rezension in Stringform |
ERHALTEN SIE ERGEBNISSE DER PRODUKTBEWERTUNGEN NACH ASIN/ISBN
Die Anfrage, die neuesten Produktbewertungsergebnisse nach ASIN/ISBN zu erhalten.
KREDITABZUG
0 (null) Credit-Abzug für den Get-Aufruf.
ANTRAG
URI | /api/query/reviews/asin/{ASIN/ISBN}?domain={domain}&secretKey={secretKey} | {ASIN/ISBN} – die ASIN zum Abrufen der neuesten Tracking-Liste {domain} – optional – standardmäßig www.amazon.com, wenn keine gültigen Werte angegeben sind [ http://www.amazon.com,/www.amazon.com ] |
Beispiel | /api/query/reviews/asin/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx |
RESPONSE
See Produktbewertungen Ergebnis Abfrage Rückruf JSON-Beispieldaten
ERHALTEN SIE ERGEBNISSE DER PRODUKTBEWERTUNGEN NACH RID
Die Anfrage, die neuesten Produktbewertungsergebnisse von RID zu erhalten.
KREDITABZUG
0 (null) Credit-Abzug für den Get-Aufruf.
ANTRAG
URI | /api/query/reviews/rid/{rid}?domain={domain}&secretKey={secretKey} | { RID } – die Anforderungs-ID zum Abrufen der neuesten Variantenliste {domain} – optional – standardmäßig www.amazon.com, wenn nicht angegeben. Sehen Unterstützte Amazon-Domänen für Liste. |
Beispiel | /api/query/reviews/rid/628c4494e4b06e3bbeaa8b5b?domain=www.amazon.com&secretKey= xxxxxxxxxx |
RESPONSE
See Produktbewertungen Ergebnis Abfrage Rückruf JSON-Beispieldaten