Searches

What visitors type into the storefront search box — every query by day, with whether results came back and which search surface it hit, as Shopify records it. Requires the read_reports scope; empty on stores that have not granted it.

11 fields — 10 dimensions, 1 metrics. Date clauses (SINCE, UNTIL, DURING) use day.

The live, authoritative list is always GET /v1/datasets — this page is regenerated from the same catalog, but the endpoint reflects exactly what is deployed.

Query it

FROM searches
  SHOW searches
  GROUP BY grain
  SINCE -30d

See Querying with SoloQL for the language.

This dataset is queryable through SoloQL; it has no record-retrieval endpoint.

Fields

Field	Type	Role	Description
grain	string	dimension	Which aggregation the row was fetched at. Only day_query exists today.
search_query	string	dimension	The raw text a visitor typed into the storefront search box, verbatim.
search_query_intent	string	dimension	Shopify's intent reading of the query. On the probed store it echoes the raw query — stored verbatim, never interpreted.
search_results_were_returned	boolean	dimension	Whether the search produced any results.
is_product_search_query	boolean	dimension	Whether the query ran against product search.
is_article_search_query	boolean	dimension	Whether the query ran against article search.
is_page_search_query	boolean	dimension	Whether the query ran against page search.
searches	number	metric	Number of storefront searches. Additive — proven by re-aggregation against Shopify's own totals — so any window and any grouping is a plain sum.
store	string	dimension	The shop the record belongs to. Filter with WHERE store IN ('Shop name') or GROUP BY store.
store_id	string	dimension	The shop's raw identifier — what an export or the API reports. Same shops as Store, shown as ids.
store_domain	string	dimension	The shop's myshopify.com domain. Filter with WHERE store_domain = 'shop.myshopify.com'.