> ## 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 API used by Search by Depict to serve search results.

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

```
https://api.depict.ai
```

## 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](https://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](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` 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.