A valid request URL is required to generate request examples[
{
"impressions": 123,
"clicked_impressions": 123,
"clicks": 123,
"ctr": 123,
"attributed_add_to_carts": 123,
"attributed_orders": 123,
"attributed_revenue": 123,
"currency": "<string>",
"revenue_currencies": [
"<string>"
],
"aov": 123,
"atc_rate": 123,
"purchase_rate": 123,
"date": "2026-09-01"
}
]{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Recommendation performance per day
Returns the same figures as the totals route, one point per day of [from_date, to_date], optionally narrowed to one surface. Call it for trends and sparklines. Counts come from storefront events attributed to recommendation carousels; money figures use the shared Depict attribution rule. Read-only; answers from Tinybird analytics.
A valid request URL is required to generate request examples[
{
"impressions": 123,
"clicked_impressions": 123,
"clicks": 123,
"ctr": 123,
"attributed_add_to_carts": 123,
"attributed_orders": 123,
"attributed_revenue": 123,
"currency": "<string>",
"revenue_currencies": [
"<string>"
],
"aov": 123,
"atc_rate": 123,
"purchase_rate": 123,
"date": "2026-09-01"
}
]{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Authorizations
Shopify App Bridge session token of the embedded Depict: Search & Merchandising app. The shop in the token determines the merchant; merchant_id parameters must belong to that shop.
Query Parameters
Lite merchant id, e.g. shopify-<shop id>.
First day, inclusive (UTC).
^\d{4}-\d{2}-\d{2}$"2026-09-01"
Last day, inclusive (UTC).
^\d{4}-\d{2}-\d{2}$"2026-09-01"
Restricts to one Shopify market (its market group's members); absent or empty = every market.
Converts the money figures into this currency (the shop's base currency); absent = as summed, null when mixed.
^[A-Z]{3}$Narrows to one surface (its id, not its name); absent = every surface.
Response
The daily points.
Carousels shown (distinct request ids); null where the storefront does not track impressions.
Carousels with at least one click; null whenever impressions is.
Product clicks in carousels.
clicked_impressions / impressions.
In currency; null when the window mixes currencies and no currency was asked for.
Every currency the window's orders were placed in.
attributed_revenue / attributed_orders.
attributed_add_to_carts / clicks.
attributed_orders / clicks.
^\d{4}-\d{2}-\d{2}$"2026-09-01"
Was this page helpful?