Skip to main content

​
Research keywords

This paid BYO-key lookup uses one eligible DataForSEO connection owned by the project. Send one seed per request. mode=auto cascades through related keywords, suggestions, and ideas until it reaches the requested unique result count. Results are deduplicated case-insensitively and the seed itself is excluded. There is no offset pagination. Choose result_limit as 100, 300, or 500 before the lookup. The current per-source estimate comes from Bisibility’s maintained provider rates table. include_clickstream=true requests clickstream-refined volumes and doubles the provider price. Results, including empty results, are cached for 12 hours and shared with MCP and the in-progress UI. fresh=true skips the cache read. Endpoints that can spend provider budget require write scope. Use estimate_only=true for a free, cache-aware dry run. It returns no rows, sets estimate: true, and reports each source’s estimated cost without calling the provider, consuming budget, or writing the cost ledger. max_cost_cents sets a best-effort request guard. Auto mode stops before a source whose estimate would exceed the remaining guard and returns partial results with that source marked skipped and reason cost_limit. Estimates come from the maintained rates table, and actual provider cost can differ slightly. The monthly provider budget remains the hard stop. Each row includes nullable volume, 12-month trend, CPC in cents, competition, difficulty, and intent. source identifies the algorithm that returned the keyword. already_tracked is true when the project already tracks its exact case-insensitive normalized text. The envelope includes source-level returned counts and provider-reported costs, the selected provider label, eligible connections, aggregate cost, cache status, and fetch time. Each source has an ok, failed, or skipped status and an optional machine-readable reason. Successful sources are cached independently, so retrying a partial response does not pay again for completed source calls. Unsupported locations, exhausted budgets, provider throttling, reauthorization, and missing eligible sources use the standard problem response.