Topics

Finding topics of conversation in your Mentions.

You can also use the Brandwatch topics functionality via the API.

The topics data call has the same three required parameters as the Mentions call:

  • queryId - The ID of the Query that contains the Mentions.
  • startDate - The beginning of the date range that contains the Mentions.
  • endDate - The end of the date range that contains the Mentions.

Some additional parameters that will be useful:

  • orderBy - Choose between volume (the number of Mentions the topic appears in) and burst (the amount by which it is trending).
  • limit - Limit the number of results that come back.
curl -X GET https://api.brandwatch.com/projects/397263282/data/volume/topics/queries?queryId=389734742&startDate=2016-05-01&endDate=2016-05-07&orderBy=burst&limit=2

The response will look like this:

{
  "topics": [
    {
      "id": "1998640329__Lipstick",
      "label": "Lipstick",
      "volume": 3,
      "type": "topic",
      "sentiment": {
        "neutral": 1,
        "positive": 2
      },
      "sentimentScore": 116,
      "burst": 100,
      "days": [
        {
          "date": "2016-05-05T00:00:00.000+0000",
          "volume": 1
        },
        {
          "date": "2016-05-04T00:00:00.000+0000",
          "volume": 2
        },
        {
          "date": "2016-05-02T00:00:00.000+0000",
          "volume": 0
        },
        {
          "date": "2016-05-01T00:00:00.000+0000",
          "volume": 0
        },
        {
          "date": "2016-05-06T00:00:00.000+0000",
          "volume": 0
        },
        {
          "date": "2016-05-03T00:00:00.000+0000",
          "volume": 0
        }
      ],
      "pageType": {
        "blog": 0,
        "facebook": 2,
        "forum": 1,
        "general": 0,
        "image": 0,
        "instagram": 0,
        "news": 0,
        "review": 0,
        "twitter": 0,
        "video": 0
      },
      "queries": [
        {
          "id": 1998640329,
          "name": "Makeup",
          "volume": 3
        }
      ]
    },
    {
      "id": "1998640329__Rashes",
      "label": "Rashes",
      "volume": 5,
      "type": "topic",
      "sentiment": {
        "neutral": 5
      },
      "sentimentScore": 50,
      "burst": 100,
      "days": [
        {
          "date": "2016-05-05T00:00:00.000+0000",
          "volume": 2
        },
        {
          "date": "2016-05-04T00:00:00.000+0000",
          "volume": 0
        },
        {
          "date": "2016-05-02T00:00:00.000+0000",
          "volume": 0
        },
        {
          "date": "2016-05-06T00:00:00.000+0000",
          "volume": 2
        },
        {
          "date": "2016-05-01T00:00:00.000+0000",
          "volume": 0
        },
        {
          "date": "2016-05-03T00:00:00.000+0000",
          "volume": 0
        }
      ],
      "pageType": {
        "blog": 0,
        "facebook": 5,
        "forum": 0,
        "general": 0,
        "image": 0,
        "instagram": 0,
        "news": 0,
        "review": 0,
        "twitter": 0,
        "video": 0
      },
      "queries": [
        {
          "id": 389734742,
          "name": "Makeup",
          "volume": 5
        }
      ]
    }
  ]
}

Topics

Finding topics of conversation in your Mentions.