# 查询标签命中通话数

按自定义日期范围查询当前 App Key 绑定空间各标签命中的任务外呼通话数。

<span style="display:inline-block;background:#e6f8ea;color:#22a366;border-radius:6px;padding:2px 8px;font-weight:bold;font-family:monospace;margin-right:8px;">GET</span>
`https://dashboard.avavox.com/open/api/statistics/tags`

::: warning 标签统计口径
一通电话可分别计入多个标签；同一标签无论在过程标签和结果标签中出现多少次，在同一通电话中都只计数一次。已删除或无法查询到名称的历史标签仍保留计数，名称返回 `未知标签`。
:::

## 请求头

<span style="font-family:monospace; color:#3451b2; ">Authorization</span> <code style="background:#f0f0f0; ">string</code> <span style="background:#dc3545; color:white; padding:2px 6px; border-radius:3px; font-size:12px;">必填</span>

- 填写格式：`Authorization: Bearer <App Key>`
- 仅支持空间级 App Key，数据限定在 Key 绑定的空间内。
- 获取方式详见：[《App Key 创建与管理》](https://avavox.com/docs/developer/app-key.html)。

## 请求参数

<span style="font-family:monospace; color:#3451b2;">start</span> <code style="background:#f0f0f0;">string</code> <span style="background:#dc3545; color:white; padding:2px 6px; border-radius:3px; font-size:12px;">必填</span>

统计开始日期，格式为 `yyyy-MM-dd`，包含当天。

---

<span style="font-family:monospace; color:#3451b2;">end</span> <code style="background:#f0f0f0;">string</code> <span style="background:#dc3545; color:white; padding:2px 6px; border-radius:3px; font-size:12px;">必填</span>

统计结束日期，格式为 `yyyy-MM-dd`，包含当天。不能早于 `start` 或晚于当前日期，且起止日期最多包含 7 个自然日。

::: warning 单次扫描上限
标签统计单次最多扫描 100000 通电话。即使日期范围不超过 7 天，通话量超过上限时请求仍会失败，请进一步缩短日期范围后重试。
:::

## 响应数据

<span style="font-family:monospace; color:#3451b2;">code</span> <code style="background:#f0f0f0;">int</code>

状态码，200 为成功，其他状态均为失败。

---

<span style="font-family:monospace; color:#3451b2;">success</span> <code style="background:#f0f0f0;">boolean</code>

是否成功，`true` 表示成功，`false` 表示失败。

---

<span style="font-family:monospace; color:#3451b2;">message</span> <code style="background:#f0f0f0;">string</code>

描述信息。

---

<span style="font-family:monospace; color:#3451b2;">data</span> <code style="background:#f0f0f0;">array</code>

标签统计列表，按 `callCount` 降序排列；命中数相同时按 `tagId` 升序排列。无标签命中时返回空数组。

<details>
<summary>点击展开字段说明</summary>
<div style="margin: 16px 0; padding: 16px; border-left: 1px solid #f0f0f0; border-radius: 6px;">

<span style="font-family:monospace; color:#3451b2;">tagId</span> <code style="background:#f0f0f0;">string</code>

标签 ID。

---

<span style="font-family:monospace; color:#3451b2;">tagName</span> <code style="background:#f0f0f0;">string</code>

标签名称。历史标签已删除或无法查询到名称时返回 `未知标签`。

---

<span style="font-family:monospace; color:#3451b2;">callCount</span> <code style="background:#f0f0f0;">long</code>

命中该标签的通话数，同一通电话内按标签去重。

</div>
</details>

## 请求示例

```shell
curl -X GET --location 'https://dashboard.avavox.com/open/api/statistics/tags?start=2026-10-01&end=2026-10-07' \
--header 'Authorization: Bearer $Key'
```

## 响应示例

```json
{
  "code": 200,
  "message": "操作成功",
  "success": true,
  "data": [
    {
      "tagId": "tag_1001",
      "tagName": "有购买意向",
      "callCount": 326
    },
    {
      "tagId": "tag_1002",
      "tagName": "需再次跟进",
      "callCount": 184
    }
  ]
}
```