Brandwatch integration for Dimension Labs
This brings in the mentions your Brandwatch Consumer Research Query already collects: forum and blog posts, reviews, news and social posts about your brand, each one as a customer message with Brandwatch's sentiment and categories alongside. You run it on your side: a small script pulls from the Consumer Research API and posts each mention to the universal API.
- Platform
- Brandwatch Consumer Research
- Type
- Social and listening
- Connects by
- Universal API
- Setup
- 5 steps
- Guide checked
- 2026-10-26, against Brandwatch's documentation
Every Brandwatch message, in the same shape as everything else.
Each record lands in the Dimension Labs conversation format, so Dimensions, reports and the agent work the same way as for every other source.
the full-text field (see step 2) text Skip mentions with no text.
resourceId userId Author ids differ by network, so use the mention's id. Don't send author or fullname.
incoming Always true.
resourceId sessionId Brandwatch's unique id for the mention. Prefix it: brandwatch-c54d12f5107496bac30b5ddc3478bbab.
resourceId conversationId Same value as sessionId.
date dimensionlabs_timestamp When the mention was posted, like 2020-06-29T22:45:43.000+0000. Convert with toMillis.
queryId, contentSource, domain, sentiment, language, countryCode, threadId, threadEntryType, guid, tags, categories platformJson contentSource tells the networks apart. threadId (X and Facebook only) groups mentions from one thread.
5 steps. Then it runs on its own.
A small job on your side reads Brandwatch through its API and posts each message to the Dimension Labs universal API. The guide gives the steps, the field mapping and the code. Run the job once for history, then every 15 minutes. A live source is enriched automatically every day; history is enriched with a backfill.
Open the full Brandwatch guide ›- 01Get API access in Brandwatch
- 02Pull new mentions
- 03Map the fields
- 04Send it
- 05Run it
What you need
- A Brandwatch Consumer Research account and a Query that collects the mentions you want.
- A Consumer Research user with the Regular or Admin role. Brandwatch says only those users can use the API.
- A Dimension Labs API key for a new Universal API source.
- X (Twitter): the full text and most metadata are stripped. Brandwatch suggests taking the post id from guid and fetching the text from the X API yourself; see the X guide, and its note on X's terms.
- Online News: only a 256-character snippet is available.
- LinkedIn: no snippet and no full text.
[03] What you can ask
Questions teams answer with Brandwatch data.
- What are people saying about the launch?
- Which complaints are spreading, and where?
- How does sentiment on us compare with competitors?
Brandwatch integration questions
Does Dimension Labs integrate with Brandwatch?
Yes. A small job on your side reads Brandwatch through its API and posts each message to the Dimension Labs universal API. The guide gives the steps, the field mapping and the code. The setup guide was checked against Brandwatch's documentation on 2026-10-26.
What Brandwatch data does Dimension Labs bring in?
This brings in the mentions your Brandwatch Consumer Research Query already collects: forum and blog posts, reviews, news and social posts about your brand, each one as a customer message with Brandwatch's sentiment and categories alongside. You run it on your side: a small script pulls from the Consumer Research API and posts each mention to the universal API.
What do I need to connect Brandwatch?
A Brandwatch Consumer Research account and a Query that collects the mentions you want. A Consumer Research user with the Regular or Admin role. Brandwatch says only those users can use the API. A Dimension Labs API key for a new Universal API source. X (Twitter): the full text and most metadata are stripped. Brandwatch suggests taking the post id from guid and fetching the text from the X API yourself; see the X guide, and its note on X's terms. Online News: only a 256-character snippet is available. LinkedIn: no snippet and no full text.
How often does Brandwatch data update?
Run the job once for history, then every 15 minutes. A live source is enriched automatically every day; history is enriched with a backfill.
Can I connect a platform that is not Brandwatch?
Yes. Any platform with an API connects through the same universal API, and any tool with an export button works as a file upload. The integrations page lists the platforms with a written guide.
Stop reporting. Start understanding.
Start with one file. Ask why a number moved. Plans from $299 a month, no demo and no contract on monthly plans.

