Bonne nouvelle : vous n’avez pas besoin de réécrire votre site pour offrir la recherche par image. L’API Visual Image Search est conçue pour s’interfacer avec n’importe quel catalogue existant, en trois étapes simples. Que vous soyez sur une solution e-commerce propriétaire, un PIM ou une marketplace personnalisée, l’intégration se fait sans friction. Voici comment procéder, de l’indexation à l’affichage des résultats, sans nécessiter d’équipe spécialisée en intelligence artificielle.
1. Indexez votre catalogue
La première étape consiste à envoyer vos produits à la plateforme. Chaque produit est décrit par une image, un identifiant et des attributs (catégorie, prix, couleur). L’ingestion peut se faire produit par produit via l’API REST, ou par lots pour les gros catalogues. À réception, chaque image est vectorisée puis stockée dans une collection dédiée à votre tenant. L’isolation multi-tenant garantit que vos données restent privées et invisibles des autres clients. Vous pouvez indexer quelques centaines de produits pour tester, puis plusieurs millions sans changer de méthode.
2. Recherchez par texte ou par image
Une fois le catalogue indexé, la recherche se fait par un simple appel HTTP. Deux modes sont disponibles : la recherche par texte, idéale pour la barre de recherche classique, et la recherche par image, qui accepte un fichier téléversé ou une URL. Les réponses renvoient une liste de produits classés par score de similarité, accompagnés de leurs attributs. Vous contrôlez le nombre de résultats, l’activation du re-ranking et le filtrage par catégorie.
POST /v1/search/text
{ "query": "sneakers blanches running", "top_k": 6 }
POST /v1/search/upload (multipart/form-data, file=...)3. Affichez les résultats dans votre interface
Côté front-end, vous récupérez une liste classée de produits avec leur score. À vous de les afficher dans votre grille existante, sous la forme d’un bloc « Produits similaires » ou d’une page de résultats dédiée. Le score de similarité peut servir à mettre en avant les meilleurs matches. La plupart de nos clients intègrent les résultats en moins d’une demi-journée de développement front-end, sans toucher au back-office existant. La cohérence visuelle avec votre charte reste totale, puisque vous restez maître du rendu.
Sécurisez votre clé API via un proxy
Bonne pratique essentielle : ne exposez jamais votre clé API côté navigateur. Mettez en place un petit proxy côté serveur qui ajoute l’en-tête d’authentification avant de transmettre la requête à Visual Image Search. Ainsi, la clé reste confidentielle et vous pouvez aussi y appliquer des contrôles : limitation de débit, journalisation, ou filtrage des requêtes abusives. Ce proxy peut être intégré à votre back-end existant en quelques lignes de code, quel que soit le langage utilisé.
Et côté performance ?
L’API est conçue pour la production : latence médiane inférieure à 100 millisecondes, scaling horizontal natif, et clés API par tenant avec quotas configurables. L’ingestion massive s’appuie sur des workers asynchrones qui ne bloquent jamais la recherche. Vous bénéficiez ainsi d’une expérience utilisateur fluide, même pendant la mise à jour du catalogue. Le plan gratuit offre 1 000 images et 1 000 recherches par mois, suffisant pour valider la pertinence sur votre catalogue réel.
Exemple de proxy en PHP
Pour sécuriser votre clé API, un proxy côté serveur est indispensable. En PHP, une dizaine de lignes suffisent : récupérez la requête entrante, ajoutez l’en-tête d’authentification avec votre clé secrète, transmettez l’appel à l’API Visual Image Search, puis renvoyez la réponse au navigateur. Ce proxy peut être exposé comme un endpoint de votre site, par exemple sous la forme d’une route REST. Il vous permet aussi d’ajouter une couche de contrôle : limitation de débit par adresse IP, journalisation des requêtes, ou filtrage des entrées. Cette approche garde la clé côté serveur et vous laisse maître de la politique d’usage, tout en restant simple à maintenre.
Gérer la mise à jour du catalogue
Votre catalogue évolue : nouveaux produits, prix modifiés, références retirées. La recherche visuelle doit suivre ces changements sans interruption. L’API propose des endpoints d’ingestion incrémentale : ajoutez un produit, mettez à jour ses attributs, ou supprimez-le de l’index. Pour les gros volumes, des workers asynchrones traitent les lots en arrière-plan sans impacter la recherche. Une bonne pratique consiste à synchroniser l’index avec votre PIM ou votre back-office via un webhook : chaque modification déclenche une mise à jour de l’index. Ainsi, la recherche reste toujours alignée avec votre catalogue réel, sans intervention manuelle.
Conclusion : passez à l’action
L’intégration de la recherche par image n’est plus un projet de plusieurs mois. Avec une API simple et une documentation claire, vous pouvez passer de l’idée à la production en une journée. Le plus simple pour démarrer est de tester la démo en direct, puis de créer un compte gratuit pour indexer un échantillon de votre catalogue et mesurer la pertinence sur vos propres produits.