Skip to main content
POST
cURL
When to use: Ideal for autocomplete, quick previews, or when you need fast AI-enriched results with a small result set. For larger result sets with customer profile personalization, use POST /v1/agentic-search.

Request

string
required
Your API key for authentication.

Request Body

string
required
Natural language search query for product discoveryExamples:
  • "sustainable midi dresses"
  • "luxury minimalist handbags"
  • "versatile blazers for work"
boolean
default:"true"
Enable AI-powered product attribute enrichment for enhanced product data analysis. Set to false for faster response times if detailed attributes are not needed.When to disable enrichment:
  • You need the fastest possible response times
  • You only need basic product information (title, price, URL)
  • You’re building a real-time autocomplete feature
When to enable enrichment (default):
  • You need detailed product attributes (color, material, features)
  • You’re building product comparison tools
  • You need rich product data for AI-powered recommendations

Response

array
Array of discovered products with enriched data (up to 10 results). Fewer products may be returned if some cannot be processed or lack detailed product data.
object
Search result metadata
cURL