API-Dokumentation

Erstellen Sie in Ihrem Konto einen API-Schlüssel, um Rezensionen, Produktdetails und Bestsellerlisten abzurufen. Die folgenden Beispiele zeigen nur das Anfrageformat und senden keine Anfragen.

Die eigenständige Daten-API ist noch nicht verfügbar. Die Dokumentation dient als Referenz. Aktuell können Sie Daten per MCP über Ihre angemeldete Browser-Erweiterung sammeln.

cURL

curl --request POST \
  --url 'https://sellerside.ai/api/v1/developer/products' \
  --header "Authorization: Bearer $SELLERSIDE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"asin":"<ASIN>","market":"US","async":true}'

Kopieren Sie das Beispiel für Ihre eigene Einrichtung. Diese Seite sendet keine Anfragen.

Authentifizierung und Request-Header

Authorization: Bearer <SELLERSIDE_API_KEY>

Verwenden Sie Ihren API-Schlüssel von SellerSide.ai. Er wird nur einmal bei der Erstellung angezeigt. Sie können ihn jederzeit in den API-Schlüsseleinstellungen widerrufen.

Idempotency-Key: <your-key>

Verwenden Sie bei einem erneuten Versuch denselben Idempotenzschlüssel. Stimmen Schlüssel und Parameter überein, wird die bestehende Aufgabe zurückgegeben, statt eine neue anzulegen.

Drei Datenabfragen

Datentyp	Endpunkt	Parameter	Erforderliche Berechtigung
Rezensionen	POST /api/v1/developer/reviews	asin, market, pageCount, filterByStar, sortBy, async	api:reviews
Produktdetails	POST /api/v1/developer/products	asin, market, async	api:products
Bestsellerlisten	POST /api/v1/developer/best-sellers	content, market, async	api:best-sellers

Der Standardwert für market ist US. Rezensionen sind für US, CA, MX, UK, DE, JP, AU, IN, EG und AE verfügbar; pageCount akzeptiert Werte von 1 bis 10. Mit filterByStar können Sie alle Bewertungen, eine bestimmte Sternezahl von 1 bis 5 oder positive bzw. kritische Rezensionen auswählen. sortBy akzeptiert recent oder helpful. Produktdetails und Bestsellerlisten unterstützen 13 Marktplätze. Für Produktdetails muss asin aus 10 Buchstaben und Ziffern bestehen. Für Bestsellerlisten geben Sie in content ein Kategorie-Stichwort an; eine Kategorie-ID oder Seitenzahl ist nicht erforderlich.

Feldnamen, Datentypen und verschachtelte Strukturen bleiben erhalten, darunter totalReviews für Rezensionen sowie category, offset und nextPage für Ranglisten. Zusätzlich werden Aufgabenstatus und Angaben zur Seitennavigation zurückgegeben. Ein null-Wert bedeutet, dass keine Angabe verfügbar ist.

POST · Aufgabe erstellen

Gibt die SellerSide.ai-Aufgaben-ID, den Status und gegebenenfalls einen Fehlercode zurück. Mit async: true erhalten Sie eine ausstehende Aufgabe, ohne auf den Abschluss der Erfassung zu warten.

GET · Status abfragen

/api/v1/developer/tasks/<id>

Prüfen Sie, ob eine Aufgabe Ihres Kontos aussteht, abgeschlossen oder fehlgeschlagen ist.

GET · Ergebnisse abrufen

/api/v1/developer/tasks/<id>/results?page=1&size=50

Rufen Sie die Ergebnisse abgeschlossener Aufgaben seitenweise ab. Die Antwort enthält results, total und hasNextPage.

Kontingente und Fehler

Zum Erstellen von Schlüsseln und für API-Anfragen benötigen Sie eine aktive kostenpflichtige Mitgliedschaft. Angenommene Rezensionsaufgaben verbrauchen eine Einheit pro angeforderter Seite. Produktdetails und Ranglisten verbrauchen jeweils eine Einheit pro Aufgabe. Statusabfragen und das Abrufen gespeicherter Ergebnisse verbrauchen keine weiteren Einheiten. Bei ausgeschöpftem Kontingent wird ALLOWANCE_EXHAUSTED zurückgegeben. Weitere Fehlercodes sind AUTH_REQUIRED, RATE_LIMITED, INVALID_ARGUMENT und TASK_NOT_FOUND.