Marketing graph#

Public intelligence about companies, brands, and competitive categories in a market: modeled branded-search demand, Share of Search inside a defined set, rank changes over time, and the sources behind each figure.

Authentication required

All endpoints require a Bearer token in the Authorization header. See the Authentication guide for setup instructions.

GET /v1/marketing-graph/overview#

Retrieve a summary of the whole public Marketing Graph 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.

bash

GET /v1/marketing-graph/overview
Authorization: Bearer {token}

Response#

Returns { data, _meta } with the result.

GET /v1/marketing-graph/markets#

List every country and region covered by the public Marketing Graph, 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.

bash

GET /v1/marketing-graph/markets
Authorization: Bearer {token}

Response#

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

GET /v1/marketing-graph/markets/:marketKey#

Retrieve the public Marketing Graph 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.

bash

GET /v1/marketing-graph/markets/:marketKey
Authorization: Bearer {token}

Parameters#

Name	Type	Required	Description
marketKey	`string`	Required	Market key, e.g. "nz" for New Zealand.

Response#

Returns { data, _meta } with the result.

GET /v1/marketing-graph/markets/:marketKey/categories/:categorySlug#

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.

bash

GET /v1/marketing-graph/markets/:marketKey/categories/:categorySlug
Authorization: Bearer {token}

Parameters#

Name	Type	Required	Description
marketKey	`string`	Required	Market key, e.g. "nz" for New Zealand.
categorySlug	`string`	Required	Category slug, e.g. "accounting-software".

Response#

Returns { data, _meta } with the result.

GET /v1/marketing-graph/markets/:marketKey/brands/:brandSlug#

Retrieve a public brand profile from the Marketing Graph 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.

bash

GET /v1/marketing-graph/markets/:marketKey/brands/:brandSlug
Authorization: Bearer {token}

Parameters#

Name	Type	Required	Description
marketKey	`string`	Required	Market key, e.g. "nz" for New Zealand.
brandSlug	`string`	Required	Brand slug, e.g. "new-world".

Response#

Returns { data, _meta } with the result.

GET /v1/marketing-graph/markets/:marketKey/companies/:companySlug#

Retrieve a public multi-brand company portfolio from the Marketing Graph 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.

bash

GET /v1/marketing-graph/markets/:marketKey/companies/:companySlug
Authorization: Bearer {token}

Parameters#

Name	Type	Required	Description
marketKey	`string`	Required	Market key, e.g. "nz" for New Zealand.
companySlug	`string`	Required	Company slug, e.g. "xero".

Response#

Returns { data, _meta } with the result.