Skip to main content
Search by Depict serves search results from Depict’s storefront search API at runway.depict.ai. 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 storefront code that fetches search results or query suggestions 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.
The endpoint-by-endpoint reference lives in the custom search UI docs.

​
Base URL

​
Identifying your store

Every request identifies your store with a merchant_id, a locale and a country. On a Shopify store running the Depict app, your merchant id is search- followed by your Shopify shop ID. The quickstart explains all three values, 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 endpoint accepts 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.