---
title: "The brand's store on Shop (shop.com, Shopify's shopping app), as read from its public store page: the store's Shop ratings and reviews, the social and contact links it declares, its business address and retail locations, its top products in Shop's best-seller order with price, compare-at price and rating, and the brand kit the store publishes (colours, and logo, avatar, cover and wordmark copied to our CDN). The rank is a position, never a sales number; emails and phone numbers are not served. A brand with no linked store answers status not_collected."
method: GET
path: "/v1/brands/{brandId}/shop"
tags: ["brands"]
---

# The brand's store on Shop (shop.com, Shopify's shopping app), as read from its public store page: the store's Shop ratings and reviews, the social and contact links it declares, its business address and retail locations, its top products in Shop's best-seller order with price, compare-at price and rating, and the brand kit the store publishes (colours, and logo, avatar, cover and wordmark copied to our CDN). The rank is a position, never a sales number; emails and phone numbers are not served. A brand with no linked store answers status not_collected.

`GET /v1/brands/{brandId}/shop`

## Request

- Base URL: `https://api.storequant.com`
- URL: `https://api.storequant.com/v1/brands/{brandId}/shop`
- Auth: HTTP bearer

The brand's store on Shop (shop.com, Shopify's shopping app), as read from its public store page: the store's Shop ratings and reviews, the social and contact links it declares, its business address and retail locations, its top products in Shop's best-seller order with price, compare-at price and rating, and the brand kit the store publishes (colours, and logo, avatar, cover and wordmark copied to our CDN). The rank is a position, never a sales number; emails and phone numbers are not served. A brand with no linked store answers status not_collected. Scope `brands:read`; cache `daily`.

## Path parameters

- `brandId` union, required
  - string, uuid
  - string

## Query parameters

- `max_products` integer

## Response `200`

Success.

- object
  - `data` union, required
    - object
      - `status` 'collected', required
      - `brand_id` string, uuid, required
      - `stores` object[], required
        - `shopify_id` string, required
        - `handle` string, required
        - `name` string, required
        - `store_url` string, required
        - `website_url` string, required
        - `myshopify_domain` string, required
        - `logo_url` string, nullable, required
        - `description` string, nullable, required
        - `linked_by` string, required
        - `average_rating` number, nullable, required
        - `total_ratings` integer, nullable, required
        - `total_reviews` integer, nullable, required
        - `address_lines` string[], required
        - `business_country` string, nullable, required
        - `contacts` object[], required
          - `method` string, required
          - `target` string, required
        - `retail_locations_min` integer, required
        - `products_read` integer, required
        - `products` object[], required
          - `product_id` string, required
          - `title` string, required
          - `url` string, required
          - `image_url` string, nullable, required
          - `price` number, nullable, required
          - `compare_at_price` number, nullable, required
          - `currency` string, required
          - `average_rating` number, nullable, required
          - `rating_count` integer, nullable, required
          - `best_seller_rank` integer, nullable, required
        - `read_at` string, date-time, required
      - `kit` object, nullable, required
        - `colors` object, required
          - `primary` string
          - `secondary` string
          - `secondary_text` string
          - `logo_average` string
          - `logo_dominant` string
          - `cover_dominant` string
        - `logo_url` string, nullable, required
        - `avatar_url` string, nullable, required
        - `cover_url` string, nullable, required
        - `wordmark_url` string, nullable, required
        - `observed_at` string, date-time, required
      - `as_of` string, date-time, required
    - object
      - `status` 'not_collected', required
      - `brand_id` string, uuid, required
      - `reason` 'no_linked_store' | 'store_not_read', required
  - `meta` object, required
    - `request_id` string, required
    - `as_of` string, date-time, required
    - `lag_hours` number
    - `cursor` string
    - `count` integer

## Other responses

- `4XX`: The one error shape.
- `5XX`: The one error shape.

---

[API](https://skmtc.dev/scrollstash/apis/storequant-api.md) · [All operations](https://skmtc.dev/scrollstash/apis/storequant-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrollstash/apis/storequant-api/revisions/4d67a114a13c?raw)