Méthode products/search

Last modified: 6. juillet 2022

Récupération de la liste des produits / recherche de produits

Requête via /products/search suivie de paires clé/valeur décrivant le filtre de recherche.

  • Chaque clé ne peut être utilisée qu’une seule fois
  • l’ordre des couples clé/valeur n’a pas d’importance
  • la clé et la valeur sont séparées par un signe égal (« = »)
  • les paires clé/valeur sont séparées l’une de l’autre par des points-virgules (‘;’)
  • il existe des clés prédéfinies, d’autres entrées rendent l’URL invalide
  • dans la valeur, les caractères invalides de la requête HTML doivent être masqués, un espace par le code %20, un point (« # ») par le code « %23 », une barre oblique (« / ») par le code « %2F », et ainsi de suite
    • Remarque : si aucun produit n’est trouvé malgré le masquage, il se peut que les caractères % dans les codes masqués doivent être à nouveau codés explicitement avec %25 (double codage), par exemple %2F comme %252F
  • jusqu’à 50 valeurs peuvent être spécifiées pour une clé, séparées les unes des autres par une virgule (‘,’).

Clés des filtres de recherche

  • keywords : texte à recherche libre
    • Ne remplacez pas les espaces par +, mais par %20. Par exemple, une recherche pour Lenovo Thinkpad I5 correspond à Lenovo%20Thinkpad%20I5 et non à Lenovo+Thinkpad+I5
  • ean : un produit EAN
  • puid : ITscope ID
  • plzid : numéro de la source de référence
  • pid : ID interne d’ITscope
  • cnetid : numéro de produit 1WorldSync (anciennement CNET)
  • hstpid : numéro de fabricant, SKU (doit être utilisé avec le fabricant ou avec des mots clés pour réduire le nom du fabricant)
  • distpid : numéro de produit du distributeur
  • id : est interprété comme l’un des identifiants internes d’ITscope, avec une option de repli permettant de puid
  • manufacturer (MAN) : l’identifiant unique du fabricant
  • producttype (SET) : l’identifiant unique de la catégorie de produits
  • distributor (PRL) : l’identifiant unique du fournisseur
  • cluster (CLU) : l’identifiant unique du groupe de biens


La liste qui en résulte peut être vide, contenir exactement un produit ou plusieurs jusqu’à 50.

Paramètre de recherche page

Avec le paramètre « page », il est possible de demander les 50 produits suivants si le résultat de la recherche est > 50 produits.

ex : page=3, signifie me montrer les produits 101 à 150.

https://api.itscope.com/2.1/products/search/hstpid=MZ-75E250B%252FEU;manufacturer=1015/standard.xml?page=3

Il n’y a pas d’indication dans la première requête sur le nombre de produits trouvés, c’est-à-dire que vous devez travailler avec page=xx jusqu’à ce qu’il n’y ait plus de produits pour atteindre la fin de la liste.

Paramètre de recherche item

Avec le paramètre « item », il est possible d’obtenir exactement le x-ième enregistrement de données dans un résultat de recherche.

Par exemple : avec page=2, item=3, on reçoit d’une liste de par exemple 90 produits, exactement le 3ème enregistrement sur la 2ème page. Avec 50 ensembles de données par page, ce serait alors l’ensemble de 53 données de l’exemple.

https://api.itscope.com/2.1/products/search/hstpid=MZ-75E250B%252FEU;manufacturer=1015/standard.xml?page=2&item=3

Le numéro d’article ne peut être compris qu’entre 1 et 50, c’est-à-dire que le numéro d’article ne dépend pas du paramètre de page.

Paramètre de recherche plzproducts

Ce paramètre de recherche peut également être utilisé pour trouver et afficher la liste des prix des produits de la gamme. Ces produits ont l’extension 999 dans la plate-forme en ligne ITscope. Ce paramètre est faux par défaut, c’est-à-dire non défini.

Paramètre de recherche realtime

Ce paramètre d’interrogation est utilisé pour effectuer des interrogations en temps réel sur tous les prix des fournisseurs respectifs. La condition préalable à une requête en temps réel est la mise en place réussie d’un service électronique en temps réel chez le fournisseur concerné.

Pour des raisons de charge, comme celles-ci sont transmises directement à l’interface du fournisseur, les appels de prix en temps réel ne peuvent être utilisés que pour les demandes d’identification de produits avec les clés suivantes : ean, puid, plzid, pid, cnetid, hstpid, distpid, id avec un maximum de 10 ID au total.

Les appels de prix en temps réel peuvent également prendre jusqu’à 5 secondes, car ils sont transmis directement à l’interface du fournisseur et on attend jusqu’à 5 secondes la réponse du fournisseur. C’est-à-dire qu’il peut aussi arriver qu’aucun prix en temps réel ne puisse être chargé si la limite de 5 secondes est dépassée. Ensuite, le prix de la liste des prix individuels ou le prix standard est renvoyé.

Paramètre de recherche sort

La recherche de produits peut être triée selon certains critères.

Voici une liste de critères de tri et leur signification :

  • DEFAULT : par ordre décroissant de pertinence, s’il n’y a pas de pertinence, alors IRANK analogique
  • PRICE_ASC : par ordre croissant de prix
  • PRICE_DESC : dans l’ordre décroissant du prix
  • SOURCES_COUNT : par nombre de sources en ordre décroissant
  • STOCK : par ordre décroissant de stock
  • MANUFAKTURER_SKU : par numéro d’article du fabricant en ordre décroissant
  • NAME_ASC : par nom de produit en ordre croissant
  • NAME_DESC : par nom de produit en ordre décroissant
  • QUAL : dans l’ordre décroissant de qualification du produit
  • TOPSELLER : par Top Product Rank (clics des 4 dernières semaines) en ordre décroissant
  • EXACT : par nombre exact d’occurrences du ProductId en ordre décroissant
  • IRANK : par rang de popularité générale décroissant, voir le champ de rang (rank) dans les descriptions de format des produits.

Paramètre de recherche pour la restriction par période de la date d’entrée du produit


Les paramètres de demande correspondants ne sont disponibles qu’à partir de l’API 2.1. Le filtre de paramètres sur le champ d’exportation entryDate au produit, voir les descriptions de format pour les produits . La date d’entrée indique la date à laquelle le produit a été ajouté au catalogue ITscope et non la date de sa dernière modification. Il n’est donc pas possible de rechercher des produits modifiés en utilisant ces paramètres.

  • productEntryFrom : l’heure de début de la restriction de la période de la date d’entrée du produit dans le format aaaa-MM-jj. Seulement si ce paramètre est défini, les produits seront filtrés par la période de la date d’entrée. L’heure est toujours 00:00:00
  • productEntryTo : l’heure de fin de la période de restriction de la date d’entrée du produit dans le format aaaa-MM-jj. Si aucune valeur n’est transmise, la valeur par défaut est la date du jour. L’heure est toujours 00:00:00. La valeur ne doit pas être inférieure à celle du produitEntryFrom.

Paramètres de recherche pour les données historiques

Les données historiques et les paramètres de demande correspondants ne sont disponibles qu’à partir de l’API 2.1.

Exemples – demandes groupées jusqu’à 50 pièces


Recherchez un ensemble de ProductIds ITscope :

https://api.itscope.com/2.1/products/search/puid=3534638001,2069677000,2650828000,4201083000/standard.xml

Dans cet exemple, les ITscope ProductIds suivants sont recherchés : 3534638001, 2069677000, 2650828000, 4201083000. 50 ITscope ProductIds peuvent être spécifiés dans une requête.


Recherchez une série de EAN :

https://api.itscope.com/2.1/products/search/ean=5032037044288,7636490025914,8806086522977/standard.xml

Dans cet exemple, les valeurs suivantes sont recherchées : 5032037044288, 7636490025914, 8806086522977. 50 valeurs peuvent être spécifiées dans une demande.


Recherchez une série de numéros de produit du fabricant :

https://api.itscope.com/2.1/products/search/hstpid=0553C001AA,N9J71AE%23301,CLT-P406B%2FELS/standard.xml

Dans cet exemple, les numéros de produits du fabricant suivants sont recherchés : 0553C001AA, N9J71AE#301, CLT-P406B/ELS. Jusqu’à 50 numéros de produit du fabricant peuvent être spécifiés dans une demande.

Attention : si aucun produit n’est trouvé malgré le masquage, les caractères % dans les codes masqués peuvent devoir être explicitement codés à nouveau avec %25 (double codage),

par exemple, le caractère # comme %23 -> %2523, ou le caractère / comme %2F -> %252F

Exemples – combinaisons de filtres

Recherchez tous les produits qui correspondent à un fabricant et à son numéro de produit :

par exemple : fabricant Samsung ( Id:1015 peut être déterminé via l’appel API du fabricant) et numéro d’article du fabricant MZ-75E250B/EU :

https://api.itscope.com/2.1/products/search/hstpid=MZ-75E250B%252FEU;manufacturer=1015/standard.xml

Dans cet exemple avec le numéro de produit du fabricant « MZ-75E250B/EU », le caractère / a également été masqué par « %2F », car le caractère / dans l’URL a une signification particulière et ne peut être transmis sans être masqué.

Attention : si aucun produit n’est trouvé malgré le masquage, les caractères % dans les codes masqués peuvent devoir être explicitement codés à nouveau avec %25 (double codage), par exemple %2F comme %252F


Recherchez tous les produits qui correspondent à un numéro de produit du fabricant : https://api.itscope.com/2.1/products/search/hstpid=A7E34AA%2523ABB/standard.xml

Dans cet exemple avec le numéro d’article du fabricant A7E34AA#ABB, le caractère # a également été masqué par « %23 », car le caractère # dans l’URL a une signification particulière et ne peut être transmis sans être masqué.

Attention : si aucun produit n’est trouvé malgré le masquage, les caractères % dans les codes masqués peuvent devoir être explicitement codés à nouveau avec %25 (double codage), par exemple %23 comme %2523


Recherchez tous les produits correspondant à une catégorie, un fabricant et des groupes de biens spécifiques : https://api.itscope.com/2.1/products/search/producttype=114;manufacturer=1032;cluster=2404144;cluster=1061/standard.xml

Dans cet exemple, les produits sont recherchés dans la catégorie disques durs (producttype=114), chez le fabricant Seagate (manufacturer=1032) et les grappes de propriétés taille 2,5″ (cluster=1061) et capacité de stockage 4TB (cluster=2404144).

Les ID ITscope des fabricants peuvent être chargés via l’API de métadonnées des fabricants.

Les ID ITscope de la catégorie peuvent être chargés via l’API des métadonnées de la catégorie.

Les ID ITscope des groupes de biens peuvent être chargés via une demande d’exportation ou de produit avec l’autorisation correspondante. Cependant, seuls les groupes de propriétés qui correspondent aux produits dans le résultat de la demande sont produits. Il n’y a actuellement aucune possibilité d’obtenir une liste complète des groupes de biens via l’API.

Recherchez tous les produits qui correspondent à une catégorie, un fabricant et une période de date d’entrée spécifique :

https://api.itscope.com/2.1/products/search/producttype=114;manufacturer=1032/standard.xml?productEntryFrom=2019-11-01

Dans cet exemple, les produits sont recherchés, dans la catégorie disques durs (producttype=114), chez le fabricant Seagate (manufacturer=1032) et la date d’entrée entre le 11/01/2019 et l’heure actuelle de la demande.

https://api.itscope.com/2.1/products/search/producttype=114;manufacturer=1032/standard.xml?productEntryFrom=2019-11-01&productEntryTo=2019-12-01

Dans cet exemple, les produits sont recherchés, dans la catégorie disques durs (producttype=114), auprès du fabricant Seagate (manufacturer=1032) et la date d’entrée se situe entre le 01.11.2019T00:00:00 et le 01.12.2019T00:00:00.

Les ID ITscope des fabricants peuvent être chargés via l’API de métadonnées des fabricants.

Les ID ITscope de la catégorie peuvent être chargés via l’API des métadonnées de la catégorie.

Exemples – recherche en texte libre

Appeler une recherche de texte libre : https://api.itscope.com/2.1/products/search/keywords=lenovo%20thinkpad%20i5/standard.xml
Dans l’exemple donné, la recherche porte sur le Lenovo Thinkpad I5.


Combinez une recherche par catégorie avec une recherche en texte libre : https://api.itscope.com/2.1/products/search/producttype=114;keywords=SATA-600/standard.xml
La combinaison des filtres fournit l’intersection des différents filtres. Dans l’exemple ci-dessus, seuls les disques durs dotés d’une interface SATA-600 sont recherchés.

Was this article helpful?
Dislike 0
Views: 68