Passer au contenu principal
Recherchez des produits sur la boutique eBay (ebay.com) via l’API de tâches asynchrones. Envoyez COMMERCE_SERP avec site ebay pour recevoir les produits qu’affiche une recherche, dans l’ordre de la boutique. COMMERCE_PRODUCT ne lit pas les pages produit de cette boutique. Une recherche terminée coûte 0.5 crédit.

Recherche

Soumettez la tâche, puis interrogez GET /v1/async/task/{id} ou recevez son webhook. Voir Tâches asynchrones.

Paramètres

  • site : obligatoire. ebay.
  • query : obligatoire. Terme de recherche, de 1 à 500 caractères.
  • limit : entier facultatif de 1 à 40, avec 20 par défaut.
  • country : facultatif. Par défaut, US, le pays de la boutique. Tout autre pays est refusé avec 422 REGION_UNSUPPORTED.
Seuls les champs de payload listés ci-dessus sont acceptés. Omettez 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, query et country reprennent la requête. returnedCount est le nombre d’éléments de products.
  • Chaque produit comporte rank, productId, title et url. productId est le numéro d’objet eBay. rank suit l’ordre par défaut de la boutique, et les annonces que la boutique marque comme sponsorisées sont exclues.
  • price, rating, reviewCount et imageUrl apparaissent quand la page de résultats les affiche. price est un nombre dans la currency du produit (ISO 4217) ; quand les formats ont des prix différents, c’est le plus bas.
  • rating utilise 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.

Erreurs et facturation

  • Une recherche qui ne renvoie aucun produit se termine par une tâche en échec.
  • Seules les recherches terminées sont facturées, 0.5 crédit chacune.

Voir aussi