GET/api/rankboost/logs

查询关键词干预记录

获取详尽的排名监控及模拟点击记录。返回结果包含系统级的统计汇总（如近30天平均排名、近24小时点击量等），以及支持分页的逐条明细日志。

Query 参数

参数名	类型	必填	说明
`page`	integer	否	当前页码（从 1 开始），默认为 1。默认分页大小固定。
`domain`	string	否	指定过滤的域名。
`keyword`	string	否	指定过滤的关键词。
`search_engine`	string	否	指定搜索引擎进行过滤 (如 `bing`, `baidu`)。
`include_disabled`	boolean	否	是否包含已停用的历史任务日志（传 `true` 或 `false`）。

返回值字段说明

返回不仅包含 Logs，还有全局的汇总统计。

响应数据结构

TotalCount

当前筛选条件下的日志总记录数。

Count24h

过去 24 小时内的点击量。

AvgRankMonth

过去 30 天内该查询条件的平均排名。

AvgRankWeek

过去 7 天内的平均排名。

CurrentPage

当前页码。

TotalPages

总页数。

LogsArray

单页的详细执行日志数组。详细字段如下：

ID

日志的唯一标识 ID，可作为 log_id 用于获取截图。

SearchKeyword

查询的关键词。

TargetDomain

目标域名。

HasScreenshot

是否存在截图（布尔值）。

ObjectKey

截图在 OSS 中的存储路径（若存在）。

ClickedUrl

最终成功点击进入的落地页 URL。

OperationStatus

干预操作状态（如 success）。

StayDuration

页面模拟停留时长（秒）。

Rank

干预执行时找到该网页的具体排名。

Hubcode

执行此次任务的代理节点地域编码。

SearchEngine

搜索引擎名称。

CreatedAt

记录生成时间。

GET

curl -X GET "https://www.fashionbashusa.com/api/rankboost/logs?page=1" \
     -H "Authorization: Bearer YOUR_API_KEY"

成功响应示例

{
  "success": true,
  "data": {
    "TotalCount": 1024,
    "Count24h": 85,
    "AvgRankMonth": 12.4,
    "AvgRankWeek": 9.1,
    "CurrentPage": 1,
    "TotalPages": 11,
    "Logs": [
      {
        "ID": 8849,
        "SearchKeyword": "apple",
        "TargetDomain": "example.com",
        "SearchEngine": "bing",
        "Rank": 3,
        "Hubcode": "US-East-1",
        "OperationStatus": "success",
        "StayDuration": 45,
        "ClickedUrl": "https://example.com/page",
        "CreatedAt": "2023-10-01 12:00:00",
        "HasScreenshot": false,
        "ObjectKey": null
      }
    ]
  }
}