Commerce Search API (COMMERCE_SERP)

​

Anfrage

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "COMMERCE_SERP", "payload": { "site": "amazon", "query": "wireless earbuds", "limit": 20 } }'

​

Parameter

• site: Erforderlich. Der zu durchsuchende Shop aus der Tabelle unten.
• query: Erforderlicher Suchbegriff mit 1 bis 500 Zeichen.
• country: Optional. Standard ist das Land des Shops. Jedes andere Land wird mit 422 REGION_UNSUPPORTED abgelehnt.
• limit: Optionale Ganzzahl von 1 bis 40, Standard 20.

​

Antwortbeispiel

{
  "site": "amazon",
  "query": "wireless earbuds",
  "country": "US",
  "returnedCount": 1,
  "products": [
    {
      "rank": 1,
      "productId": "B0CHWRXH8B",
      "title": "Wireless Earbuds, Bluetooth 5.3 Headphones",
      "url": "https://www.amazon.com/dp/B0CHWRXH8B",
      "price": 24.99,
      "currency": "USD",
      "rating": 4.6,
      "reviewCount": 19406
    }
  ]
}

​

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 shopeigene Produkt-ID, etwa die ASIN bei Amazon, die Artikelnummer bei eBay oder shop:item bei Rakuten. rank folgt der Standardsortierung des Shops. Außer bei Coupang überspringt es Einträge, die der Shop als gesponsert kennzeichnet.
• price, rating, reviewCount, imageUrl und brand erscheinen, wenn die Ergebnisseite sie zeigt. price ist eine Zahl in der currency (ISO 4217) des jeweiligen Produkts: Eine Amazon-Suche kann mehrere Währungen zeigen. Haben Größen unterschiedliche Preise, ist price der niedrigste. Target-Preise sind die des Standard-Onlineshops von Target. AliExpress-Preise sind die Verkaufspreise, die ein nicht angemeldeter Käufer in den USA sieht.
• rating nutzt eine Fünf-Sterne-Skala. Kurly und Zalando zeigen keine Bewertungen, AliExpress zeigt Sterne ohne Anzahl der Bewertungen, und abgekürzte Zahlen wie 999+ entfallen. brand liefern Target, Sephora, Ulta, Olive Young, Lotte ON, Musinsa, Yahoo! Shopping, Qoo10, Flipkart, Myntra, Nykaa und Zalando, die die Marke getrennt vom Titel zeigen.
• Bei google_shopping ist productId die Produkt-ID von Google oder die Angebots-ID, wenn Google das Angebot keinem Produkt zugeordnet hat. Googles Seite verlinkt weder Produkt- noch Händlerseiten, daher ist url die Google-Shopping-Ergebnisseite, auf der das Produkt gelistet ist, mit #product={productId}&title={title} am Ende. Übergeben Sie diese url an Commerce Product, um Shops, Spezifikationen und Beschreibung des Produkts zu lesen. seller ist der Shop, den Google zuerst nennt, und reviewCount erscheint nur, wenn Google die genaue Zahl zeigt (unter 1.000).
• Jede Suche liefert Produkte von der ersten Ergebnisseite des Shops. Diese Seite zeigt bei Yahoo! Shopping bis zu 30 Produkte, bei Myntra 32 und bei Zalando 24. Bei Flipkart hat sie 40 Plätze und bei Nykaa 20, gesponserte Einträge eingeschlossen.
• Leitet ein Shop die Suche auf eine andere Seite um, stammen die Produkte von dieser Seite: Ulta leitet manche Markennamen auf die Markenseite um, Target manche Suchen auf eine verwandte Suche, und Nykaa zeigt für Suchen nach einer Kategorie die Kategorieseite.
• Eine Suche ohne Produkte endet als fehlgeschlagener Task. Abgerechnet wird pro abgeschlossener Suche.

​

Siehe auch

• Commerce Product
• Engine-Übersicht
• Credits und Limits