Brand Demand Index#

See how an AI assistant can help with Brand Demand Index in Brandwave, including example prompts and the details it may ask for.

Using your AI assistant

Connect to the Brandwave MCP server, then ask your AI assistant in natural language. It will choose the right Brandwave task and ask for any details it needs.

Get Brand Demand Index overview#

Retrieve a summary of the whole public Brand Demand Index in one call: how many markets, brands, competitive sets, and multi-brand company portfolios Brandwave publishes, the earliest and latest months measured, and the strongest branded-search movements across every market. Use this to see what changed recently anywhere in the dataset before drilling into a single market.

Tool name: get_brand_demand_index_overview. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.

Example prompt#

text

Show me the details for this brand demand index overview.

What you'll get back#

Returns { data, _meta } with the result.

List Brand Demand Index markets#

List every country and region covered by the public Brand Demand Index, such as New Zealand, with how many competitive sets, brands, and multi-brand company portfolios each one publishes and how recent the data is. Use this to discover which market keys are available before requesting a market, brand, category, or company.

Tool name: list_brand_demand_index_markets. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.

Example prompt#

text

List all brand demand index markets in my workspace.

What you'll get back#

Returns { items, totalCount, facets, _meta } with paginated results.

Get Brand Demand Index market#

Retrieve the public Brand Demand Index index for one market key, such as "nz" for New Zealand: the competitive categories and brands tracked in that market with their current Share of Search, plus company pages only for meaningful multi-brand portfolios.

Tool name: get_brand_demand_index_market. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.

Example prompt#

text

Show me the details for this brand demand index market.

Details to provide#

Name	Type	Required	Description
marketKey	`string`	Required	Geographic market key, e.g. "nz", "au", or "global-en" (worldwide English-curated terms).

What you'll get back#

Returns { data, _meta } with the result.

Get Brand Demand Index category#

Retrieve one public competitive category in a market by market key and category slug: twelve months of modeled branded-search demand for each member brand, Share of Search inside the set, rank and share movement, exact search terms, sources, and limitations.

Tool name: get_brand_demand_index_category. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.

Example prompt#

text

Show me the details for this brand demand index category.

Details to provide#

Name	Type	Required	Description
marketKey	`string`	Required	Geographic market key, e.g. "nz", "au", or "global-en" (worldwide English-curated terms).
categorySlug	`string`	Required	Category slug, e.g. "accounting-software".

What you'll get back#

Returns { data, _meta } with the result.

Get Brand Demand Index brand#

Retrieve a public brand profile from the Brand Demand Index by market key and brand slug, such as "new-world": twelve months of modeled branded-search demand, its Share of Search position in each competitive set, the branded search terms measured, and the company that owns it. The brand does not need to be a Brandwave customer.

Tool name: get_brand_demand_index_brand. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.

Example prompt#

text

Show me the details for this brand demand index brand.

Details to provide#

Name	Type	Required	Description
marketKey	`string`	Required	Geographic market key, e.g. "nz", "au", or "global-en" (worldwide English-curated terms).
brandSlug	`string`	Required	Brand slug, e.g. "new-world".

What you'll get back#

Returns { data, _meta } with the result.

Get Brand Demand Index comparison#

Retrieve a head-to-head comparison of two brands inside a shared competitive set in one market: twelve months of branded-search demand, Share of Search, rank, and lead changes. Set categorySlug to compare the pair inside a particular shared set; without it, the set with the most measured demand is used. Returns not found when the pair does not share the requested set.

Tool name: get_brand_demand_index_comparison. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.

Example prompt#

text

Show me the details for this brand demand index comparison.

Details to provide#

Name	Type	Required	Description
marketKey	`string`	Required	Geographic market key, e.g. "nz", "au", or "global-en" (worldwide English-curated terms).
brandSlug	`string`	Required	First brand slug, e.g. "asb".
otherBrandSlug	`string`	Required	Second brand slug, e.g. "anz".
categorySlug	`string`	—	Optional competitive set when the pair shares more than one set in this market.

What you'll get back#

Returns { data, _meta } with the result.

Compare chosen Brand Demand Index brands#

Retrieve a comparison of any two to ten published brands in one market, even when they belong to different competitive sets: twelve months of branded-search demand for each brand and Share of Search computed among the chosen brands only. Pass the brand slugs comma-separated in brands. Shares here describe the selection, not a curated market set, and brands from another market cannot be combined.

Tool name: get_brand_demand_index_selection. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.

Example prompt#

text

Show me the details for this compare chosen brand demand index brands.

Details to provide#

Name	Type	Required	Description
marketKey	`string`	Required	Geographic market key, e.g. "nz", "au", or "global-en" (worldwide English-curated terms).
brands	`string`	Required	Comma-separated brand slugs, 2 to 10, e.g. "xero,myob,hnry".

What you'll get back#

Returns { data, _meta } with the result.

Get Brand Demand Index company#

Retrieve a public multi-brand company portfolio from the Brand Demand Index by market key and company slug: the two or more tracked brands this company owns, the branded terms each brand is measured through, and where each brand sits in its competitive categories. Demand belongs to the brands, so the company is never given a combined figure. A single-brand owner has no separate company page.

Tool name: get_brand_demand_index_company. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.

Example prompt#

text

Show me the details for this brand demand index company.

Details to provide#

Name	Type	Required	Description
marketKey	`string`	Required	Geographic market key, e.g. "nz", "au", or "global-en" (worldwide English-curated terms).
companySlug	`string`	Required	Company slug, e.g. "xero".

What you'll get back#

Returns { data, _meta } with the result.