Get business posts
get_business_updatesCollects the posts, offers and events a business published on its Google Business Profile, newest first. Name the business with exactly one of businessName, cid or placeId. Usually completes within this call; if the queued job is still running you get status 'processing' plus a taskId, so call again with that taskId in 30-60 seconds to collect it at no extra cost. Estimated price: $0.01 for 10 posts, at twice the Local page's normal-priority rate; posts bought within a day, here or on the Local page, are answered 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>"
},
"name": "get_business_updates"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cid | No | Google-defined business CID (from get_local_serp_results rows). Most precise identifier. | |
| near | No | Coordinate to search from. Use it when the business name is ambiguous; otherwise locationCode is enough. | |
| depth | No | Number of posts to collect (10-100). Defaults to 10. Billed per 10 posts. | |
| taskId | No | Resume a previous call that returned status "processing". Pass back the bare taskId exactly as returned. Resuming charges no extra credits. | |
| placeId | No | Google Maps place_id (from get_local_serp_results rows). | |
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| businessName | No | Business name as it appears on Google. Supply exactly one of businessName, cid, or placeId. | |
| languageCode | No | Language code such as en, es or vi. When left out, the language of the project's default market is used (see list_projects). | |
| locationCode | No | Location code. Ignored when `near` is set; otherwise defaults to the project's market. | |
| 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 | ||
| status | Yes | ||
| taskId | Yes | ||
| updates | No | ||
| savedResultId | No |