Services
Knowledge Search
Semantic search over a persona's knowledge — the same retrieval the persona uses in conversation, as one stateless call. Build a search UI, power autocomplete, or feed retrieved context into your own pipeline. Each hit is the full typed record so you can render a product grid in a single call.
https://api.personaizer.com/v1/searchBody parameters
Search by image. Send the request as multipart/form-data with a payload_json part (the JSON body above) plus one image file — JPEG, PNG, GIF, or WebP, up to 5 MB. The image is analyzed into tags merged into your query ("find products like this photo"). query becomes optional when an image is attached. Same response shape. Use the file picker in the console, or:
curl -X POST "https://api.personaizer.com/v1/search" \
-H "X-Api-Key: $PERSONAIZER_API_KEY" \
-F 'payload_json={"mode":"smart","top_k":5};type=application/json' \
-F "image=@photo.jpg"Response
https://api.personaizer.com/v1/search{
"query": "waterproof trail running shoes",
"mode": "smart",
"top_k": 5
}Optional image — JPEG/PNG/GIF/WebP · ≤5 MB. Text is optional when an image is attached.
{
"num_total_results": 2,
"results": [
{
"id": "sku-002", "kind": "item",
"source": "my-shop.ge", "category": "footwear",
"title": "Red trail runners",
"description": "Lightweight trail shoe with a grippy outsole.",
"attributes": { "brand": "acme", "waterproof": true, "weight_kg": 0.5 },
"images": [{ "url": "https://cdn.example.com/red-runners.jpg", "is_primary": true }],
"links": [{ "url": "https://my-shop.ge/p/sku-002", "is_primary": true }],
"price": 109.99, "original_price": 129.99, "currency": "USD", "in_stock": true,
"score": 0.91,
"content": "Red trail runners, waterproof, 0.5 kg, $109.99."
},
{
"id": "sku-001", "kind": "item",
"source": "my-shop.ge", "category": "footwear",
"title": "Blue running shoes",
"price": 89.99, "currency": "USD", "in_stock": true,
"score": 0.74,
"content": "Blue running shoes, size 10, $89.99."
}
]
}