Get web mentions
get_web_mentionsFinds web pages that name the project's brand (an exact phrase), for link building: each page's site, title, publish date, how it leans (positive, negative or neutral) and the site's 0 to 100 link-graph rank, strongest sites first and one page per site, with the project's own site left out. It cannot tell whether a page links to the project: a page is a prospect to check, and "site links to you" says yes only when the project's saved referring domains list the site. view "summary" instead returns how many pages name the brand, how they lean, and the 10 sites that name it most. Estimated price: up to $0.06 for pages (one request, billed by the up to 100 pages returned) or up to $0.05 for the summary. An answer saved within 7 days is read free; get_saved_web_mentions reads it without buying. save_link_prospect keeps a site as a prospect. 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_web_mentions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| view | No | "pages": up to 100 pages that name the brand, one per site, strongest sites first. "summary": how many pages name it, how they lean, and the 10 sites that name it most. | pages |
| brand | No | The brand name to look for, as an exact phrase. Defaults to the project's own brand name. | |
| limit | No | How many pages to return. Defaults to 50. | |
| offset | No | How many pages to skip, to read further on. | |
| 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 | ||
| rows | No | ||
| view | No | ||
| brand | No | ||
| saved | No | ||
| totalCount | No | ||
| savedResultId | No |