Antwortformat
Aufbau der Ergebnisse für Angebote, Produktdaten und Suche.
Das Ergebnis eines Jobs (GET /jobs/{job_id}/download) ist ein JSON-Objekt mit zwei Teilen: header mit Angaben zum Job und data mit einem Eintrag je Anfrage.
Aufbau
{
"header": {
"status": "success",
"job_id": "POD2-XX-XXXXXXXXXXXXXXXX",
"platform": "amazon",
"country": "de",
"category": "offers",
"max_pages": "1",
"job_status": "done",
"count_total": "2",
"count_work": "0",
"count_done": "2"
},
"data": [
{
"request": { "type": "gtin", "value": "4006381333931", "sku": "A-1001" },
"status": "done",
"reason": "",
"products": [
{ "offers": [ ] }
]
}
]
}
Das Beispiel ist gekürzt. Die Felder in products und offers hängen von Kategorie und Quelle ab.
Die Felder je Anfrage
| Feld | Inhalt |
|---|---|
request | Ihre ursprüngliche Anfrage, inklusive Ihrer eigenen Felder, dazu Zusatzinformationen wie die tatsächlich aufgerufene URL |
status | done, wenn die Anfrage erfolgreich bearbeitet wurde |
reason | Grund, wenn eine erfolgreiche Anfrage keine Daten geliefert hat, sonst leer |
products | die gefundenen Produkte |
products[].offers | die Angebote zu einem Produkt |
Je Kategorie
- Angebote (
offers): Jedes Angebot enthält mindestens Preis, Versandkosten und den Namen des Anbieters. Je nach Quelle kommen weitere Angaben dazu, etwa Verfügbarkeit, Lieferzeit oder Bewertungen. Bei einer eindeutigen Kennung wie einer ASIN gibt es ein Produkt mit mehreren Angeboten. Quellen wie eBay liefern dagegen mehrere Produkte mit je einem Angebot. - Produktdaten (
product): Beschreibung, Bilder, Merkmale und Rang des Produkts. - Suche (
search): alle Produkte, die die Quelle zu Ihrem Suchbegriff listet.
Die Antwort hat für jede Quelle denselben festen Aufbau. Jedes Feld ist vorhanden. Zeigt eine Quelle eine Angabe nicht, bleibt das Feld leer.
Als CSV
Im Kundenportal können Sie Ergebnisse auch als CSV herunterladen, passend für Excel. Trennzeichen, Dezimalzeichen und Zeichenkodierung stellen Sie im Auftrag ein, siehe Aufträge im Kundenportal.