SERP Snapshot API

Use this endpoint to capture a timestamped SERP evidence payload. Public requests can run as a small free trial. When you provide a BytesFlows proxy account, the same endpoint is upgraded into a proxy-plan workflow and the traffic is consumed from that account.

Endpoint

• URL: /api/tools/serp-snapshot
• Method: POST
• Authentication:
  • Public free trial: no login required
  • Proxy-plan mode: authenticated dashboard session

Request Body

Field	Type	Required	Description
account	string	No	BytesFlows proxy account to bill traffic to
keyword	string	Yes	Search keyword
domain	string	No	Optional domain to locate in the organic results
country	string	No	Country code such as US
device	string	No	desktop or mobile
session_type	string	No	rotating or sticky in proxy-plan mode
duration	number	No	Sticky duration in minutes for proxy-plan mode
session_id	string	No	Optional sticky session identifier

Response Notes

• Response shape follows the ip-detector snapshot payload.
• Every response includes billing_mode, proxy_account, and traffic summary fields from the BytesFlows BFF.
• Snapshot responses also include captured_at plus an evidence_summary block with organic counts and AI Overview presence.

Example

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