SERP Snapshot API

这个接口用于保存带时间戳的 SERP 证据。公开页可以先用少量免费额度试跑；当你传入 BytesFlows 的代理 account 时，同一个接口会自动升级为代理套餐模式，并从该账号中消耗住宅流量。

接口信息

• URL: /api/tools/serp-snapshot
• Method: POST
• 认证方式:
  • 免费试用：无需登录
  • 代理套餐模式：需要登录后的控制台会话

请求参数

字段	类型	必填	说明
account	string	否	要消耗流量的 BytesFlows 代理账号
keyword	string	是	搜索关键词
domain	string	否	可选，用于在自然结果中定位目标域名
country	string	否	国家代码，例如 US
device	string	否	desktop 或 mobile
session_type	string	否	代理套餐模式下可选 rotating 或 sticky
duration	number	否	sticky session 持续分钟数
session_id	string	否	可选的 sticky session 标识

响应说明

• 响应主体沿用 ip-detector 的 snapshot 结果结构。
• BytesFlows BFF 会在响应中补充 billing_mode、proxy_account 和流量摘要字段。
• Snapshot 结果还会返回 captured_at，以及包含自然结果数量和 AI Overview 标记的 evidence_summary。

请求示例

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