Total Mentions

Finding total number of Mentions in your dataset in a given time period.

Required Parameters

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

ParameterDefinitionAccepted Values
queryId / queryGroupIdThe ID of the Query or Query Group that contains the Mentions for which you'd like to see Topics.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.xxx+xxxx"
endDateThe end of the date range that contains the Mentions."YYYY-MM-DD'T'hh:mm:ss.xxx+xxxx"

Note: you can specify the time zone by replacing +xxxx with the ISO UTC offset, e.g -0500 for New York standard time. Important: The character + should be URL encoded to %2B

Example Call

curl -X GET \
  'https://api.brandwatch.com/projects/1998159493/data/mentions/count?endDate=2017-07-05T04%3A00%3A00.000Z&queryId%5B%5D=1998534103&startDate=2017-06-04T04%3A00%3A00.000Z' \

The response will be similar to the following:

{
    "mentionsCount": 3635
}