Recherche sémantique produit (texte / image / produit-amorce)

POST

https://core.shopimind.com/v1/search

Recherche par embedding : q (texte), imageUrl ou upload image (visuel, cross-modal), ou productId (« plus comme ça », vecteur stocké). type=products au MVP. q/image nécessitent le provider d'embedding configuré (sinon 503) ; productId fonctionne sans.

Parameters

Header Parameters

spm-api-key*

[Authentication] Required API key.

Type

string

Required

Pattern

"^[a-zA-Z0-9-]{20,64}$"

Request Body

{

  

"q": "robe rouge en lin",

  

"imageUrl": "https://cdn.exemple.com/img/123.jpg",

  

"productId": 1234,

  

"type": "products",

  

"exclude": {

  

  

"products": [

  

  

  

0

  

  

]

  

},

  

"limit": 12,

  

"lang": "fr",

  

"fields": [

  

  

[

  

  

  

"id",

  

  

  

"name",

  

  

  

"price",

  

  

  

"image",

  

  

  

"url"

  

  

]

  

]

}

Responses

Produits classés par similarité + mode + meta.

POST

https://core.shopimind.com/v1/search

Playground

Headers

spm-api-key*

Body

Samples

Recherche sémantique produit (texte / image / produit-amorce) Recherche par embedding : q (texte), imageUrl ou upload image (visuel, cross-modal), ou productId (« plus comme ça », vecteur stocké). type=products au MVP. q/image nécessitent le provider d'embedding configuré (sinon 503) ; productId fonctionne sans. POST /v1/search SearchController_search Search spm-api-key [Authentication] Required API key. Produits classés par similarité + mode + meta.