**版本：202601**

# 查询商品数量

**GET** `/openapi/2026-01/products/count`

返回符合筛选条件的商品总数。

## 请求

**Query参数**

- `ids` string[]

  商品 ID 列表。 示例：?ids=2001&ids=2002
- `title` string

  商品名称
- `collection_id` string

  专辑 UUID，例如：`9e79ca1f-9ff2-409b-976f-98be343d38a3`
- `created_at_min` string

  筛选创建时间不早于该时间点的商品，例如：`2018-10-01T16:15:47-04:00`
- `created_at_max` string

  筛选创建时间不晚于该时间点的商品，例如：`2018-10-01T16:15:47-04:00`
- `updated_at_min` string

  筛选最后更新时间不早于该时间点的商品，例如：`2018-10-01T16:15:47-04:00`
- `updated_at_max` string

  筛选最后更新时间不晚于该时间点的商品，例如：`2018-10-01T16:15:47-04:00`
- `published_at_min` string

  筛选上架时间不早于该时间点的商品，例如：`2018-10-01T16:15:47-04:00`
- `published_at_max` string

  筛选上架时间不晚于该时间点的商品，例如：`2018-10-01T16:15:47-04:00`
- `published_status` string

  按上架状态筛选，可选值：`published`（已上架）、`unpublished`（未上架）、`any`（全部）

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `count` int64

    符合筛选条件的商品总数

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "count": 0
  }
}
```