GET/api/v1/traffic/chart

查询总体流量趋势图表

获取当前账户过去一段时间内的自然流量趋势数据。可用于绘制搜索量与匹配量的时间序列折线图。

Query 参数

参数名	类型	必填	说明
`time_range`	String	否	指定查询的时间范围。可选值：`24h`（过去24小时，按小时聚合返回）、`7d`（过去7天，按天聚合返回）。不传此参数则默认返回过去 30 天的数据（按天聚合）。

返回值字段说明

响应数据结构

date

数据点对应的时间标识。默认或查询 7d 时为 YYYY-MM-DD 格式；当 time_range=24h 时，返回到小时级别的 YYYY-MM-DD HH:00:00 格式。

total

该时间段内的总搜索任务执行次数。

match

该时间段内的总成功匹配（点击）次数。

GET

curl -X GET "https://www.fashionbashusa.com/api/v1/traffic/chart?time_range=7d" \
     -H "Authorization: Bearer YOUR_API_KEY"

成功响应 (200 OK)

{
  "success": true,
  "data": {
    "Points": [
      {
        "date": "2023-10-01",
        "total": 150,
        "match": 45
      },
      {
        "date": "2023-10-02",
        "total": 180,
        "match": 55
      }
    ]
  }
}