Search

👍

Dynamic Yield new Experience Search is coming soon!

We’re making product discovery smarter, more intuitive, and effortless with API-based, AI-assisted text, image, and conversational product search.

For the request structure and examples, see the API Reference.

The Search API enables seamless personalized search and discovery experiences. It's similar to the Choose API, however, some objects are structured a bit differently (see the API reference for details). The main distinction of the Search endpoint lies in its use of the query object, which is crucial for executing searches or starting conversations.

The Search API supports these search and discovery solutions:

• Semantic Search: A native AI-powered, multi-modal search solution that uses both image and text embedding to deliver highly relevant search results for natural language queries.
• Visual Search: An image-based search solution that enables users to search using images and retrieve visually similar or relevant products.
• Shopping Muse: An AI-powered conversational search and recommendation solution that enables users to request information and receive personalized recommendations and search results, including expert advice.

Query object fields

Required

Note: Either imageBase64 or text must be provided, but not both in the same request.

Optional

Visual Search Example

{
  "query": {
    "imageBase64": "bGlnaHQgd29yay4=...",
    "filters": [],
    "sortBy": {}
  },
}

Semantic Search Example

{
  "query": {
    "text": "<query>",
    "filters": [],
    "pagination": {},
    "sortBy": {}
  },
}

Shopping Muse Example

{ 
  "query": { 
    "text": "<query>", 
    "chatId": "gAAAAABn85XBEaWKxRxEABWj2P2E8VecQcjXv8qvaZEOs..." 
  }, 
}