Keyword Research API

This endpoint runs the paid keyword research flow through your BytesFlows proxy account and returns the ip-detector keyword research payload.

Endpoint

• URL: /api/tools/keyword-research
• Method: POST
• Authentication: Authenticated dashboard session

Request Body

Field	Type	Required	Description
account	string	Yes	Proxy account to consume traffic from
keyword	string	Yes	Seed keyword
country	string	No	Country code such as US
device	string	No	desktop or mobile
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 keyword research payload.
• The result includes heuristic search-volume and difficulty estimates.
• The selected proxy account traffic is consumed by the underlying residential proxy request.

Example

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