`search_price_summary`

按产品名搜索市场级价格汇总。

英文描述

Search aggregated market price summaries by product name keyword from ads_price_summary. Use when the user asks for reference prices, market averages, or product-level price summaries (not time-series for one CAS). Optional market_id filter.

文档更新：2026-06-23T10:00:00+08:00

请求参数

参数名	参数说明	数据类型	样例数据
`keyword`	必填；至少 2 个字符	string	丙烯酸
`market_id`	选填；至少 1 个字符	string	（选填，示例中省略）
`limit`	选填	integer	20
`offset`	选填	integer	0

响应参数

参数名	参数说明	数据类型	样例数据
`data`	业务记录数组	array	[{"product_name": "乙醇", "market_id": "MKT001", "avg_price": 6200.0, "price_unit": "元/吨"}]
`data[].product_name`	产品名称	string	乙醇
`data[].market_id`	市场 ID	string	MKT001
`data[].avg_price`	均价	number	6200
`data[].price_unit`	价格单位	string	元/吨
`meta.total`	命中总数	integer	100
`meta.limit`	本页 limit	integer	20
`meta.offset`	本页 offset	integer	0
`meta.has_more`	是否还有下一页	boolean	true

响应状态说明

状态	说明
`success`	调用成功，返回业务数据
`failed`	参数错误、后端业务错误或系统异常
`denied`	API Key 无效、无权限、RBAC/菜单拒绝等

请求示例

{
  "keyword": "丙烯酸",
  "limit": 20,
  "offset": 0
}

响应示例

{
  "data": [
    {
      "product_name": "乙醇",
      "market_id": "MKT001",
      "avg_price": 6200,
      "price_unit": "元/吨"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 20,
    "offset": 0,
    "has_more": false
  }
}