> ## Documentation Index
> Fetch the complete documentation index at: https://docs.depict.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API Overview

> The storefront search API used by Search by Depict to serve search results.

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](/shopify-search/custom-search-ui/api-reference).

## Base URL

```
https://runway.depict.ai
```

## 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](/shopify-search/custom-search-ui/quickstart) explains all three
values, or you can ask [support](mailto:hello@depict.ai).

## 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.