查询搜索词详情数据分析

POST 
/openapi/2026-01/data-analysis/search-keyword

按搜索词分组获取站内搜索分析数据，包括搜索次数、搜索用户数、是否有搜索结果和搜索点击率。

请求

application/json

请求体

请求体必填

begin_timestring必填

开始时间，Unix 时间戳（秒），以字符串形式传递，例如 "1748736000"

end_timestring必填

结束时间，Unix 时间戳（秒），以字符串形式传递，例如 "1781481600"；应大于 begin_time

time_zoneint32

时区偏移（小时）；推荐范围 -12 至 14

cursorstring

分页游标

page_sizeint32
每页记录数
默认值： 10
keywordstring

搜索词模糊匹配

sort_bystring
排序字段，可选值：
• count：搜索次数
• percent：占全部搜索的比例
• uv：搜索用户数
• has_result：是否有搜索结果
• click_rate：搜索点击率
sort_directionstring

排序方向，可选值：asc（升序）、desc（降序）；默认 desc

has_resultstring

按是否有搜索结果筛选：1 有结果、0 无结果；默认不筛选

country_codestring

按访客所在国家/地区码筛选，例如 "US"

filter_crawler_typestring
爬虫过滤策略，控制统计是否剔除爬虫/机器人流量。可选值：
• no_filter_crawler：不过滤，统计全部流量（默认）
• official_crawler：过滤掉已知爬虫/机器人

示例

{
  "begin_time": "string",
  "end_time": "string",
  "time_zone": 0,
  "cursor": "string",
  "page_size": 10,
  "keyword": "string",
  "sort_by": "string",
  "sort_direction": "string",
  "has_result": "string",
  "country_code": "string",
  "filter_crawler_type": "string"
}

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object
countint32
匹配的搜索词总数
cursorstring
分页游标
has_moreboolean
是否有更多记录
data object[]
搜索词详情数据列表
Array [
itemstring
搜索词，例如 "shoes"
countint64
该搜索词的搜索次数
percentdouble
该搜索词占全部搜索的比例（百分比），例如 12.34（表示 12.34%）
uvint64
搜索该词的用户数（按 IP 去重）
has_resultint32
是否有搜索结果：1 有、0 无；无结果但发生过点击穿透时按 1 算
click_ratedouble
搜索点击率（百分比，0 ~ 100），例如 35.71（表示 35.71%）
]

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "count": 0,
    "cursor": "string",
    "has_more": true,
    "data": [
      {
        "item": "string",
        "count": 0,
        "percent": 0,
        "uv": 0,
        "has_result": 0,
        "click_rate": 0
      }
    ]
  }
}