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

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:xx.xx+xxxx"

endDate

The end of the date range that contains the Mentions.

"YYYY-MM-DD'T'hh:mm:ss:xx.xx+xxxx"

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=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"
}