**版本：202701**

# 查询搜索词详情数据分析

**POST** `/openapi/2027-01/data-analysis/search-keyword`

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

## 请求

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `begin_time` string (required)

  开始时间，Unix 时间戳（秒），以字符串形式传递，例如 "1748736000"
- `end_time` string (required)

  结束时间，Unix 时间戳（秒），以字符串形式传递，例如 "1781481600"；应大于 begin\_time
- `time_zone` int32

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

  分页游标
- `page_size` int32

  每页记录数

  **默认值：** `10`
- `keyword` string

  搜索词模糊匹配
- `sort_by` string

  排序字段，可选值：

  *   `count`：搜索次数
  *   `percent`：占全部搜索的比例
  *   `uv`：搜索用户数
  *   `has_result`：是否有搜索结果
  *   `click_rate`：搜索点击率
- `sort_direction` string

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

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

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

  爬虫过滤策略，控制统计是否剔除爬虫/机器人流量。可选值：

  *   `no_filter_crawler`：不过滤，统计全部流量（默认）
  *   `official_crawler`：过滤掉已知爬虫/机器人

```json
{
  "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**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `count` int32

    匹配的搜索词总数
  - `cursor` string

    分页游标
  - `has_more` boolean

    是否有更多记录
  - `data` object[]

    搜索词详情数据列表

    *   Array \[

    - `item` string

      搜索词，例如 "shoes"
    - `count` int64

      该搜索词的搜索次数
    - `percent` double

      该搜索词占全部搜索的比例（百分比），例如 12.34（表示 12.34%）
    - `uv` int64

      搜索该词的用户数（按 IP 去重）
    - `has_result` int32

      是否有搜索结果：1 有、0 无；无结果但发生过点击穿透时按 1 算
    - `click_rate` double

      搜索点击率（百分比，0 ~ 100），例如 35.71（表示 35.71%）
    *   \]

```json
{
  "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
      }
    ]
  }
}
```