L’Open API de RizzitGO ajoute la recherche par mot-clé : ce qui change en septembre 2026

Le journal des versions de l’Open API indique que la version 2.10 a introduit POST /open-api/goods/search dans le périmètre goods:search:read. Une requête contient un mot-clé, un numéro de page et un code source, ainsi qu’une valeur de tri facultative. Les états documentés sont la pertinence, le prix décroissant, le prix croissant et les ventes décroissantes.

Il s’agit d’une API partenaire protégée par des identifiants OAuth2, une isolation entre locataires et des périmètres accordés. Elle ne doit pas être présentée comme un flux public anonyme ni comme la preuve que toutes les interfaces RizzitGO offrent les mêmes commandes. L’affirmation fiable est que les applications partenaires autorisées peuvent demander des résultats structurés par mot-clé via l’endpoint documenté.

Le modèle de réponse comprend l’identifiant du produit, le titre, l’URL de détail, l’image principale, la source, le prix, le prix d’origine, le nombre de ventes et les champs de remise. La pagination ajoute la page actuelle, sa taille, le total des pages et le nombre total de résultats. Ces champs donnent à un index assez de structure pour regrouper et comparer les résultats sans réduire chaque ligne à une URL de marketplace.

Le champ de source est particulièrement important. L’endpoint documente Taobao, 1688, Weidian et Xianyu comme sources distinctes. Un article d’apparence similaire peut donc provenir de marketplaces, vendeurs ou annonces différents. Un index responsable conserve ce contexte au lieu de présenter des résultats visuellement proches comme un seul produit vérifié.

Les tableurs partagés sont faciles à diffuser, mais leurs lignes vieillissent rapidement. Un endpoint structuré permet à une intégration autorisée d’actualiser titres, images et prix tout en conservant une interface de recherche. Il rend aussi la date de capture plus importante : dès qu’un résultat est copié dans un répertoire indépendant, cette copie peut diverger de sa source.

Les nombres de produits doivent donc être considérés comme des mesures datées, non comme des affirmations permanentes. Un index peut supprimer les doublons, exclure les fiches incomplètes ou actualiser une annonce modifiée et afficher légitimement un total différent d’un autre répertoire utilisant une autre heure de collecte ou une autre normalisation.

L’endpoint ne renvoie pas un catalogue illimité en une seule réponse. Son modèle indique la page actuelle, la quantité renvoyée, le total des pages et le total des résultats. Une application souhaitant une couverture plus large doit continuer à demander les pages et décider quoi faire si une page ultérieure change pendant la collecte.

La recherche d’un marketplace n’est pas une exportation figée : de nouvelles annonces peuvent apparaître, les prix changer et le classement évoluer pendant la collecte. Si plusieurs pages sont actualisées à des moments différents, le répertoire final peut mélanger plusieurs instants, sauf si l’éditeur consigne une fenêtre de collecte claire et répète les pages échouées de manière cohérente.

La pagination explique aussi pourquoi un total mis en avant peut différer du nombre de cartes visibles. Le total API décrit la réponse de la source pour cette requête ; l’index publié peut n’afficher que les fiches qui satisfont ses contrôles d’image, titre, catégorie et doublons.

Les quatre modes répondent à des questions différentes. La pertinence ordonne autour des mots saisis, le prix réorganise la recherche selon un champ numérique et les ventes mettent en avant la valeur du marketplace source. Aucun n’est décrit comme un classement de qualité, d’authenticité ou de fiabilité.

Cette distinction se perd facilement sur un site de tableur. Une ligne en tête peut sembler recommandée simplement parce qu’elle est visible. Un répertoire transparent doit indiquer si l’ordre vient de la source, du tri choisi ou de ses propres règles, au lieu d’appeler le premier résultat la meilleure trouvaille.

L’historique des versions sert le même objectif. Il précise quand la recherche par mot-clé a intégré l’API partenaire, sans affirmer que tous les anciens tableurs ont été reconstruits ni que toutes les interfaces publiques ont changé à cette date.

La réponse de recherche n’authentifie pas les produits, ne garantit pas le stock et ne certifie pas la qualité livrée. La documentation indique aussi que l’état des collections propre à chaque membre et les liens de partage personnalisés ne sont pas renvoyés. Les champs publics facilitent la découverte, mais ne remplacent ni la fiche actuelle, ni les conditions du vendeur, ni les preuves d’entrepôt.

Ce moteur indépendant utilise sa propre capture enregistrée du catalogue ; il n’est pas connecté à l’Open API RizzitGO. La documentation est analysée ici comme source primaire du modèle publié par la plateforme, et non parce que les deux ensembles de données seraient interchangeables.