Sign in

v2

latestOpenAPI 3.1.02026-07-26102336742.6 KB
Product Templates

Search product templates grouped by product family

Search product templates and group results by product family (libraryId). Products sharing the same physical item but with different production methods (e.g. DTG, Embroidery, DTFX) are collapsed into a single result with a variants list. Returns 25 grouped results. To paginate, use the /search-grouped/{query}/page/{N} variant (1-indexed). Pagination is path-based for HTTP cacheability.

get/open-api/v1.0/product-templates/search-grouped/{query}

Path parameters

querystring required

Search query (e.g., 'hoodie', 'black%20t-shirt')

Response

OK

totalinteger required

Total number of grouped product templates matching the query

Example response

{
  "results": [
    {
      "productId": "pro_k66ZW4fsRm6c2def3itltA",
      "name": "Classic T-Shirt",
      "category": "apparel/t-shirts",
      "brand": "Bella+Canvas",
      "basePrice": {
        "amount": 24.99,
        "currency": "USD"
      },
      "variants": [
        {
          "productId": "pro_k66ZW4fsRm6c2def3itltA",
          "productionMethod": "DTG",
          "recommended": true,
          "basePrice": {
            "amount": 24.99,
            "currency": "USD"
          },
          "supportsBackendRendering": true
        }
      ],
      "supportsBackendRendering": true
    }
  ]
}