Get brand mentions
get_brand_mentionsBrand Mentions' tone and trend for a brand on the web (the data service's content analysis), the project's own site left out: the sites that write about it most positively, negatively and neutrally, how often it is mentioned month by month for 12 months, and the spread of ratings on pages that rate it. Estimated price up to $0.18, billed by the rows returned. The web pages that name a brand, and their totals, are get_web_mentions'. Mentions the Brand Mentions page bought are listed too, free. A part saved within 24 hours, here or on the page, is read free; get_saved_brand_mentions reads it without buying. 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_brand_mentions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| brand | No | The brand name to look for. Omit for the project's own, as saved in its context. | |
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| excludeDomain | No | A site whose own pages are left out. Defaults to the project's domain. | |
| 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 | ||
| saved | No | ||
| keyword | No | ||
| summary | No | ||
| mentions | No | ||
| excludeDomain | No | ||
| savedResultId | No |