1. Startseite
  2. Docs
  3. Amzpecty-Dokumentation
  4. Amzpecty API-Spezifikationen
  5. Produktbewertungs-API

Produktbewertungs-API

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
JSON
{
    "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
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
}
PRODUKTBEWERTUNG, ABFRAGE, RÜCKRUF, ANTWORT, JSON-ATTRIBUTE
AttributnameDetails
StatusDer Status der Anfrage.
Antwortfür„productvariations“-Wert für das Abfrageergebnis „Produktvariationen“.
erlaubtDie aktuell zulässige Anforderungsanzahl. Wird monatlich zurückgesetzt.
täglichErlaubtDie aktuell zulässige tägliche Anforderungsanzahl. Wird täglich zurückgesetzt.
Nachrichten IDDie ID der Nachricht (falls vorhanden).
NachrichtDie eigentliche Nachricht (falls vorhanden). Bitte beziehen Sie sich auf Fehlermeldungen.
zu befreienDie Anfrage-ID. Dies kann verwendet werden, um diese Antwort der ursprünglichen Anfrage zuzuordnen.
DatumVerarbeitetDas Datum, an dem die Anfrage im Unix-Zeitformat verarbeitet wurde.
DomainDie Zieldomäne von Amazon.
totalCreditsAbgezogenDieses Feld gibt an, wie viele Amzpecty API-Credits zur Erfüllung dieser Anfrage verwendet wurden.
data.asinDie ASIN des Produkts.
Daten. SuchstatusDer Suchstatus. [ „in Bearbeitung“, „abgeschlossen“, „Fehler“]
Daten. reviewPagesScannedDie Anzahl der gescannten Rezensionsseiten
Daten. requestFiltersDer Benutzer hat Filter für diese Abfrageanforderung angegeben
Daten. requestFilters. StandortStandortfilter. [„Vereinigte Staaten“, „Mexiko“ usw. wie in Amazon gezeigt]
Daten. requestFilters. verifiziertKaufNurwahr – 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 SternenSternebewertungsfilter [„1“, „2“, „3“, „4“, „5“]
data.totalReviewsEs zählt die Gesamtzahl der Bewertungen.
Daten. insgesamtVerifizierter KaufDie Gesamtzahl der verifizierten Kaufbewertungen.
Daten. RezensionStandorte[]Die Liste der Standorte mit der entsprechenden Bewertungsanzahl
Daten. reviewLocations[n].locationDer Bewertungsort
Daten. reviewLocations[n].reviewCountDie Anzahl der Bewertungsorte
Daten. Bewertungen []Die Liste der Bewertungen mit der entsprechenden Bewertungsanzahl
Daten. bewertungen[n].bewertungDie Rezensionsbewertung
Daten. Ratings[n].reviewCountDie Bewertungsbewertung zählt
Daten. Bewertungen[]Die Liste der Benutzerbewertungen mit den entsprechenden Informationsdetails
data.reviews[n].reviewIdDie Rezensions-ID
data.reviews[n].customerNameDer Name des Bewertungskunden
data.reviews[n].customerProfileLinkDer Link zum Bewertungsprofil
data.reviews[n].customerProfileAvatarDer Avatar-Link für das Bewertungsprofil
data.reviews[n].reviewTitleDer Rezensionstitel
data.reviews[n].reviewBodyDas Prüfgremium
data.reviews[n].reviewLocationDer Bewertungsort
data.reviews[n].reviewDateDas Überprüfungsdatum
data.reviews[n].verifiedPurchaseDie Markierung für den verifizierten Kauf durch die Rezension („wahr“, wenn verifiziert)
data.reviews[n].variantDie Testproduktvariante
data.reviews[n].starRatingDie Sternebewertung der Rezension
data.reviews[n].starRatingStringDie 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

War dieser Artikel hilfreich für Sie? Ja Nein
Wie können wir Ihnen helfen?