Zum Hauptinhalt springen
Durchsuchen Sie den Shop eBay (ebay.com) über die asynchrone Task-API. Senden Sie COMMERCE_SERP mit site ebay, um die Produkte einer Suche in der Reihenfolge des Shops zu erhalten. COMMERCE_PRODUCT liest die Produktseiten dieses Shops nicht. Eine abgeschlossene Suche kostet 0.5 Credits.

Suche

Senden Sie den Task und fragen Sie dann GET /v1/async/task/{id} ab oder empfangen Sie den Webhook. Siehe Asynchrone Tasks.

Parameter

  • site: Erforderlich. ebay.
  • query: Erforderlich. Suchbegriff mit 1 bis 500 Zeichen.
  • limit: Optionale Ganzzahl von 1 bis 40, Standard 20.
  • country: Optional. Standard ist US, das Land des Shops. Jedes andere Land wird mit 422 REGION_UNSUPPORTED abgelehnt.
Nur die oben aufgeführten Payload-Felder werden akzeptiert. Lassen Sie include weg: Auch include: {} führt vor der Credit-Reservierung zu 422 VALIDATION_ERROR für payload.include.

Antwortbeispiel

Ergebnisfelder

  • site, query und country geben die Anfrage wieder. returnedCount ist die Anzahl der Einträge in products.
  • Jedes Produkt enthält rank, productId, title und url. productId ist die eBay-Artikelnummer. rank folgt der Standardreihenfolge des Shops, und Einträge, die der Shop als gesponsert kennzeichnet, werden ausgelassen.
  • price, rating, reviewCount und imageUrl erscheinen, wenn die Ergebnisseite sie zeigt. price ist eine Zahl in der currency des Produkts (ISO 4217); haben Größen eigene Preise, ist es der niedrigste.
  • rating nutzt eine Fünf-Punkte-Skala. Abgekürzte Bewertungszahlen wie 999+ werden ausgelassen.
  • Jede Suche liefert Produkte von der ersten Ergebnisseite des Shops.

Fehler und Abrechnung

  • Eine Suche ohne Produkte endet als fehlgeschlagener Task.
  • Abgerechnet werden nur abgeschlossene Suchen, je 0.5 Credits.

Siehe auch