Top X (Twitter) Authors
You can receive an aggregated breakdown of the top X 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 Parameter
| Parameter | Definition | Accepted Values |
|---|---|---|
limit | The number of tweeters you'd like to retrieve | int 0-1000 |
Example Call
curl -X GET 'https://api.brandwatch.com/projects/128287432/data/volume/toptweeters/queries?queryId=1273272814&startDate=2023-11-11&endDate=2023-11-18'
The results will look like the following:
{
"results": [
{
"data": {
"volume": 191,
"monthlyVisitors": 1308696000,
"countryName": "United Kingdom",
"countryCode": "GBR",
"authorName": "AirplayNinja",
"authorGender": null,
"authorAccountType": "individual",
"domain": "twitter.com",
"authorProfessions": [],
"authorInterest": [],
"sentiment": {
"negative": 10,
"neutral": 158,
"positive": 21
},
"authorVolume": 191,
"reachEstimate": 922,
"facebookAuthorId": null,
"facebookComments": 0,
"facebookLikes": 0,
"facebookPosts": 0,
"twitterFollowers": 1635,
"twitterFollowing": 28,
"twitterRetweets": 0,
"twitterVerified": false,
"twitterReplyCount": 0,
"twitterAtMentions": 0,
"twitterAvatar": "https://audiences.brandwatch.com/api/audiences/v1/avatars/twitter/3247144948?token=0924e33bd9e5b3e30fba36cfb243c01c705515ef0abd1426905a9ab09500f9d6",
"twitterPageTitle": "#Firstplay: \"The Divvy-Up Dance\" by Arun Luthra's Konnakol Jazz Project on BBC Asian Network (#bbcasiannetwork)",
"twitterTweets": 327037,
"impact": 1.2642857011941742
},
"values": [
{
"data": {},
"name": "BBC",
"value": null,
"id": 1999922710
}
],
"name": "AirplayNinja",
"id": "AirplayNinja-twitter.com"
},
{
"data": {
"volume": 81,
"monthlyVisitors": 1308696000,
"countryName": "United Kingdom",
"countryCode": "GBR",
"authorName": "my_amigouk",
"authorGender": null,
"authorAccountType": "organisational",
"domain": "twitter.com",
"authorProfessions": [],
"authorInterest": [],
"sentiment": {
"negative": 0,
"neutral": 81,
"positive": 0
},
"authorVolume": 81,
"reachEstimate": 7912,
"facebookAuthorId": null,
"facebookComments": 0,
"facebookLikes": 0,
"facebookPosts": 0,
"twitterFollowers": 21385,
"twitterFollowing": 21418,
"twitterRetweets": 0,
"twitterVerified": false,
"twitterReplyCount": 0,
"twitterAtMentions": 0,
"twitterAvatar": "https://audiences.brandwatch.com/api/audiences/v1/avatars/twitter/21790700?token=6f47858d14995417179c42ea515bea2c226b92fd6d56597a456cb6f292d2a812",
"twitterInfluence": 0,
"twitterOutreach": 0,
"twitterPageTitle": "Match of the Day 2: Ian Wright & Jermaine Jenas discuss Sadio Mane and Mohamed Salah incident https://t.co/fPAWKzMQEM BBC Football https://t.co/2XOjsUN8MY",
"twitterTweets": 825886,
"impact": 39.35666765958726
},
"values": [
{
"data": {},
"name": "BBC",
"value": null,
"id": 1999922710
}
],
"name": "my_amigouk",
"id": "my_amigouk-twitter.com"
},
{
"data": {
"volume": 68,
"monthlyVisitors": 1308696000,
"countryName": "United Kingdom",
"countryCode": "GBR",
"authorName": "Brummie_Steve",
"authorGender": "male",
"authorAccountType": null,
"domain": "twitter.com",
"authorProfessions": [],
"authorInterest": [],
"sentiment": {
"negative": 0,
"neutral": 68,
"positive": 0
},
"authorVolume": 68,
"reachEstimate": 5237,
"facebookAuthorId": null,
"facebookComments": 0,
"facebookLikes": 0,
"facebookPosts": 0,
"twitterFollowers": 10998,
"twitterFollowing": 11190,
"twitterRetweets": 0,
"twitterVerified": false,
"twitterReplyCount": 0,
"twitterAtMentions": 0,
"twitterAvatar": "https://audiences.brandwatch.com/api/audiences/v1/avatars/twitter/4289217222?token=3c526d99b883bc8fa8eadb7e06bd2f8d14a2d708f34257122f2be15f15289f26",
"twitterInfluence": 0,
"twitterOutreach": 0,
"twitterPageTitle": "RT @BoxingNewsMedia Boxing needs video reviews after Charlie Edwards incident, says Eddie Hearn https://t.co/tzx9FhcpQ7 https://t.co/WoBsHsnd4v #BOXING #BOXINGNEWS https://t.co/BOY2NCbc7X",
"twitterTweets": 1022378,
"impact": 33.00000096004628
},
"values": [
{
"data": {},
"name": "BBC",
"value": null,
"id": 1999922710
}
],
"name": "Brummie_Steve",
"id": "Brummie_Steve-twitter.com"
},
{
"data": {
"volume": 57,
"monthlyVisitors": 1308696000,
"countryName": "United Kingdom",
"countryCode": "GBR",
"authorName": "BBCSportScot",
"authorGender": null,
"authorAccountType": "organisational",
"domain": "twitter.com",
"authorProfessions": [],
"authorInterest": [
"Sports",
"TV"
],
"sentiment": {
"negative": 0,
"neutral": 57,
"positive": 0
},
"authorVolume": 57,
"reachEstimate": 22203,
"facebookAuthorId": null,
"facebookComments": 0,
"facebookLikes": 0,
"facebookPosts": 0,
"twitterFollowers": 96437,
"twitterFollowing": 320,
"twitterRetweets": 0,
"twitterVerified": false,
"twitterReplyCount": 0,
"twitterAtMentions": 0,
"twitterAvatar": "https://audiences.brandwatch.com/api/audiences/v1/avatars/twitter/242688474?token=e64896c0c5b6cf854451d1cf81cac2c5d2a383e1d063d2235d10b33caa6e75ac",
"twitterInfluence": 0,
"twitterOutreach": 0,
"twitterPageTitle": "\"Where did he go?\"\n\nIt's am embarrassing moment for Ross County's Ricky Foster against his former club, when he ends up on the floor as Aberdeen's Ryan Hedges shows off some sublime skills.\n\nMatch report and full highlights: https://t.co/rRoinZTXxp https://t.co/hIMTrlohuH",
"twitterTweets": 68089,
"impact": 55.84285633367528
},
"values": [
{
"data": {},
"name": "BBC",
"value": null,
"id": 1999922710
}
],
"name": "BBCSportScot",
"id": "BBCSportScot-twitter.com"
},
{
"data": {
"volume": 46,
"monthlyVisitors": 1308696000,
"countryName": "United Kingdom",
"countryCode": "GBR",
"authorName": "FitbaFanatics",
"authorGender": null,
"authorAccountType": null,
"domain": "twitter.com",
"authorProfessions": [],
"authorInterest": [],
"sentiment": {
"negative": 0,
"neutral": 46,
"positive": 0
},
"authorVolume": 46,
"reachEstimate": 3638,
"facebookAuthorId": null,
"facebookComments": 0,
"facebookLikes": 0,
"facebookPosts": 0,
"twitterFollowers": 6345,
"twitterFollowing": 4868,
"twitterRetweets": 0,
"twitterVerified": false,
"twitterReplyCount": 0,
"twitterAtMentions": 0,
"twitterAvatar": "https://audiences.brandwatch.com/api/audiences/v1/avatars/twitter/60994295?token=909d94d43d52161c12e018e3d450aa98fe8f7c156d7b7f26d26c53e29ecd98ca",
"twitterInfluence": 0,
"twitterOutreach": 0,
"twitterPageTitle": "RT @ScottishCup Here is a last reminder of the numbers for tonight's William Hill Scottish Cup First Round draw. \n\nYou can watch live on Sportscene on BBC Scotland. The draw will take place at approximately 7.35pm.\n\n#ScottishCup https://t.co/2RhGRi02Zk",
"twitterTweets": 315473,
"impact": 26.699999938906146
},
"values": [
{
"data": {},
"name": "BBC",
"value": null,
"id": 1999922710
}
],
"name": "FitbaFanatics",
"id": "FitbaFanatics-twitter.com"
},
{
"data": {
"volume": 43,
"monthlyVisitors": 1308696000,
"countryName": "United Kingdom",
"countryCode": "GBR",
"authorName": "tvhome",
"authorGender": null,
"authorAccountType": "organisational",
"domain": "twitter.com",
"authorProfessions": [],
"authorInterest": [
"TV",
"TV"
],
"sentiment": {
"negative": 0,
"neutral": 43,
"positive": 0
},
"authorVolume": 43,
"reachEstimate": 0,
"facebookAuthorId": null,
"facebookComments": 0,
"facebookLikes": 0,
"facebookPosts": 0,
"twitterFollowers": 92,
"twitterFollowing": 1,
"twitterRetweets": 0,
"twitterVerified": false,
"twitterReplyCount": 0,
"twitterAtMentions": 0,
"twitterAvatar": "https://audiences.brandwatch.com/api/audiences/v1/avatars/twitter/19683716?token=93b78d5a203fd796ebd8ae8e34915ef357b8f20ef41214c4f489c3d05b0f629b",
"twitterInfluence": 0,
"twitterOutreach": 0,
"twitterPageTitle": "At 11:20pm BBC Two introduced \"Life of Crime\" with Gritty #LifeOfCrime https://t.co/oQhwAr8Zdw",
"twitterTweets": 17685,
"impact": 0.0
},
"values": [
{
"data": {},
"name": "BBC",
"value": null,
"id": 1999922710
}
],
"name": "tvhome",
"id": "tvhome-twitter.com"
},
{
"data": {
"volume": 40,
"monthlyVisitors": 1308696000,
"countryName": "United Kingdom",
"countryCode": "GBR",
"authorName": "BBCWalesNews",
"authorGender": null,
"authorAccountType": "individual",
"domain": "twitter.com",
"authorProfessions": [],
"authorInterest": [
"Politics",
"Sports",
"TV"
],
"sentiment": {
"negative": 2,
"neutral": 38,
"positive": 0
},
"authorVolume": 40,
"reachEstimate": 16939,
"facebookAuthorId": null,
"facebookComments": 0,
"facebookLikes": 0,
"facebookPosts": 0,
"twitterFollowers": 92035,
"twitterFollowing": 383,
"twitterRetweets": 0,
"twitterVerified": false,
"twitterReplyCount": 0,
"twitterAtMentions": 0,
"twitterAvatar": "https://audiences.brandwatch.com/api/audiences/v1/avatars/twitter/306197611?token=9f4e3e9dde53a16d02567138c86f18437a635b553ab59f11780a90dd3b5f613c",
"twitterInfluence": 0,
"twitterOutreach": 0,
"twitterPageTitle": "'The one thing that will help is if people don't feed the birds'\nhttps://t.co/3tBRTsLGM0",
"twitterTweets": 69059,
"impact": 52.293333191362855
},
"values": [
{
"data": {},
"name": "BBC",
"value": null,
"id": 1999922710
}
],
"name": "BBCWalesNews",
"id": "BBCWalesNews-twitter.com"
},
{
"data": {
"volume": 40,
"monthlyVisitors": 1308696000,
"countryName": "United Kingdom",
"countryCode": "GBR",
"authorName": "LG1660",
"authorGender": "male",
"authorAccountType": null,
"domain": "twitter.com",
"authorProfessions": [],
"authorInterest": [],
"sentiment": {
"negative": 0,
"neutral": 5,
"positive": 35
},
"authorVolume": 40,
"reachEstimate": 22,
"facebookAuthorId": null,
"facebookComments": 0,
"facebookLikes": 0,
"facebookPosts": 0,
"twitterFollowers": 329,
"twitterFollowing": 1191,
"twitterRetweets": 0,
"twitterVerified": false,
"twitterReplyCount": 0,
"twitterAtMentions": 0,
"twitterAvatar": "https://audiences.brandwatch.com/api/audiences/v1/avatars/twitter/298988974?token=ea1e2e304e5e054ef719487717443a0e70816b6c05873df78157ccead82b6f4f",
"twitterInfluence": 0,
"twitterOutreach": 0,
"twitterPageTitle": "@Jaduk99 Also why on the BBC News website this morning why was yesterday not on the front page https://t.co/PnPDOoYX6g",
"twitterTweets": 1318,
"impact": 1.0600000122187707
},
"values": [
{
"data": {},
"name": "BBC",
"value": null,
"id": 1999922710
}
],
"name": "LG1660",
"id": "LG1660-twitter.com"
},
{
"data": {
"volume": 40,
"monthlyVisitors": 1308696000,
"countryName": "United Kingdom",
"countryCode": "GBR",
"authorName": "bbc5live",
"authorGender": null,
"authorAccountType": "organisational",
"domain": "twitter.com",
"authorProfessions": [],
"authorInterest": [
"Books",
"Sports",
"TV"
],
"sentiment": {
"negative": 2,
"neutral": 32,
"positive": 5
},
"authorVolume": 40,
"reachEstimate": 35989,
"facebookAuthorId": null,
"facebookComments": 0,
"facebookLikes": 0,
"facebookPosts": 0,
"twitterFollowers": 654532,
"twitterFollowing": 18192,
"twitterRetweets": 0,
"twitterVerified": false,
"twitterReplyCount": 0,
"twitterAtMentions": 0,
"twitterAvatar": "https://audiences.brandwatch.com/api/audiences/v1/avatars/twitter/7589572?token=e6d70736280f5c516f3cfe52cf8c7f10656cc54884b3bc52bec07f0774267020",
"twitterInfluence": 0,
"twitterOutreach": 0,
"twitterPageTitle": "RT @5liveSport GOAL for Arsenal?\n\nVAR is checking... No goal.\n\nKolasinac had drifted offside \n\n'It is the right decision' - @bbcjohnmurray \n\nListen on @BBCSounds\n📲⚽️ https://t.co/0kUniX6SeW\n#ARSTOT #5LivePremSunday https://t.co/D58p23YVIR",
"twitterTweets": 112234,
"impact": 66.80000045384006
},
"values": [
{
"data": {},
"name": "BBC",
"value": null,
"id": 1999922710
}
],
"name": "bbc5live",
"id": "bbc5live-twitter.com"
},
{
"data": {
"volume": 40,
"monthlyVisitors": 1308696000,
"countryName": "United Kingdom",
"countryCode": "GBR",
"authorName": "charliefellows_",
"authorGender": "male",
"authorAccountType": "individual",
"domain": "twitter.com",
"authorProfessions": [
{
"profession": "Student",
"jobTitle": "Student"
}
],
"authorInterest": [
"Music"
],
"sentiment": {
"negative": 0,
"neutral": 38,
"positive": 2
},
"authorVolume": 40,
"reachEstimate": 0,
"facebookAuthorId": null,
"facebookComments": 0,
"facebookLikes": 0,
"facebookPosts": 0,
"twitterFollowers": 476,
"twitterFollowing": 641,
"twitterRetweets": 0,
"twitterVerified": false,
"twitterReplyCount": 0,
"twitterAtMentions": 0,
"twitterAvatar": "https://audiences.brandwatch.com/api/audiences/v1/avatars/twitter/2235366555?token=cbac1c846b1212dd97394136654e7029d58198b5dce1dee4cde7234d73aab80b",
"twitterInfluence": 0,
"twitterOutreach": 0,
"twitterPageTitle": "RT @BBCSport \"Manchester United are already looking for shafts of light in the dark, four games into the new Premier League season.\" \n\nMore: https://t.co/K5K2vvjNvk https://t.co/fYGDoinCZB",
"twitterTweets": 242270,
"impact": 0.0
},
"values": [
{
"data": {},
"name": "BBC",
"value": null,
"id": 1999922710
}
],
"name": "charliefellows_",
"id": "charliefellows_-twitter.com"
}
],
"aggregate": "volume",
"dimension1": "topauthors",
"dimension2": "queries"
}
Updated 5 months ago