---
title: "List shopping results (Scale+)"
method: GET
path: "/dimensions/shopping"
tags: ["Shopping & Ads"]
---

# List shopping results (Scale+)

`GET /dimensions/shopping`

Product cards returned inside AI answers. view=products (default) returns one row per distinct product with appearance count, price range, rating and whether it is yours; view=merchants returns one row per selling merchant. Every response also carries a totals block matching the KPI cards in the app.

## Query parameters

- `project_id` integer, required
- `page` integer
- `per_page` integer
- `view` 'products' | 'merchants'
- `owned` boolean
- `order` 'appearances' | 'price' | 'rating' | 'title' | 'products' | 'avg_price' | 'avg_rating' | 'merchant'
- `direction` 'asc' | 'desc'
- `query` string
- `model` 'chatgpt' | 'perplexity' | 'gemini' | 'ai_overview' | 'ai_mode' | 'copilot' | 'claude' | 'grok' | 'deepseek' | 'meta_ai' | 'amazon_rufus'
- `collection_id` integer
- `country_code` string
- `language_code` string
- `prompt` integer
- `prompt_type` 'informational' | 'navigational' | 'commercial' | 'transactional'
- `brand_kind` 'brand' | 'brand_other' | 'non_brand'
- `range` integer
- `from` string, date-time
- `to` string, date-time
- `output` 'flat' | 'csv'

## Response `200`

Paginated shopping rows plus totals

## Other responses

- `422` — Invalid parameters

## Changes

- **2026-08-13** `f6e9e41992e1` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/llmpulse/apis/llm-pulse-api/changes/dimensions/shopping/get.md)

---

[API](https://skmtc.dev/llmpulse/apis/llm-pulse-api.md) · [All operations](https://skmtc.dev/llmpulse/apis/llm-pulse-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/llmpulse/llm-pulse-api/revisions/b1f6040a24b9/schema)