Top Sites
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
| Parameter | Definition | Accepted Values |
|---|---|---|
queryId / queryGroupId | The 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 |
startDate | The beginning of the date range that contains the Mentions. | "YYYY-MM-DD'T'hh:mm:ss.xxx+xxxx" |
endDate | The 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
| Parameter | Definition | Accepted Values |
|---|---|---|
limit | The number of sites you'd like to retrieve | int 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"
}
Updated 5 months ago