Get brand performance
get_brand_performanceBrand Performance: for a topic or keyword, the up to 100 brands ChatGPT's answers mention most, with their mentions, AI search volume and Share of Voice, the brand categories they mention most, and where a brand stands among them (United States, English; ChatGPT: the only market and platform with brand data). Estimated price: up to $0.64, one AI mentions request for the brands and one for the categories, billed by the rows they return. A topic saved within 24 hours, here or on the Brand Performance page, is read free. It opens free on that page; get_saved_brand_performance 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>",
"topic": "<topic>"
},
"name": "get_brand_performance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| brand | No | The brand to find among them. Omit for the project's, named by its domain without the ending. | |
| topic | Yes | A topic or keyword, e.g. 'crm software'. | |
| 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 | ||
| saved | No | ||
| topic | No | ||
| brands | No | ||
| categories | No | ||
| savedResultId | No |