SERP Rank Check API

Use this endpoint to run a paid rank check through a selected BytesFlows proxy account. The request is forwarded by the BytesFlows BFF to ip-detector, which binds a user-level paid route before querying SearXNG.

Endpoint

• URL: /api/tools/rank-check
• Method: POST
• Authentication: Authenticated dashboard session

Request Body

Field	Type	Required	Description
account	string	Yes	Proxy account to consume traffic from
keyword	string	Yes	Search keyword
domain	string	No	Domain to locate in organic results
country	string	No	Country code such as US
device	string	No	desktop or mobile
compare_sources	string[]	No	Optional comparison engines, for example ["bing"]
session_type	string	No	rotating or sticky
duration	number	No	Sticky session duration in minutes
session_id	string	No	Sticky session identifier

Response Notes

• Response shape follows the ip-detector rank check payload.
• Paid requests bypass the shared SERP cache.
• The selected proxy account traffic is consumed by the underlying residential proxy request.

Example

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