GET
/api/rankboost/chart查询关键词排名数据
获取指定域名和关键词下的按日平均排名变化数据。该接口通常用于在前台绘制排名趋势的折线图,帮助直观分析点击干预的效果。
Query 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
domain | string | 否 | 过滤指定域名的排名数据。 |
keyword | string | 否 | 过滤指定关键词的排名数据。 |
search_engine | string | 否 | 指定搜索引擎进行过滤 (如 bing, baidu)。 |
include_disabled | boolean | 否 | 是否包含已停用任务的历史数据(传 true 或 false)。 |
返回值字段说明
响应数据结构
date 日期字符串,格式为
YYYY-MM-DD。 avg_rank 该日期的平均有效排名(计算方式:仅统计成功匹配的记录,剔除未找到目标的 0 名记录后求日平均值)。值越小排名越靠前。若无数据则为 0。
clicks 该日期内的有效点击总次数。
GET
curl -X GET "https://www.fashionbashusa.com/api/rankboost/chart?domain=example.com" \ -H "Authorization: Bearer YOUR_API_KEY"
成功响应示例
{
"success": true,
"data": {
"Points": [
{
"date": "2023-10-01",
"avg_rank": 12.5,
"clicks": 105
},
{
"date": "2023-10-02",
"avg_rank": 9.2,
"clicks": 132
}
]
}
}