Skip to main content

New company and sector details on Brandscape Data

The Brandscape Data endpoint has been extended with details and filtering based on two new relationships: Sector and Company.

The sector is a higher-level grouping of categories to create larger groups of brands. Whereas categories can vary greatly between markets, sectors stay consitent. This makes them perfect for cross-market and cross-year analysis.

The company is the legal entity that owns a given brand. One company can own many brands. Through the company you can tie together financial performance such as annual results or stock price details with the brandscape data.

Both are available now as includes in the brandscape data endpoint. This means that for each brandscape data record you can get the company and sector details along with all other data.

# Include the company
GET /api/v2/brandscape-data/?include=company

# Include the sector
GET /api/v2/brandscape-data/?include=company

Both of them are also available to filter by so that you can get the brandscape data for all brands in one or more sectors and/or companies:

# Only include two specific companies.
GET /api/v2/brandscape-data/?filter[companies]=1,2

# Only include the sector with ID 1.
GET /api/v2/brandscape-data/?filter[sectors]=1

You can read more in the Brandscape Data endpoint docs.

If you are having problems with using the API, or if you have any questions or feedback, please do reach out to us. We are happy to help.

Introducing the BAV API v2.0

We are excited to release the second version of the API which includes a number of new features and improvements. Thank you to everyone who have provided feedback and suggestions for improvements.

With the new version we aim to make a series of breaking changes that are only possible with a new version of the API. They will allow us to better add continuous improvements and new features regularly without having to release new breaking-change versions.

We suggest that you review all calls and responses for any changes to the responses.

At a high-level, these are the changes that will affect you:

  • There are no removed resources but several new ones.
  • Some fields have been given new names, a select few have been removed.
  • Filtering now has a new, consistent format (see filtering).
  • Sorting now has a new, simplified format (see sorting).
  • Expansions are now includes (see includes).
  • Ability to scope API keys to specific operations.

If you are having problems with using the API, or if you have any questions or feedback, please do reach out to us. We are happy to help.

Welcome to the updated developer website!

Welcome, to the updated BAV@WPP developer website which currently houses the BAV API documentation but will also be the home to any future development related documentation for BAV.

We are excited that so many of you are using the API to build analytical integrations into your specific workflows and tools.

In this stream we'll be posting news relating to the API and other development features. If you've got an active API key on the platform we'll also be sending them to you via e-mail.