Zum Hauptinhalt springen
Durchsuchen Sie den Shop Google Shopping (shopping.google.com) und lesen Sie seine Produktseiten über die asynchrone Task-API. Senden Sie COMMERCE_SERP mit site google_shopping, um die Produkte einer Suche in der Reihenfolge des Shops zu erhalten, oder COMMERCE_PRODUCT mit der url eines Produkts, um dieses Produkt zu lesen. Eine abgeschlossene Suche oder Produktseite kostet 2 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. google_shopping.
  • 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 Produkt-ID von Google oder die Angebots-ID für einen Eintrag, den Google keinem Produkt zugeordnet hat. rank folgt der Standardreihenfolge des Shops, und Einträge, die der Shop als gesponsert kennzeichnet, werden ausgelassen.
  • price, rating, reviewCount, imageUrl und seller 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. reviewCount erscheint nur, wenn Google die genaue Anzahl zeigt (unter 1.000).
  • Jede Suche liefert Produkte von der ersten Ergebnisseite des Shops.
  • Die Google-Seite verlinkt keine Produkt- oder Händlerseite, daher ist url die Google-Shopping-Ergebnisseite, auf der das Produkt gerankt wurde, mit #product={productId}&title={title} am Ende. Übergeben Sie diese url an COMMERCE_PRODUCT, um die Shops, technischen Daten und die Beschreibung des Produkts zu lesen. seller ist der Shop, den Google zuerst zeigt.

Produktseite

Parameter

  • url: Erforderlich. Die url eines Produkts aus einer Google-Shopping-Suche, höchstens 2.048 Zeichen: google.com/search?q={query}&udm=28&gl={market}#product={productId}&title={title}. Die productDetailUrl eines Produkts aus Ergebnissen von Google Search, Google AI Overviews und Google AI Mode funktioniert ebenfalls unverändert.
  • country: Optional. Standard ist das gl der url, eines von US, GB, AU, CA, KR, JP, TW, HK, DE, FR, ES, IT, PL, PT, BR, IN, ID, TH und VN. 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, country, url und productId kennzeichnen die Seite. url ist die gelesene Seite, und productId entspricht der ID aus einer Suche.
  • title ist immer vorhanden. brand, price, listPrice, currency, inStock, seller, rating, reviewCount, images, description, specs und offers erscheinen, wenn die Seite sie zeigt.
  • price ist, was ein Käufer laut der Seite beim Öffnen zahlt, vor Gutscheinen und Versand, in currency (ISO 4217). listPrice ist der reguläre Preis, den die Seite durchstreicht, vorhanden, wenn er über price liegt. inStock ist die Verfügbarkeit des Produkts. seller ist der Händler, der es verkauft.
  • rating nutzt eine Fünf-Punkte-Skala mit zwei Nachkommastellen. reviewCount ist die Anzahl der Bewertungen. reviewCount erscheint nur, wenn Google die genaue Anzahl zeigt (unter 1.000).
  • images listet bis zu 30 Fotos aus der Produktgalerie in Seitenreihenfolge.
  • description ist reiner Text mit einer Zeile pro Absatz, bis zu 10.000 Zeichen; Text, der nur in Bildern steht, ist nicht enthalten.
  • specs listet bis zu 100 Paare { name, value } aus den Produktdetails.
  • Der Lesevorgang führt die Suchanfrage der url erneut in Google Shopping in ihrem Markt aus, oder den Produkttitel, wenn Google das Produkt für die Anfrage nicht mehr zeigt, und öffnet das Produktfenster; er dauert daher länger als eine Shopseite. Zeigt Google das Produkt bei keiner der beiden Suchen, endet der Task mit PAGE_UNAVAILABLE.
  • offers listet die Shops, die Google für das Produkt zeigt, beginnend mit dem, den Google als besten Preis markiert, jeweils mit seller, title (dem Produktnamen des Shops), url (der Produktseite des Shops, wenn Google sie verlinkt), price, listPrice, currency und inStock. price, listPrice, seller und inStock des Produkts sind die des ersten Shops. Die Preise tragen die Währung des Shopping-Tabs des Markts (ISO 4217), unabhängig von der Sprache der Beschriftungen.
  • Eine productDetailUrl eines Produkts aus Google AI Overviews oder AI Mode sucht nach dem Produkttitel, und das Ergebnis liefert die productDocid dieses Produkts.

Fehler und Abrechnung

  • Eine Suche ohne Produkte endet als fehlgeschlagener Task.
  • Abgerechnet werden nur abgeschlossene Tasks: 2 Credits pro Suche oder Produktseite.

Siehe auch