---
title: "Search product templates grouped by product family by page"
method: GET
path: "/open-api/v1.0/product-templates/search-grouped/{query}/page/{page}"
tags: ["Product Templates"]
---

# Search product templates grouped by product family by page

`GET /open-api/v1.0/product-templates/search-grouped/{query}/page/{page}`

## Request

- Base URL: `https://api.fourthwall.com`
- URL: `https://api.fourthwall.com/open-api/v1.0/product-templates/search-grouped/{query}/page/{page}`
- Auth: none declared

Search product templates grouped by product family with pagination. This endpoint is public and does not require authentication.

## Path parameters

- `query` string, required
- `page` integer, required

## Response `200`

OK

- ComFourthwallOpenapiModelProductTemplateGroupedListV1: Paginated list of grouped product templates
  - `results` ComFourthwallOpenapiModelProductTemplateGroupedSummaryV1[], required: List of grouped product template summaries
    - `productId` string, required: Product template ID of the recommended variant
    - `name` string, required: Product name
    - `category` string, required: Product category path
    - `brand` string, required: Brand name
    - `thumbnail` string: Thumbnail image URL
    - `basePrice` ComFourthwallOpenapiModelMoneyV1, required: Money amount with currency
      - `amount` number, required: Amount value
      - `currency` string, required: Currency code (ISO 4217)
    - `variants` ComFourthwallOpenapiModelProductTemplateVariantV1[], required: Available production method variants for this product family
      - `productId` string, required: Product template ID for this variant
      - `productionMethod` string, required: Production method (e.g. DTG, EMBROIDERY, DTFX)
      - `recommended` boolean, required: Whether this is the recommended production method
      - `basePrice` ComFourthwallOpenapiModelMoneyV1, required: Money amount with currency
        - `amount` number, required: Amount value
        - `currency` string, required: Currency code (ISO 4217)
      - `supportsBackendRendering` boolean, required: Whether this variant can be rendered by the backend rendering pipeline (V3 Instant Designer, excluding KNITWISE).
    - `supportsBackendRendering` boolean, required: Whether the recommended product in this group can be rendered by the backend rendering pipeline (V3 Instant Designer, excluding KNITWISE). Individual production-method variants may differ — check `variants[].supportsBackendRendering`.
  - `total` integer, required: Total number of grouped product templates matching the query

## Changes

- **2026-07-26** `ef273312f051`: 1 info
  - removed the non-success response with the status `429`
- **2026-07-21** `d02dd5a76313`: 1 info
  - added the non-success response with the status `429`

[Operation history](https://skmtc.dev/fourthwall/apis/fourthwall-apis-2/changes/open-api/v1.0/product-templates/search-grouped/:query/page/:page/get.md)

---

[API](https://skmtc.dev/fourthwall/apis/fourthwall-apis-2.md) - [All operations](https://skmtc.dev/fourthwall/apis/fourthwall-apis-2/llms.txt) - [OpenAPI document](https://skmtc.dev/fourthwall/apis/fourthwall-apis-2/revisions/77de1061d5c9?raw)