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

Produktvariations-API

Übergeordnete ASIN zur Abfragewarteschlange für Produktvariationen hinzufügen

Die Anfrage zum Hinzufügen einer übergeordneten ASIN zur Abfragewarteschlange für Produktvariationen.

KREDITABZUG

1 (ein) Credit-Abzug für jede Variante nach erfolgreichem Datenabruf. Beispiel: Bei 5 Varianten werden 5 (fünf) Credits abgezogen, wenn alle 5 Varianteninformationen erfolgreich abgerufen wurden.

ANTRAG
URI /api/query/requestvariants/ {PARENTASIN}?domain={domain}&secretKey={secretKey} {PARENTASIN} – erforderlich – die übergeordnete ASIN, die zur Variantensuchwarteschlange hinzugefügt werden soll {domain} – optional – standardmäßig www.amazon.com, wenn nicht angegeben. Sehen Unterstützte Amazon-Domänen für Liste.
HTTP-Header (optional) AMZpecty_CALLBACK_URL={Ihre Rückruf-URL}
Beispiel /api/query/requestvariants/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx
RESPONSE
Headers
Medientyp Anwendung / Json
JSON-Daten
JSON
{
  "status": "OK",
  "allowed": 999,
  "dailyAllowed": 100,
  "messageId": null,
  "message": null,
  "data": null,
  "rid": "5e70778ce4b09ae7cdd98243",
  "dateProcessed": null
}

PRODUKTVARIANTEN ABFRAGE RÜCKRUF

PRODUKTVARIANTEN ABFRAGE 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
PRODUKTVARIATIONEN QUERY CALLBACK JSON BEISPIELDATEN
Headers
Medientyp Anwendung / Json
JSON-Daten
JSON
{
    "status": "OK",
    "responsefor": "productvariations",
    "allowed": 142658,
    "dailyAllowed": 9828,
    "messageId": null,
    "message": null,
    "data": {
        "parentAsin": "B077HN95T8",
        "itemName": "Pendleton Women’s Heritage Chelsea Slip-Resistant Rain Boot",
        "salesRank": 31070,
        "options": [
            "Size",
            "Color"
        ],
        "totalVariations": 86,
        "variants": [
            {
                "asin": "B0772WW76G",
                "productUrl": "https://www.amazon.com/dp/B0772WW76G?th=1&psc=1",
                "option1": "Size",
                "option1Value": "6",
                "option2": "Color",
                "option2Value": "Rainier Red",
                "BBSellerName": "Fishbone Apparel",
                "BBPrice": 109.95,
                "BBQuantity": 2,
                "BBType": "FBA",
                "salesRank": 31070,
                "totalOffers": 1,
                "dimension": "3.8 x 9.5 x 11.7 inches",
                "imageUrl": "https://m.media-amazon.com/images/I/31wd4kuv6IL._SCLZZZZZZZ__SL80_.jpg",
                "weight": "3.351 pounds",
                "reviewPercentage": 2.08,
                "reviewCount": 2,
                "globalRatingsPositive": 4486,
                "globalRatingsCritical": 421,
                "globalReviewPositive": 1286,
                "globalReviewCritical": 271,
                "recentReview": "March 7, 2020",
                "searchStatus": "completed"
            },
            {
                "asin": "B07PJT8S6K",
                "productUrl": "https://www.amazon.com/dp/B07PJT8S6K?th=1&psc=1",
                "option1": "Size",
                "option1Value": "6",
                "option2": "Color",
                "option2Value": "Starwatchers Blue Print",
                "BBSellerName": "new pairs",
                "BBPrice": 109.95,
                "BBQuantity": 2,
                "BBType": "FBA",
                "salesRank": 31070,
                "totalOffers": 1,
                "dimension": "4.25 x 10.87 x 13.07 inches",
                "imageUrl": "https://m.media-amazon.com/images/I/41ooAxDOy5L._SCLZZZZZZZ__SL80_.jpg",
                "weight": "3.4502 pounds",
                "reviewPercentage": 0,
                "reviewCount": 0,
                "globalRatingsPositive": 0,
                "globalRatingsCritical": 0,
                "globalReviewPositive": 0,
                "globalReviewCritical": 0,
                "recentReview": "",
                "searchStatus": "completed"
            }
        ]
    },
    "rid": "5e70778ce4b09ae7cdd98243",
    "dateProcessed": 1584429103564,
    "domain": "www.amazon.com",
    "totalCreditsDeducted": 1
}
PRODUKTVARIATIONEN, 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.parentAsinDie übergeordnete ASIN der Produktvarianten.
Daten. ArtikelnameDer Artikelname des Produkts.
Daten. salesRankDer Verkaufsrang des übergeordneten Produkts.
Daten. Optionen[]Die Liste der verfügbaren Optionen. ZB [ „Größe“, „Farbe“ ]
data.totalVariationsDie Gesamtzahl der Variationen für das übergeordnete Asin.
Daten. Varianten[]Die Liste der Varianten des Parent Asin.
data.variants[n].asinDer Asin dieser Variante.
data.variants[n].productUrlDie Produkt-URL dieser Variante.
data.variants[n].option1Der Schlüssel für diese erste Option, wie in data.options[] aufgeführt. ZB „Größe“
data.variants[n].option1ValueDer Wert für diese erste Option. ZB „9“
data.variants[n].option2Der Schlüssel für diese zweite Option, wie in data.options[] aufgeführt. ZB „Farbe“
data.variants[n].option2ValueDer Wert für diese zweite Option. ZB „Yellowstone Yellow“
data.variants[n].option*Der Schlüssel für diese n-te Option, wie in data.options[] aufgeführt.
data.variants[n].option*WertDer Wert für diese n-te Option.
data.variants[n].BBSellerNameDer Buybox-Verkäufername dieser Variante.
data.variants[n].BBPriceDer Buybox-Preis dieser Variante ohne Versand.
data.variants[n].BBQuantityDie für den Buybox-Verkäufer dieser Variante verfügbare Menge.
data.variants[n].BBTypeDer Verkäufertyp dieser Variante. „FBA“ oder „FBM“
data.variants[n].salesRankDer Verkaufsrang dieser Variante.
data.variants[n].totalOffersDie Anzahl der Angebote dieser Variante.
data.variants[n].dimensionDie Dimension dieser Variante.
data.variants[n].imageUrlDie Bild-URL dieser Variante.
data.variants[n].weightDas Gewicht dieser Variante.
data.variants[n].reviewPercentageDiese Variante (Anzahl der Rezensionen / Anzahl aller Rezensionen) x 100.
data.variants[n].reviewCountSeit dem 11. September 2020 veraltet. Verwenden Sie stattdessen globalReviewPositive und globalReviewCritical.
data.variants[n].globalRatingsPositiveNEU. Hinzugefügt am 11. September 2020. Die Gesamtzahl der weltweiten positiven Bewertungen dieser Variante.
data.variants[n].globalRatingsCriticalNEU. Hinzugefügt am 11. September 2020. Die Gesamtzahl der globalen kritischen Bewertungen dieser Variante.
data.variants[n].globalReviewPositiveNEU. Hinzugefügt am 11. September 2020. Die Gesamtzahl der weltweiten positiven Bewertungen dieser Variante.
data.variants[n].globalReviewCriticalNEU. Hinzugefügt am 11. September 2020. Die Gesamtzahl der weltweiten kritischen Rezensionen dieser Variante.
data.variants[n].recentReviewDas letzte Überprüfungsdatum dieser Variante.
data.variants[n].searchStatusDer Abfragestatus dieser Variante. „in Bearbeitung“ oder „abgeschlossen“

ERHALTEN SIE PRODUKTVARIATIONEN. ERGEBNISDATEN DER ABFRAGE NACH ÜBERGEORDNETER ASIN

0 (null) Credit-Abzug für den Get-Aufruf.

Die Anfrage zum Abrufen der Ergebnisdaten der Produktvariationen-Abfrage nach übergeordneter ASIN.

ANTRAG
URI /api/query/getmatchasins/rid/{rid}?domain={domain}&secretKey={secretKey} { PARENTASIN } – die übergeordnete ASIN 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/getvariants/asin/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx
RESPONSE

See JSON-Beispieldaten für Produktvariationen-Abfragerückrufe

ERHALTEN SIE PRODUKTVARIATIONEN, ANFORDERUNGSERGEBNISDATEN NACH ANFRAGE-ID

Die Anfrage zum Abrufen der Produktvariations-Abfrageergebnisdaten nach Anfrage-ID.

KREDITABZUG

0 (null) Credit-Abzug für den Get-Aufruf.

ANTRAG
URI /api/query/getvariants/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/getvariants/rid/ 5e712345e4b04dd8c8b7e490?domain=www.amazon.com&secretKey= xxxxxxxxxx
RESPONSE

See JSON-Beispieldaten für Produktvariationen-Abfragerückrufe

War dieser Artikel hilfreich für Sie? Ja Nein
Was können wir für Sie tun?