Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Compare the sources that support your brand and competitors.
compare_grounding_sources. Operation: read. Uses the authorized connection; no project or content changes are made by this tool.
| Name | Type | Required | Default | Meaning and accepted values |
|---|---|---|---|---|
project_id | string | Yes | Required | Project ID from list_projects. Select the project in the intended workspace and environment. |
run_id | string | Yes | Required | Run ID from list_runs for this project. Use the exact returned value and check readiness before reading measurements. |
brand_set | string[] or null | No | null | Brand labels whose supporting sources you want to compare. Omit to use the configured target brand and competitors. |
top_per_brand | integer | No | 10 | Maximum leading sources selected for each brand before classifying shared and brand-specific sources. A source outside this selection is not proven absent. Minimum 1. Maximum 200. |
aggregation_level | string | No | 'domain' | domain requests source-domain results; url requests individual-page results. Keep the same reporting unit when comparing measurements. |
filters | object[] or null | No | null | Select measured answers with objects containing dimension and values. Use labels from list_dimension_options; inspect returned warnings for filters that were not applied. |
params object for MCP tools/call.
{
"name": "compare_grounding_sources",
"arguments": {
"project_id": "PROJECT_ID",
"run_id": "RUN_ID",
"brand_set": [
"Colorescience",
"CeraVe"
],
"top_per_brand": 10,
"aggregation_level": "domain"
}
}
| Field | Meaning and use |
|---|---|
data.brand_set | Brands included in the comparison. |
data.aggregation_level | Source reporting unit requested for the comparison. |
data.shared_sources[].domain_or_url | Source appearing in the selected leading sources for at least two requested brands. |
data.shared_sources[].brands | Brands sharing that source within the selected lists. |
data.shared_sources[].estimate | One contributing brand’s source estimate. It is not a combined estimate across the listed brands. |
{
"data_ready": true,
"data": {
"brand_set": [
"Colorescience",
"CeraVe"
],
"aggregation_level": "domain",
"shared_sources": [
{
"domain_or_url": "livetinted.com",
"brands": [
"CeraVe",
"Colorescience"
],
"estimate": {
"value": 15.7,
"ci": {
"lower": 8.2,
"upper": 28,
"level": 0.95
},
"n": 8,
"stability": "danger_zone",
"stability_n": 8
}
}
]
}
}