Find search competitors
find_serp_competitorsCompares the domains that compete in Google results for a set of keywords, in a country-level market (location and language codes). It is not radius based local SEO. Returns each domain's keyword count, average and median position, visibility and estimated traffic. Estimated price: ~$0.04 for 50 domains, billed by the domains returned; the same keywords, market and options asked again within 12 hours are answered from the saved copy at no charge. Each call may spend up to the workspace's agent spend limit ($2.00 unless changed in Settings) without asking: it holds at most its estimate plus a margin while it runs and is charged what it bought, never more. A call whose maximum is above the limit is refused before anything is bought, with its estimate and maximum: ask the user, then call again with approvedMaxCostUsd set to the amount they approved.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>",
"keywords": "<keywords>"
},
"name": "find_serp_competitors"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum domains to return. Defaults to 50. | |
| market | No | Legacy US selector. An explicit locationCode wins over it; leave both out to use the project's market. | |
| offset | No | Rows to skip for pagination. | |
| sortBy | No | Sort order for returned rows. Defaults to visibility. | |
| keywords | Yes | Keywords to compare. Competitors are the domains ranking for them. | |
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| resultTypes | No | SERP result types to count. Defaults to organic and local_pack. | |
| languageCode | No | Language for locationCode. Defaults to that location's primary language when locationCode overrides the project market. | |
| locationCode | No | Country-level location code. Defaults to the project's market; takes precedence over the legacy market object. | |
| excludeDomains | No | Domains to leave out of the answer, such as the user's own site. Subdomains of them are left out too. | |
| includeSubdomains | No | Count a domain's subdomains as part of it. | |
| approvedMaxCostUsd | No | The most, in USD, the user approved for this call after seeing its estimate and maximum. Only needed after a call was refused for costing more than the workspace's agent spend limit; never set it without asking the user. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cost | No | ||
| meta | No | ||
| competitors | Yes | ||
| savedResultId | No |