Top Tweeters

You can receive an aggregated breakdown of the top Twitter authors 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:xx.xx+xxxx"
endDateThe end of the date range that contains the Mentions."YYYY-MM-DD'T'hh:mm:ss:xx.xx+xxxx"

Optional Parameter

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

Example Call

curl -X GET 'https://api.brandwatch.com/projects/128287432/data/volume/toptweeters/queries?queryId=1273272814&startDate=2017-11-11&endDate=2017-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"
}