使用统计API
接口信息
POST认证方式
ApiKey:{your_api_key}请求参数
Body 参数（JSON 格式）
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| start_time | int64 | 否 | 开始时间戳（秒） | 1712563200 |
| end_time | int64 | 否 | 结束时间戳（秒） | 1712649599 |
| engines | array[int] | 否 | 搜索引擎ID列表，用于筛选特定引擎的数据 | [1, 2, 3] |
| group_by | string | 是 | 分组方式，可选值：hour（按小时）或 day（按天） | "day" |
engines参数说明
engines 用于指定需要统计/查询的搜索引擎或产品模块类型。传入引擎对应的 ID 数组，用于筛选数据来源。array[int][1, 2, 3]引擎 ID 对照表
| ID | 引擎名称 | 说明 |
|---|---|---|
| 1 | Google 搜索 | |
| 2 | bing | Bing Web 搜索 |
| 3 | yandex | Yandex 搜索 |
| 4 | duckduckgo | DuckDuckGo 搜索 |
| 5 | google_shopping | Google 购物搜索 |
| 6 | google_images | Google 图片搜索 |
| 7 | google_news | Google 新闻搜索 |
| 8 | google_videos | Google 视频搜索 |
| 9 | google_local | Google 本地搜索 （Local Pack） |
| 11 | google_lens | Google 图片识别（Lens） |
| 12 | google_trends | Google 趋势 |
| 13 | google_maps | Google 地图 |
| 14 | google_hotels | Google 酒店 |
| 15 | google_jobs | Google 招聘 |
| 16 | google_scholar | Google 学术搜索 |
| 19 | google_play | Google Play 商店 |
| 20 | google_finance | Google 财经 |
| 21 | google_flights | Google 航班 |
| 22 | google_patents | Google 专利 |
| 23 | bing_images | Bing 图片 |
| 24 | bing_videos | Bing 视频 |
| 25 | bing_news | Bing 新闻 |
| 26 | bing_shopping | Bing 购物 |
| 27 | bing_maps | Bing 地图 |
| 35 | google_ai_mode | Google AI 模式 |
| 36 | google_ai_overview | Google AI 概览 |
| 37 | google_web | Google Web（标准网页搜索） |
请求示例
{
"start_time": 1712563200,
"end_time": 1712649599,
"engines": [1, 2, 3],
"group_by": "day"
}响应数据
响应格式
{
"code": 200,
"data": [
{
"time_key": "2024-04-08",
"success_count": 1250,
"fail_count": 50,
"total_count": 1300,
"success_rate": 96.15,
"avg_response_time": 1250.5,
"total_amount": 650.25
},
{
"time_key": "2024-04-09",
"success_count": 1180,
"fail_count": 20,
"total_count": 1200,
"success_rate": 98.33,
"avg_response_time": 1180.3,
"total_amount": 600.0
}
],
"message": "查询成功",
"timestamp": 1712649600
}响应字段说明
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | int | 响应状态码，200 表示成功 |
| data | array | 统计数据数组 |
| message | string | 响应消息 |
| timestamp | int64 | 响应时间戳 |
data 数组元素字段说明
| 字段名 | 类型 | 说明 |
|---|---|---|
| time_key | string | 时间键，格式根据 group_by 参数决定 - hour: "2024-04-08 14:00:00" - day: "2024-04-08" |
| success_count | int64 | 成功请求次数（HTTP 状态码 200） |
| fail_count | int64 | 失败请求次数（非 200 状态码或无结果） |
| total_count | int64 | 总请求次数 |
| success_rate | float64 | 成功率（百分比，保留 2 位小数） |
| avg_response_time | float64 | 平均响应时间（毫秒，保留 2 位小数） |
| total_amount | float64 | 消耗积分总额 （保留 4 位小数） |
错误响应
401 未授权
{
"code": 401,
"data": null,
"message": "用户验证失败",
"timestamp": 1712649600
}400 参数错误
{
"code": 400,
"data": null,
"message": "参数验证失败：group_by 必须是 hour 或 day",
"timestamp": 1712649600
}500 服务器错误
{
"code": 500,
"data": null,
"message": "数据查询失败",
"timestamp": 1712649600
}使用示例
cURL 示例
Python 示例
JavaScript 示例
注意事项
1.
start_time 和 end_time，将返回所有历史数据2.
engines 参数为空时，返回所有搜索引擎的统计数据；传入引擎ID数组可筛选特定引擎3.
hour: 按小时分组，适合查看短期详细趋势day: 按天分组，适合查看长期趋势4.
5.
业务场景
修改于 2026-05-27 08:41:35