Skip to main content
Search by Depict is powered by the same public Storefront API that all Depict integrations use. In a standard app installation you never call it yourself — the app’s search button block and modal script do it for you — but the reference is useful when:
  • you build custom theme sections that fetch recommendations or search results directly,
  • you send additional tracking events (add-to-cart, purchases) from custom checkout or cart code,
  • you debug what the app requests from your store.

​
Base URL

​
Identifying your store

Every request identifies your store with a merchant identifier and a market. You’ll find both in the Depict portal at app.depict.ai — your merchant id is the URL path segment after /v2, and your market ids appear in the market filters — or you can ask support.

​
Tracking

Interaction tracking (impressions, clicks, add-to-carts, purchases) is what powers the analytics you see in the Depict portal. The events endpoints accept batched events; the app’s frontend script sends most of them automatically, so only add custom calls for surfaces the app cannot see, such as a headless checkout.