SERP 排名检测接口

该接口会通过 BytesFlows 的 BFF 将请求转发到 ip-detector。后端会先把当前用户的付费代理账号绑定到独立 route，再调用单例 SearXNG 发起查询。

接口信息

• URL: /api/tools/rank-check
• 方法: POST
• 认证方式: 已登录的 Dashboard 会话

请求参数

字段	类型	必填	说明
account	string	是	要消耗流量的代理账号
keyword	string	是	搜索关键词
domain	string	否	需要定位排名的目标域名
country	string	否	国家代码，例如 US
device	string	否	desktop 或 mobile
compare_sources	string[]	否	可选对比来源，例如 ["bing"]
session_type	string	否	rotating 或 sticky
duration	number	否	Sticky 会话时长，单位分钟
session_id	string	否	Sticky 会话标识

返回说明

• 返回结构沿用 ip-detector 的 rank check 结果格式。
• 付费请求默认绕过共享 SERP 缓存。
• 请求消耗的是所选 BytesFlows 代理账号的住宅代理流量。

示例

{
  "account": "acct-main",
  "keyword": "bytesflows proxy api",
  "domain": "bytesflows.com",
  "country": "US",
  "device": "desktop",
  "compare_sources": ["bing"],
  "session_type": "sticky",
  "duration": 30
}