Search local businesses
search_local_businessesSearches Business Listings near a coordinate, with optional rating, review and claim filters. It is not a Maps rank check: use get_local_serp_results for that. Estimated price: $0.04 for 20 businesses, billed per business returned. 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>",
"near": "<near>"
},
"name": "search_local_businesses"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| near | Yes | The coordinate to search around, and how far. | |
| limit | No | Maximum businesses to return. Defaults to 20. | |
| query | No | Business name or title text to match. | |
| offset | No | ||
| sortBy | No | Sort order. Defaults to relevance. | |
| isClaimed | No | Set false to surface unclaimed listings. | |
| minRating | No | ||
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| categories | No | Business categories to match, for example a category slug. | |
| minReviews | No | ||
| 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 | ||
| businesses | Yes | ||
| savedResultId | No |