Brandwatch Developer Hub

Welcome to the Brandwatch developer hub. You'll find comprehensive guides and API documentation to help you start working with Brandwatch as quickly as possible!

Get Started    

Retrieving Query Groups

Listing the Query Groups that you have created.

You can create Query Groups to represent a relationship between related Queries. They are stored within Projects.

The following call will list the Groups in the Project with ID 937893762:
(Click here to learn how to get your Project ID)

curl -X GET https://api.brandwatch.com/projects/937893762/querygroups

The response will look like the following:

{
  "resultsTotal": -1,
  "resultsPage": -1,
  "resultsPageSize": -1,
  "results": [
    {
      "id": 165923298,
      "name": "Competitors",
      "shared": "public",
      "sharedProjectIds": [
        1494022974
      ],
      "queries": [
        {
          "id": 39037892,
          "name": "Ikea"
        },
        {
          "id": 49482811,
          "name": "DFS"
        }
      ],
      "users": [
        {
          "id": 298473382,
          "username": "[email protected]",
          "firstName": "John",
          "lastName": "Doe",
          "uiRole": "regular"
        }
      ]
    }
  ]
}

You can then use the id of the Query Group to apply a Filter to Mentions data calls, or to create charts with.

Updated about a year ago

Retrieving Query Groups


Listing the Query Groups that you have created.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.