COMMERCE_SERP avec site qoo10 pour recevoir les produits qu’affiche une recherche, dans l’ordre de la boutique, ou COMMERCE_PRODUCT avec l’url d’un produit pour lire ce produit. Une recherche ou une page produit terminée coûte 0.5 crédit.
Recherche
GET /v1/async/task/{id} ou recevez son webhook. Voir Tâches asynchrones.
Paramètres
site: obligatoire.qoo10.query: terme de recherche, de 1 à 500 caractères. Obligatoire si vous n’envoyez pasurl.url: une page boutique Qoo10 à lire au lieu de chercher, commehttps://www.qoo10.jp/shop/LG-BEAUTY; sa chaîne de requête est retirée. Envoyezqueryouurl, pas les deux.limit: entier facultatif de 1 à 40, avec 20 par défaut. Avecurl, de 1 à 200, avec 200 par défaut.country: facultatif. Par défaut,JP, le pays de la boutique. Tout autre pays est refusé avec422 REGION_UNSUPPORTED.
include : même include: {} renvoie 422 VALIDATION_ERROR sur payload.include avant toute réservation de crédits.
Exemple de réponse
Champs du résultat
site,queryetcountryreprennent la requête.returnedCountest le nombre d’éléments deproducts. Une tâche avecurlrenvoieurlau lieu dequery: la page boutique qui a été lue.- Chaque produit comporte
rank,productId,titleeturl.productIdest l’identifiant produit propre à la boutique.ranksuit l’ordre par défaut de la boutique, et les annonces que la boutique marque comme sponsorisées sont exclues. price,rating,reviewCount,imageUrletbrandapparaissent quand la page de résultats les affiche.priceest un nombre dans lacurrencydu produit (ISO 4217) ; quand les formats ont des prix différents, c’est le plus bas.ratingutilise une échelle de cinq points. Les nombres d’avis abrégés, comme 999+, sont omis.- Chaque recherche renvoie les produits de la première page de résultats de la boutique.
- Une page boutique Qoo10 montre les produits que le vendeur place dans les sections de sa boutique.
productsles liste dans l’ordre de la page et jusqu’àlimit, chaque produit une fois, etpriceest le prix qu’affiche chaque fiche, coupon de la boutique appliqué quand la fiche l’applique.
Page produit
Paramètres
url: obligatoire. Une page produit de la boutique Qoo10, de 2 048 caractères au plus :qoo10.jp/g/{id}. Lesurlde produit renvoyées par une recherche s’utilisent telles quelles. Les paramètres sans effet sur le résultat, comme les codes de suivi, sont retirés avant la lecture.country: facultatif. Par défaut,JP, le pays de la page. Tout autre pays est refusé avec422 REGION_UNSUPPORTED.
include : même include: {} renvoie 422 VALIDATION_ERROR sur payload.include avant toute réservation de crédits.
Exemple de réponse
Champs du résultat
site,country,urletproductIdidentifient la page.urlest la page lue, etproductIdcorrespond à celui que renvoie une recherche.titleest toujours présent.brand,price,listPrice,currency,inStock,rating,reviewCount,imagesetdescriptionImagesapparaissent quand la page les affiche.priceest ce que paie un acheteur tel que la page l’affiche à l’ouverture, avant coupons et livraison, encurrency(ISO 4217).listPriceest le prix habituel que la page barre, présent quand il dépasseprice.inStockindique la disponibilité du produit.ratingutilise une échelle de cinq points avec deux décimales.reviewCountest le nombre d’avis.imagesliste jusqu’à 30 photos de la galerie du produit, dans l’ordre de la page.descriptionImagesliste jusqu’à 300 images de la description du produit, dans l’ordre de la page. Les bannières et avis que les vendeurs placent dans leur description sont inclus, et le texte des images n’est pas lu.
Erreurs et facturation
- Une recherche qui ne renvoie aucun produit se termine par une tâche en échec.
- Une page produit à laquelle la boutique répond 404 ou 410, comme un produit retiré, termine la tâche avec
PAGE_UNAVAILABLE, et le message reprend la réponse de la boutique. Si la boutique refuse la lecture avec 403, 412, 429 ou 435, la tâche attend et redemande pendant 6 minutes au plus. Les autres lectures échouées, et un refus qui dure plus longtemps, se terminent parENGINE_NO_RESULT. - Seules les tâches terminées sont facturées : 0.5 crédit par recherche ou page produit.