---
title: "Search products"
method: GET
path: "/products/search-products/v3"
tags: ["Products (Legacy)"]
---

# Search products

`GET /products/search-products/v3`

## Request

- Base URL: `https://api.collectpure.com`
- URL: `https://api.collectpure.com/products/search-products/v3`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/collectpure/apis/pure-public-api/docs/products/search-products/v3/get.ts> (a function with typed inputs; its response is checked against the schema)

Search for products. When no query is provided, returns all products with pagination.

**Rate limit:** 120 requests burst, 60 requests/minute sustained.

## Query parameters

- `query` string
- `limit` integer
- `offset` integer
- `filter_by` string

## Response `200`

Default Response

- object
  - `data` object, required
    - `products` object[], required
      - `id` string, required
      - `title` string, required
      - `description` string, required
      - `sku` string, required
      - `category` string, required
      - `sub_category` string, required
      - `material` string, required
      - `manufacturer` string, required
      - `weight` string, required
      - `weight_grams` number, required
      - `purity` string, required
      - `premium_calculation_type` string, required
      - `certificate_provider` string
      - `attributes` number[]
      - `variants` object[]
        - `id` string, required
        - `title` string, required
        - `description` string, nullable
        - `sortKey` number, nullable
      - `images` string[]
      - `listing_id` string
      - `listing_price` number
      - `listing_spot_premium` number
      - `listing_spot_premium_dollar` number
      - `listing_expires_at` string
      - `offer_id` string
      - `offer_price` number
      - `offer_spot_premium` number
      - `offer_spot_premium_dollar` number
      - `offer_expires_at` string
      - `is_stocked_by_bb_store` boolean
      - `is_certified` boolean
      - `is_esg` boolean
      - `is_ira` boolean
      - `is_numismatic` boolean
      - `has_listing` boolean
      - `has_offer` boolean
      - `favorite_count` number
      - `view_count` number, required
      - `created_at` string
      - `updated_at` string
    - `total` number, required
    - `facets` object[]
      - `field` string, required
      - `counts` object[], required
        - `value` string, required
        - `count` number, required
      - `stats` object
        - `min` number
        - `max` number
        - `sum` number
        - `avg` number
        - `total_values` number

---

[API](https://skmtc.dev/collectpure/apis/pure-public-api.md) - [All operations](https://skmtc.dev/collectpure/apis/pure-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/collectpure/apis/pure-public-api/revisions/ed6a1fe27572?raw)