Top Subreddits

You can receive an aggregated breakdown of the top subreddits that your Mentions come from by using the following API call.

It supports all of our Filters.

Required Parameters

ParameterDefinitionAccepted Values
queryId / queryGroupIdThe ID of the Query or Query Group that contains the Mentions for which you'd like to see.int
(Learn how to retrieve your Query ID or Query Group ID
startDateThe beginning of the date range that contains the Mentions."YYYY-MM-DD'T'hh:mm:ss:xx.xx+xxxx"
endDateThe end of the date range that contains the Mentions."YYYY-MM-DD'T'hh:mm:ss:xx.xx+xxxx"

Example Call

curl -X GET 'https://api.brandwatch.com/projects/128287432/data/volume/topsubreddits/queries?queryId=1273272814&startDate=2017-11-11&endDate=2017-11-18'

The results will look like the following:

{
  "results": [
    {
      "data": {
        "volume": 123,
        "postVolume": 0,
        "commentVolume": 123,
        "subredditSubscribers": 0,

      },
      "values": [
        {
          "name": "BBC",
          "value": null,
          "id": 1999922710,
          "data": {}
        }
      ],
      "name": "AskReddit",
      "id": "AskReddit"
    },
    {
      "data": {
        "volume": 38,
        "postVolume": 0,
        "commentVolume": 38,
        "subredditSubscribers": 0,
        "totalRedditScore": 12
      },
      "values": [
        {
          "name": "BBC",
          "value": null,
          "id": 1999922710,
          "data": {}
        }
      ],
      "name": "soccer",
      "id": "soccer"
    },
    {
      "data": {
        "volume": 37,
        "postVolume": 1,
        "commentVolume": 36,
        "subredditSubscribers": 0,
        "totalRedditScore": 1
      },
      "values": [
        {
          "name": "BBC",
          "value": null,
          "id": 1999922710,
          "data": {}
        }
      ],
      "name": "Cheese",
      "id": "Cheese"
    },
    {
      "data": {
        "volume": 29,
        "postVolume": 0,
        "commentVolume": 29,
        "subredditSubscribers": 0,
        "totalRedditScore": 123
      },
      "values": [
        {
          "name": "BBC",
          "value": null,
          "id": 1999922710,
          "data": {}
        }
      ],
      "name": "memes",
      "id": "memes"
    },
    {
      "data": {
        "volume": 29,
        "postVolume": 0,
        "commentVolume": 29,
        "subredditSubscribers": 0,
        "totalRedditScore": 487
      },
      "values": [
        {
          "name": "BBC",
          "value": null,
          "id": 1999922710,
          "data": {}
        }
      ],
      "name": "todayilearned",
      "id": "todayilearned"
    },
    {
      "data": {
        "volume": 25,
        "postVolume": 1,
        "commentVolume": 24,
        "subredditSubscribers": 0,
        "totalRedditScore": 12
      },
      "values": [
        {
          "name": "BBC",
          "value": null,
          "id": 1999922710,
          "data": {}
        }
      ],
      "name": "Cooking",
      "id": "Cooking"
    },
    {
      "data": {
        "volume": 25,
        "postVolume": 0,
        "commentVolume": 25,
        "subredditSubscribers": 0,
        "totalRedditScore": 122
      },
      "values": [
        {
          "name": "BBC",
          "value": null,
          "id": 1999922710,
          "data": {}
        }
      ],
      "name": "unpopularopinion",
      "id": "unpopularopinion"
    },
    {
      "data": {
        "volume": 22,
        "postVolume": 0,
        "commentVolume": 22,
        "subredditSubscribers": 0,
        "totalRedditScore": -234
      },
      "values": [
        {
          "name": "BBC",
          "value": null,
          "id": 1999922710,
          "data": {}
        }
      ],
      "name": "worldnews",
      "id": "worldnews"
    },
    {
      "data": {
        "volume": 19,
        "postVolume": 0,
        "commentVolume": 19,
        "subredditSubscribers": 0,
        "totalRedditScore": 1
      },
      "values": [
        {
          "name": "BBC",
          "value": null,
          "id": 1999922710,
          "data": {}
        }
      ],
      "name": "AskEurope",
      "id": "AskEurope"
    },
    {
      "data": {
        "volume": 15,
        "postVolume": 0,
        "commentVolume": 15,
        "subredditSubscribers": 0,
        "totalRedditScore": 12
      },
      "values": [
        {
          "name": "BBC",
          "value": null,
          "id": 1999922710,
          "data": {}
        }
      ],
      "name": "europe",
      "id": "europe"
    }
  ],
  "aggregate": "volume",
  "dimension1": "topsubreddits",
  "dimension2": "queries"
}