You can receive an aggregated breakdown of the top sites 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.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

Optional Parameters

ParameterDefinitionAccepted Values
limitThe number of sites you'd like to retrieveint 0-1000

🚧

Maximum Limit

The maximum number of sites returned by this call is limited to 1,000. Requests specifying no limit will default to 10 sites.

Example Call

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

The results will look like the following:

{
    "results": [
        {
            "data": {
                "volume": 34327,
                "monthlyVisitors": 1308696000,
                "countryName": "United Kingdom",
                "countryCode": "GBR",
                "authorName": "AirplayNinja",
                "authorGender": null,
                "authorAccountType": "individual",
                "domain": "twitter.com",
                "authorProfessions": [],
                "authorInterest": [],
                "sentiment": {
                    "negative": 11044,
                    "neutral": 20214,
                    "positive": 3067
                },
                "authorVolume": 191,
                "reachEstimate": 2141,
                "impact": 7.640020684642537
            },
            "values": [
                {
                    "data": {},
                    "name": "BBC",
                    "value": null,
                    "id": 1999922710
                }
            ],
            "name": "twitter.com",
            "id": "twitter.com"
        },
        {
            "data": {
                "volume": 830,
                "monthlyVisitors": 0,
                "countryName": "United Kingdom",
                "countryCode": "GBR",
                "authorName": "sir-t-bbc",
                "authorGender": null,
                "authorAccountType": null,
                "domain": "tumblr.com",
                "authorProfessions": [],
                "authorInterest": [],
                "sentiment": {
                    "negative": 207,
                    "neutral": 245,
                    "positive": 376
                },
                "authorVolume": 30,
                "reachEstimate": 0,
                "impact": 0.0
            },
            "values": [
                {
                    "data": {},
                    "name": "BBC",
                    "value": null,
                    "id": 1999922710
                }
            ],
            "name": "tumblr.com",
            "id": "tumblr.com"
        },
        {
            "data": {
                "volume": 215,
                "monthlyVisitors": 9594000,
                "countryName": "United Kingdom",
                "countryCode": "GBR",
                "authorName": "Bumnut53",
                "authorGender": null,
                "authorAccountType": null,
                "domain": "hotukdeals.com",
                "authorProfessions": [],
                "authorInterest": [],
                "sentiment": {
                    "negative": 2,
                    "neutral": 210,
                    "positive": 2
                },
                "authorVolume": 10,
                "reachEstimate": 2701,
                "impact": 39.29999918832451
            },
            "values": [
                {
                    "data": {},
                    "name": "BBC",
                    "value": null,
                    "id": 1999922710
                }
            ],
            "name": "hotukdeals.com",
            "id": "hotukdeals.com"
        },
        {
            "data": {
                "volume": 147,
                "monthlyVisitors": 2993000,
                "countryName": "United Kingdom",
                "countryCode": "GBR",
                "authorName": "bettys",
                "authorGender": null,
                "authorAccountType": null,
                "domain": "examplesite.com",
                "authorProfessions": [],
                "authorInterest": [],
                "sentiment": {
                    "negative": 54,
                    "neutral": 76,
                    "positive": 16
                },
                "authorVolume": 16,
                "reachEstimate": 1341,
                "impact": 35.299998141001296
            },
            "values": [
                {
                    "data": {},
                    "name": "BBC",
                    "value": null,
                    "id": 1999922710
                }
            ],
            "name": "examplesite.com",
            "id": "examplesite.com"
        },
        {
            "data": {
                "volume": 125,
                "monthlyVisitors": 8728000,
                "countryName": "United Kingdom",
                "countryCode": "GBR",
                "authorName": "Evo102",
                "authorGender": null,
                "authorAccountType": null,
                "domain": "digitalspy.com",
                "authorProfessions": [],
                "authorInterest": [],
                "sentiment": {
                    "negative": 46,
                    "neutral": 68,
                    "positive": 10
                },
                "authorVolume": 5,
                "reachEstimate": 2479,
                "impact": 37.36087060760756
            },
            "values": [
                {
                    "data": {},
                    "name": "BBC",
                    "value": null,
                    "id": 1999922710
                }
            ],
            "name": "digitalspy.com",
            "id": "digitalspy.com"
        },
        {
            "data": {
                "volume": 106,
                "monthlyVisitors": 317000,
                "countryName": "United Kingdom",
                "countryCode": "GBR",
                "authorName": "",
                "authorGender": null,
                "authorAccountType": null,
                "domain": "theworldnews.net",
                "authorProfessions": [],
                "authorInterest": [],
                "sentiment": {
                    "negative": 40,
                    "neutral": 62,
                    "positive": 2
                },
                "authorVolume": 65,
                "reachEstimate": 185,
                "impact": 27.9000005323893
            },
            "values": [
                {
                    "data": {},
                    "name": "BBC",
                    "value": null,
                    "id": 1999922710
                }
            ],
            "name": "theworldnews.net",
            "id": "theworldnews.net"
        },
        {
            "data": {
                "volume": 87,
                "monthlyVisitors": 200356000,
                "countryName": "United Kingdom",
                "countryCode": "GBR",
                "authorName": "",
                "authorGender": null,
                "authorAccountType": null,
                "domain": "bbc.com",
                "authorProfessions": [],
                "authorInterest": [],
                "sentiment": {
                    "negative": 10,
                    "neutral": 68,
                    "positive": 8
                },
                "authorVolume": 71,
                "reachEstimate": 4803,
                "impact": 88.19999753879046
            },
            "values": [
                {
                    "data": {},
                    "name": "BBC",
                    "value": null,
                    "id": 1999922710
                }
            ],
            "name": "bbc.com",
            "id": "bbc.com"
        },
        {
            "data": {
                "volume": 84,
                "monthlyVisitors": 1859714000,
                "countryName": "United Kingdom",
                "countryCode": "GBR",
                "authorName": "",
                "authorGender": null,
                "authorAccountType": null,
                "domain": "yahoo.com",
                "authorProfessions": [],
                "authorInterest": [],
                "sentiment": {
                    "negative": 27,
                    "neutral": 46,
                    "positive": 10
                },
                "authorVolume": 49,
                "reachEstimate": 4978,
                "impact": 95.47742481724865
            },
            "values": [
                {
                    "data": {},
                    "name": "BBC",
                    "value": null,
                    "id": 1999922710
                }
            ],
            "name": "yahoo.com",
            "id": "yahoo.com"
        },
        {
            "data": {
                "volume": 76,
                "monthlyVisitors": 7184000,
                "countryName": "United Kingdom",
                "countryCode": "GBR",
                "authorName": "Napp",
                "authorGender": null,
                "authorAccountType": null,
                "domain": "thestudentroom.co.uk",
                "authorProfessions": [],
                "authorInterest": [],
                "sentiment": {
                    "negative": 30,
                    "neutral": 30,
                    "positive": 16
                },
                "authorVolume": 13,
                "reachEstimate": 2305,
                "impact": 37.8642875340098
            },
            "values": [
                {
                    "data": {},
                    "name": "BBC",
                    "value": null,
                    "id": 1999922710
                }
            ],
            "name": "thestudentroom.co.uk",
            "id": "thestudentroom.co.uk"
        },
        {
            "data": {
                "volume": 65,
                "monthlyVisitors": 102734000,
                "countryName": "United Kingdom",
                "countryCode": "GBR",
                "authorName": "",
                "authorGender": null,
                "authorAccountType": null,
                "domain": "dailymail.co.uk",
                "authorProfessions": [],
                "authorInterest": [],
                "sentiment": {
                    "negative": 30,
                    "neutral": 21,
                    "positive": 13
                },
                "authorVolume": 62,
                "reachEstimate": 2122,
                "impact": 26.445834145372476
            },
            "values": [
                {
                    "data": {},
                    "name": "BBC",
                    "value": null,
                    "id": 1999922710
                }
            ],
            "name": "dailymail.co.uk",
            "id": "dailymail.co.uk"
        }
    ],
    "aggregate": "volume",
    "dimension1": "topsites",
    "dimension2": "queries"
}