Top Authors
You can receive an aggregated breakdown of the top authors 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 authors you'd like to retrieve | int 0-1000 |
Maximum Limit
The maximum number of authors returned by this call is limited to 1,000. Requests specifying no limit will default to 10 authors.
Example Call
curl -X GET 'https://api.brandwatch.com/projects/128287432/data/volume/topauthors/queries?queryId=1273272814&startDate=2023-11-11&endDate=2023-11-18'
The results will look like the following:
{
"results": [
{
"data": {
"volume": 27,
"monthlyVisitors": 1000000,
"countryName": "United Kingdom",
"countryCode": "GBR",
"authorName": "subhankar mondal",
"authorGender": null,
"authorAccountType": null,
"domain": "hitc.com",
"authorProfessions": [],
"authorInterest": [],
"sentiment": {
"negative": 0,
"neutral": 21,
"positive": 5
},
"authorVolume": 27,
"reachEstimate": 545,
"facebookAuthorId": null,
"facebookComments": 0,
"facebookLikes": 0,
"facebookPosts": 0,
"twitterFollowers": 0,
"twitterFollowing": 0,
"twitterRetweets": 0,
"twitterVerified": false,
"twitterReplyCount": 0,
"twitterAtMentions": 0,
"twitterAvatar": null,
"twitterPageTitle": "Paul Merson comments on Tottenham Hotspur striker Harry Kane",
"twitterTweets": 0,
"impact": 30.99999903995372,
"redditAwardeeKarma": 0,
"redditAwarderKarma": 0,
"redditKarma": 0
},
"values": [
{
"data": {},
"name": "BBC",
"value": null,
"id": 1999922710
}
],
"name": "subhankar mondal",
"id": "subhankar mondal-hitc.com"
},
{
"data": {
"volume": 10,
"monthlyVisitors": 2792000,
"countryName": "United Kingdom",
"countryCode": "GBR",
"authorName": "Lucy Connolly",
"authorGender": null,
"authorAccountType": null,
"domain": "unilad.co.uk",
"authorProfessions": [],
"authorInterest": [],
"sentiment": {
"negative": 0,
"neutral": 10,
"positive": 0
},
"authorVolume": 10,
"reachEstimate": 1274,
"facebookAuthorId": null,
"facebookComments": 0,
"facebookLikes": 0,
"facebookPosts": 0,
"twitterFollowers": 0,
"twitterFollowing": 0,
"twitterRetweets": 0,
"twitterVerified": false,
"twitterReplyCount": 0,
"twitterAtMentions": 0,
"twitterAvatar": null,
"twitterInfluence": 0,
"twitterOutreach": 0,
"twitterPageTitle": "Builder Does Poo On Roof He Was Meant To Be Fixing",
"twitterTweets": 0,
"impact": 35.09999850756442,
"redditAwardeeKarma": 0,
"redditAwarderKarma": 0,
"redditKarma": 0
},
"values": [
{
"data": {},
"name": "BBC",
"value": null,
"id": 1999922710
}
],
"name": "Lucy Connolly",
"id": "Lucy Connolly-unilad.co.uk"
},
{
"data": {
"volume": 8,
"monthlyVisitors": 317000,
"countryName": "United Kingdom",
"countryCode": "GBR",
"authorName": "\n\n (Image: Getty Images)\n \n\n\n",
"authorGender": null,
"authorAccountType": null,
"domain": "theworldnews.net",
"authorProfessions": [],
"authorInterest": [],
"sentiment": {
"negative": 5,
"neutral": 2,
"positive": 0
},
"authorVolume": 8,
"reachEstimate": 185,
"facebookAuthorId": null,
"facebookComments": 0,
"facebookLikes": 0,
"facebookPosts": 0,
"twitterFollowers": 0,
"twitterFollowing": 0,
"twitterRetweets": 0,
"twitterVerified": false,
"twitterReplyCount": 0,
"twitterAtMentions": 0,
"twitterAvatar": null,
"twitterInfluence": 0,
"twitterOutreach": 0,
"twitterPageTitle": "Jamie Laing's Strictly future in serious doubt after suffering worrying injury",
"twitterTweets": 0,
"impact": 27.9000005323893,
"redditAwardeeKarma": 0,
"redditAwarderKarma": 0,
"redditKarma": 0
},
"values": [
{
"data": {},
"name": "BBC",
"value": null,
"id": 1999922710
}
],
"name": "\n\n (Image: Getty Images)\n \n\n\n",
"id": "\n\n (Image: Getty Images)\n \n\n\n-theworldnews.net"
},
{
"data": {
"volume": 8,
"monthlyVisitors": 1859714000,
"countryName": "United Kingdom",
"countryCode": "GBR",
"authorName": "Jacob Jarvis",
"authorGender": null,
"authorAccountType": null,
"domain": "yahoo.com",
"authorProfessions": [],
"authorInterest": [],
"sentiment": {
"negative": 8,
"neutral": 0,
"positive": 0
},
"authorVolume": 8,
"reachEstimate": 4977,
"facebookAuthorId": null,
"facebookComments": 0,
"facebookLikes": 0,
"facebookPosts": 0,
"twitterFollowers": 0,
"twitterFollowing": 0,
"twitterRetweets": 0,
"twitterVerified": false,
"twitterReplyCount": 0,
"twitterAtMentions": 0,
"twitterAvatar": null,
"twitterInfluence": 0,
"twitterOutreach": 0,
"twitterPageTitle": "Brexit latest: Philip Hammond hits back at claims Tory MPs who vote to block no-deal could be sacked",
"twitterTweets": 0,
"impact": 95.40000668541317,
"redditAwardeeKarma": 0,
"redditAwarderKarma": 0,
"redditKarma": 0
},
"values": [
{
"data": {},
"name": "BBC",
"value": null,
"id": 1999922710
}
],
"name": "Jacob Jarvis",
"id": "Jacob Jarvis-yahoo.com"
},
{
"data": {
"volume": 8,
"monthlyVisitors": 32603000,
"countryName": "United Kingdom",
"countryCode": "GBR",
"authorName": "molli mitchell",
"authorGender": null,
"authorAccountType": null,
"domain": "express.co.uk",
"authorProfessions": [],
"authorInterest": [],
"sentiment": {
"negative": 0,
"neutral": 8,
"positive": 0
},
"authorVolume": 8,
"reachEstimate": 3998,
"facebookAuthorId": null,
"facebookComments": 0,
"facebookLikes": 0,
"facebookPosts": 0,
"twitterFollowers": 0,
"twitterFollowing": 0,
"twitterRetweets": 0,
"twitterVerified": false,
"twitterReplyCount": 0,
"twitterAtMentions": 0,
"twitterAvatar": null,
"twitterInfluence": 0,
"twitterOutreach": 0,
"twitterPageTitle": "Peaky Blinders season 5: Tommy Shelby in real-life - Was he a real-life gangster? PEAKY BLINDERS season 5 airs every Sunday on BBC One but was the gang’s leader Tommy Shelby a...",
"twitterTweets": 0,
"impact": 44.19999998254461,
"redditAwardeeKarma": 0,
"redditAwarderKarma": 0,
"redditKarma": 0
},
"values": [
{
"data": {},
"name": "BBC",
"value": null,
"id": 1999922710
}
],
"name": "molli mitchell",
"id": "molli mitchell-express.co.uk"
},
{
"data": {
"volume": 8,
"monthlyVisitors": 37119000,
"countryName": "United Kingdom",
"countryCode": "GBR",
"authorName": "reuters editorial",
"authorGender": null,
"authorAccountType": null,
"domain": "reuters.com",
"authorProfessions": [],
"authorInterest": [],
"sentiment": {
"negative": 0,
"neutral": 8,
"positive": 0
},
"authorVolume": 8,
"reachEstimate": 4098,
"facebookAuthorId": null,
"facebookComments": 0,
"facebookLikes": 0,
"facebookPosts": 0,
"twitterFollowers": 0,
"twitterFollowing": 0,
"twitterRetweets": 0,
"twitterVerified": false,
"twitterReplyCount": 0,
"twitterAtMentions": 0,
"twitterAvatar": null,
"twitterInfluence": 0,
"twitterOutreach": 0,
"twitterPageTitle": "UK's Labour will focus on preventing no-deal Brexit - Starmer",
"twitterTweets": 0,
"impact": 44.70000046256775,
"redditAwardeeKarma": 0,
"redditAwarderKarma": 0,
"redditKarma": 0
},
"values": [
{
"data": {},
"name": "BBC",
"value": null,
"id": 1999922710
}
],
"name": "reuters editorial",
"id": "reuters editorial-reuters.com"
},
{
"data": {
"volume": 5,
"monthlyVisitors": 1859714000,
"countryName": "United Kingdom",
"countryCode": "GBR",
"authorName": "Stephanie Cockroft",
"authorGender": null,
"authorAccountType": null,
"domain": "yahoo.com",
"authorProfessions": [],
"authorInterest": [],
"sentiment": {
"negative": 5,
"neutral": 0,
"positive": 0
},
"authorVolume": 5,
"reachEstimate": 4977,
"facebookAuthorId": null,
"facebookComments": 0,
"facebookLikes": 0,
"facebookPosts": 0,
"twitterFollowers": 0,
"twitterFollowing": 0,
"twitterRetweets": 0,
"twitterVerified": false,
"twitterReplyCount": 0,
"twitterAtMentions": 0,
"twitterAvatar": null,
"twitterInfluence": 0,
"twitterOutreach": 0,
"twitterPageTitle": "Brexit news: Michael Gove refuses to say if government would abide by legislation blocking no-deal",
"twitterTweets": 0,
"impact": 95.40000668541317,
"redditAwardeeKarma": 0,
"redditAwarderKarma": 0,
"redditKarma": 0
},
"values": [
{
"data": {},
"name": "BBC",
"value": null,
"id": 1999922710
}
],
"name": "Stephanie Cockroft",
"id": "Stephanie Cockroft-yahoo.com"
},
{
"data": {
"volume": 5,
"monthlyVisitors": 32603000,
"countryName": "United Kingdom",
"countryCode": "GBR",
"authorName": "charlie milward",
"authorGender": null,
"authorAccountType": null,
"domain": "express.co.uk",
"authorProfessions": [],
"authorInterest": [],
"sentiment": {
"negative": 0,
"neutral": 5,
"positive": 0
},
"authorVolume": 5,
"reachEstimate": 3998,
"facebookAuthorId": null,
"facebookComments": 0,
"facebookLikes": 0,
"facebookPosts": 0,
"twitterFollowers": 0,
"twitterFollowing": 0,
"twitterRetweets": 0,
"twitterVerified": false,
"twitterReplyCount": 0,
"twitterAtMentions": 0,
"twitterAvatar": null,
"twitterInfluence": 0,
"twitterOutreach": 0,
"twitterPageTitle": "Countryfile: Fans puzzled over 'political' report in World War II special 'Why the hell?'",
"twitterTweets": 0,
"impact": 44.19999998254461,
"redditAwardeeKarma": 0,
"redditAwarderKarma": 0,
"redditKarma": 0
},
"values": [
{
"data": {},
"name": "BBC",
"value": null,
"id": 1999922710
}
],
"name": "charlie milward",
"id": "charlie milward-express.co.uk"
},
{
"data": {
"volume": 5,
"monthlyVisitors": 32603000,
"countryName": "United Kingdom",
"countryCode": "GBR",
"authorName": "kaisha langton",
"authorGender": null,
"authorAccountType": null,
"domain": "express.co.uk",
"authorProfessions": [],
"authorInterest": [],
"sentiment": {
"negative": 0,
"neutral": 5,
"positive": 0
},
"authorVolume": 5,
"reachEstimate": 3998,
"facebookAuthorId": null,
"facebookComments": 0,
"facebookLikes": 0,
"facebookPosts": 0,
"twitterFollowers": 0,
"twitterFollowing": 0,
"twitterRetweets": 0,
"twitterVerified": false,
"twitterReplyCount": 0,
"twitterAtMentions": 0,
"twitterAvatar": null,
"twitterInfluence": 0,
"twitterOutreach": 0,
"twitterPageTitle": "Toyah Willcox husband: The secret to 30 year marriage is separate HOUSES",
"twitterTweets": 0,
"impact": 44.19999998254461,
"redditAwardeeKarma": 0,
"redditAwarderKarma": 0,
"redditKarma": 0
},
"values": [
{
"data": {},
"name": "BBC",
"value": null,
"id": 1999922710
}
],
"name": "kaisha langton",
"id": "kaisha langton-express.co.uk"
},
{
"data": {
"volume": 5,
"monthlyVisitors": 37119000,
"countryName": "United Kingdom",
"countryCode": "GBR",
"authorName": "paul sandle",
"authorGender": null,
"authorAccountType": null,
"domain": "reuters.com",
"authorProfessions": [],
"authorInterest": [],
"sentiment": {
"negative": 0,
"neutral": 5,
"positive": 0
},
"authorVolume": 5,
"reachEstimate": 4096,
"facebookAuthorId": null,
"facebookComments": 0,
"facebookLikes": 0,
"facebookPosts": 0,
"twitterFollowers": 0,
"twitterFollowing": 0,
"twitterRetweets": 0,
"twitterVerified": false,
"twitterReplyCount": 0,
"twitterAtMentions": 0,
"twitterAvatar": null,
"twitterInfluence": 0,
"twitterOutreach": 0,
"twitterPageTitle": "UK lawmakers against no-deal Brexit to bring forward legislation - Reuters",
"twitterTweets": 0,
"impact": 44.70000046256775,
"redditAwardeeKarma": 0,
"redditAwarderKarma": 0,
"redditKarma": 0
},
"values": [
{
"data": {},
"name": "BBC",
"value": null,
"id": 1999922710
}
],
"name": "paul sandle",
"id": "paul sandle-reuters.com"
}
],
"aggregate": "volume",
"dimension1": "topauthors",
"dimension2": "queries"
}
Updated 4 months ago