聚合统计 API | Insight 搜索

对指定分面（facet）做查询与命中统计，常用于筛选、聚合展示。

方法	POST
路径	`/1/indexes/{indexName}/facets/{facetName}/query`
Base URL 示例	https://api.prophetes.ai
完整 URL 示例	`https://api.prophetes.ai/1/indexes/{indexName}/facets/{facetName}/query`

Demo 下载

下载我们的官方 Demo，快速将 Insight 搜索集成到您的应用中：

使用 java.net.http.HttpClient，无第三方依赖

下载 Demo

Header	说明
`x-insight-application-id`	应用 ID
`x-insight-api-key`	API Key
`Content-Type`	application/json

请求体格式

请求体为 JSON，常用字段：params、facetQuery、maxFacetHits。

{
  "params": "hitsPerPage=2&getRankingInfo=1",
  "facetQuery": "",
  "maxFacetHits": 15
}

参数	类型	必填	默认	说明
`params`	string	否	`""`	分页等控制，query string 形式
`facetQuery`	string	否	`""`	为空统计全部；有值时仅统计匹配该前缀/关键词的分面值
`maxFacetHits`	integer	否	15	最大返回分面条数

{
  "facetHits": [
    { "count": 5, "highlighted": "Bathroom <em>Furniture</em>", "value": "Bathroom Furniture" }
  ],
  "exhaustiveFacetsCount": true,
  "processingTimeMS": 44
}

facetHits：命中列表；count 聚合数量；highlighted 高亮 HTML；value 分面值

curl -X POST "https://api.prophetes.ai/1/indexes/INSIGHT_INDEX_NAME/facets/INSIGHT_FACET_NAME/query" \
  -H "Content-Type: application/json" \
  -H "x-insight-api-key: INSIGHT_API_KEY" \
  -H "x-insight-application-id: INSIGHT_APPLICATION_ID" \
  -d '{"facetQuery":"Furniture","maxFacetHits":15,"params":"hitsPerPage=2&getRankingInfo=1"}'

聚合统计

接口概览

Demo 下载

鉴权

请求体格式

请求参数

响应结构

示例