Get search results
get_serp_resultsFetch Google's organic search results for 1-10 keywords, or with type their Google News articles or Google Images results. Use this to inspect who ranks for a query, verify competitors, compare SERPs across keywords, or gather source URLs before content planning. Returns the top depth organic rows per keyword (default 20). Estimated price per keyword: $0.01 at the default depth of 20, $0.04 at 100; News $0.01 for 20 articles, Images $0.01. Results are the SERP analysis Keyword Research shows: a keyword bought here opens free there, and a keyword it holds a current copy of, as deep as asked, is answered here at no charge for 12 hours. Per-keyword errors don't fail the batch. 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>",
"queries": "<queries>"
},
"name": "get_serp_results"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Which Google results: organic (default), news (Google News articles, billed per 10) or images (Google Images, billed per 100). | |
| depth | No | How many SERP rows to crawl per keyword: a multiple of 10 from 10 to 100, default 20. Google has no offset, so a deeper crawl re-fetches the top too, and each further 10 results costs more. Only raise it when you need ranks past the top 20. Images ignores it and always returns up to 100. | |
| queries | Yes | 1-10 queries. Bulk-friendly: prefer this over multiple single-query calls. | |
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| 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 | ||
| results | Yes | ||
| savedResultId | No |