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

# Search (image) dataset

> LayersQL Search (image) dataset reference for analyzing image search queries, uploaded image IDs, click-through rates, and conversions over time.

* **Label:** Search (Image)
* **Description:** Image search analytics.
* **Default group key:** `image_hash`

## Metrics

* **requests (requests)**
  * Number of image search requests.
  * Example: COUNT\_DISTINCT(requests)
* **results\_count (results)**
  * Results returned per search request.
  * Example: AVG(results\_count)
* **total\_sales (USD)**
  * Sales attributed to image search.
  * Example: SUM(total\_sales)
* **quantity\_purchased (items)**
  * Number of items purchased from image search traffic.
  * Example: SUM(quantity\_purchased)
* **view\_sessions (sessions)**
  * Sessions where a product was viewed from image search results.
* **cart\_sessions (sessions)**
  * Sessions where a product from image search results was added to cart.
* **quantity\_added\_to\_cart (items)**
  * Items added to cart from image search results.

## Dimensions

* **image\_hash:** Hashed representation of the image query.
* **num\_results:** Number of results returned.
* **shopping\_channel:** The shopping channel (e.g., online\_store).
* **billable:** Whether this request is counted for billing.
* **attribution\_token:** Token used to attribute downstream events/purchases.
* **experiment\_id:** Experiment identifier.
* **experiment\_group:** Experiment group/variant.
* **device:** Device category.
* **os:** Operating system.
* **geo\_country:** Two-letter country code.
* **geo\_state:** Up to three-letter province code.
* **geo\_city:** City name as captured.
* **marketing\_source:** UTM source.
* **marketing\_medium:** UTM medium.
* **marketing\_campaign:** UTM campaign.

## Examples

Image search requests by country (last 7 days)

```sql theme={null}
FROM search_image
SHOW COUNT_DISTINCT(requests)
GROUP BY geo_country
SINCE -7d
```

Image search conversion by device (this month)

```sql theme={null}
FROM search_image
SHOW SUM(total_sales)
GROUP BY device
SINCE this_month
```

## Next steps

* [LayersQL syntax](/platform/layersql/syntax)
* [LayersQL functions](/platform/layersql/functions)
* [Datasets overview](/platform/layersql/datasets)