market_share_overview
How's our market share in a segment? Your share vs tracked competitors, the segment leader, and the gap — sliceable by keyword, page, search intent, content category, or branded vs non-branded demand. Pass category:'' to scope share-vs-competitors to ONE content category (e.g. "how do we rank vs competitors in our Products content?"), or page:'' for one page/URL. Country and device are NOT supported here: the verb rejects them rather than returning whole-segment share under a geography or device claim. For a country ranking use market_share_breakdown(breakdown_by:"country"); for queries or pages in one country or device use that breakdown plus country/device. Share vs competitors only. If the question also wants clicks or traffic, use growth_vs_market_share instead. To rank ACROSS the values of a grouping (e.g. top intents or top categories by share), use market_share_breakdown. Defaults to the primary 'default' (Overall Market) segment when omitted — name another tracked segment to scope to it. UNIT CONTRACT: market-share values are already percentage units on a 0–100 scale (0.03 means 0.03%, not 3%); share delta is selected-minus-comparison percentage points; leader gap is leader-minus-client percentage points for the same period; only deltaPct is a relative-change ratio.
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": {
"date_range": "<date_range>"
},
"name": "market_share_overview"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Restrict share-vs-competitors to ONE page/URL pattern (e.g. "%/products%"), matched against the customer page at the same summary grain used by QWA. Single-value filter. | |
| brand | No | Restrict to branded ("Yes") or non-branded ("No") demand (ignored at site granularity) | |
| grain | No | Granularity: whole-segment (default), site, keyword or page. Keyword/page unlock keyword-, page- and intent/brand-sliced views; site is whole-site only. NOTE: 'category' is NOT supported for share-vs-competitors (no member carries content categories AND the comp{N} columns) — passing it returns a clear steer, not competitor shares. | |
| device | No | NOT supported on this summary. Accepted only so the request can be rejected instead of returning whole-segment share while a host claims that device. Use market_share_breakdown(breakdown_by:"keyword"/"page") plus device. | |
| intent | No | Restrict to ONE search intent, e.g. "Informational" (a single-value filter, not a breakdown — for top-N across intents use market_share_breakdown; ignored at site granularity) | |
| medium | No | competitor source medium for the comparison, e.g. "google/organic" (default) or "google/cpc" | |
| country | No | NOT supported on this summary. Accepted only so the request can be rejected instead of returning whole-segment share while a host claims that country. Use market_share_breakdown(breakdown_by:"country"), or breakdown_by:"keyword"/"page" plus country. | |
| segment | No | Tracked segment ID; omit to use the primary "default" (Overall Market) segment. | |
| category | No | Restrict share-vs-competitors to ONE content category (e.g. "Products"), as exposed by list_filter_values(category). Uses QWA's summary-level category parameter. Single-value filter — for top-N across categories use market_share_breakdown(breakdown_by=category). Resolve the exact value with list_filter_values first. | |
| date_range | Yes | Explicit date range, e.g. "2026-05-01 to 2026-05-31". Both endpoints are INCLUSIVE — the END day is covered (a 7-day range = 7 days). Quattr weeks run Sunday–Saturday; for "last week" use the most recent complete Sun–Sat span. |