Top Tweeters
If you are using the new Consumer Research product, you should be using v2.0 of our documentation. Due to deprecated mention fields found in the updated version of Mention Field Definitions, you will receive a new response when retrieving top tweeters data. This new response is shown on the updated Top Tweeters page.
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 Topics. | 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" |
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:
{
"aggregate": "volume",
"dimension1": "topauthors",
"dimension2": "queries",
"results": [
{
"id": "grants1856-twitter.com",
"name": "grants1856",
"values": [
{
"id": 1273272814,
"name": "Battenwear",
"value": null,
"data": {}
}
],
"data": {
"domain": "twitter.com",
"pagesPerVisit": 22,
"averageVisits": 6,
"monthlyVisitors": 6000000000,
"percentFemaleVisitors": 46,
"percentMaleVisitors": 54,
"volume": 2,
"countryCode": "uk",
"countryName": "United Kingdom",
"mozRank": 9.6,
"backlinks": 49850734,
"averageDurationOfVisit": 20,
"impact": 30,
"impactRelevancy": 2,
"impactAmplification": 29,
"impactReach": 50,
"sentiment": {
"positive": 0,
"negative": 0,
"neutral": 2
},
"authorName": "grants1856",
"authorVolume": 2,
"authorGender": null,
"authorAccountType": "individual",
"authorInterest": [
"Fashion"
],
"authorProfessions": [
{
"profession": "",
"jobTitle": ""
}
],
"authorReach": 1174,
"twitterRetweets": 0,
"twitterAvatar": "https://pbs.twimg.com/profile_images/696247857389662208/1V5L2c40_normal.jpg",
"twitterFollowers": 878,
"twitterFollowing": 216,
"twitterReplyCount": 0,
"twitterVerified": false,
"authorCountryCode": "uk",
"authorCountryName": "United Kingdom",
"authorStateCode": "engb",
"authorStateName": "England",
"authorCountyCode": "li3p",
"authorCountyName": "Lincolnshire",
"authorCityCode": "cl7r",
"authorCityName": "Cleethorpes",
"authorContinentCode": "eu",
"authorContinentName": "Europe",
"twitterPageTitle": "Grants1856 (@grants1856): Battenwear Travel Cap Oliv ...",
"twitterAtMentions": 0,
"twitterOutreach": 0,
"twitterInfluence": 587,
"twitterTweets": 1485,
"facebookLikes": 0,
"facebookAuthorId": null,
"facebookPosts": 2,
"facebookComments": 0
}
},
{
"id": "bennettbuzz-twitter.com",
"name": "bennettbuzz",
"values": [
{
"id": 1273272814,
"name": "Battenwear",
"value": null,
"data": {}
}
],
"data": {
"domain": "twitter.com",
"pagesPerVisit": 22,
"averageVisits": 6,
"monthlyVisitors": 6000000000,
"percentFemaleVisitors": 46,
"percentMaleVisitors": 54,
"volume": 1,
"countryCode": "uk",
"countryName": "United Kingdom",
"mozRank": 9.6,
"backlinks": 49850734,
"averageDurationOfVisit": 20,
"impact": 21,
"impactRelevancy": 1,
"impactAmplification": 28,
"impactReach": 29,
"sentiment": {
"positive": 0,
"negative": 0,
"neutral": 1
},
"authorName": "bennettbuzz",
"authorVolume": 1,
"authorGender": null,
"authorAccountType": "individual",
"authorInterest": [
""
],
"authorProfessions": [
{
"profession": "",
"jobTitle": ""
}
],
"authorReach": 424,
"twitterRetweets": 0,
"twitterAvatar": "https://pbs.twimg.com/profile_images/906817314020102144/N364s6Zy_normal.jpg",
"twitterFollowers": 136,
"twitterFollowing": 391,
"twitterReplyCount": 0,
"twitterVerified": false,
"authorCountryCode": "uk",
"authorCountryName": "United Kingdom",
"authorStateCode": null,
"authorStateName": null,
"authorCountyCode": null,
"authorCountyName": null,
"authorCityCode": null,
"authorCityName": null,
"authorContinentCode": "eu",
"authorContinentName": "Europe",
"twitterPageTitle": "Spaceman (@bennettbuzz): Selling Battenwear Scout A ...",
"twitterAtMentions": 0,
"twitterOutreach": 3,
"twitterInfluence": 424,
"twitterTweets": 1409,
"facebookLikes": 0,
"facebookAuthorId": null,
"facebookPosts": 1,
"facebookComments": 0
}
},
{
"id": "OiPolloi-twitter.com",
"name": "OiPolloi",
"values": [
{
"id": 1273272814,
"name": "Battenwear",
"value": null,
"data": {}
}
],
"data": {
"domain": "twitter.com",
"pagesPerVisit": 22,
"averageVisits": 6,
"monthlyVisitors": 6000000000,
"percentFemaleVisitors": 46,
"percentMaleVisitors": 54,
"volume": 1,
"countryCode": "uk",
"countryName": "United Kingdom",
"mozRank": 9.6,
"backlinks": 49850734,
"averageDurationOfVisit": 20,
"impact": 38,
"impactRelevancy": 1,
"impactAmplification": 30,
"impactReach": 73,
"sentiment": {
"positive": 0,
"negative": 0,
"neutral": 1
},
"authorName": "OiPolloi",
"authorVolume": 1,
"authorGender": null,
"authorAccountType": "organisational",
"authorInterest": [
""
],
"authorProfessions": [
{
"profession": "",
"jobTitle": ""
}
],
"authorReach": 777,
"twitterRetweets": 0,
"twitterAvatar": "https://pbs.twimg.com/profile_images/758237816472076288/GymtbuP3_normal.jpg",
"twitterFollowers": 26859,
"twitterFollowing": 449,
"twitterReplyCount": 0,
"twitterVerified": false,
"authorCountryCode": "uk",
"authorCountryName": "United Kingdom",
"authorStateCode": "engb",
"authorStateName": "England",
"authorCountyCode": "ci0g",
"authorCountyName": "Greater Manchester",
"authorCityCode": "m03x",
"authorCityName": "Manchester",
"authorContinentCode": "eu",
"authorContinentName": "Europe",
"twitterPageTitle": "oipolloi.com (@OiPolloi): Battenwear brings the heav ...",
"twitterAtMentions": 0,
"twitterOutreach": 6,
"twitterInfluence": 777,
"twitterTweets": 9282,
"facebookLikes": 0,
"facebookAuthorId": null,
"facebookPosts": 1,
"facebookComments": 0
}
},
{
"id": "peggsandson-twitter.com",
"name": "peggsandson",
"values": [
{
"id": 1273272814,
"name": "Battenwear",
"value": null,
"data": {}
}
],
"data": {
"domain": "twitter.com",
"pagesPerVisit": 22,
"averageVisits": 6,
"monthlyVisitors": 6000000000,
"percentFemaleVisitors": 46,
"percentMaleVisitors": 54,
"volume": 1,
"countryCode": "uk",
"countryName": "United Kingdom",
"mozRank": 9.6,
"backlinks": 49850734,
"averageDurationOfVisit": 20,
"impact": 34,
"impactRelevancy": 1,
"impactAmplification": 30,
"impactReach": 61,
"sentiment": {
"positive": 0,
"negative": 0,
"neutral": 1
},
"authorName": "peggsandson",
"authorVolume": 1,
"authorGender": null,
"authorAccountType": "individual",
"authorInterest": [
"Family & Parenting"
],
"authorProfessions": [
{
"profession": "",
"jobTitle": ""
}
],
"authorReach": 670,
"twitterRetweets": 0,
"twitterAvatar": "https://pbs.twimg.com/profile_images/877456132297682944/W0sOHUxy_normal.jpg",
"twitterFollowers": 4243,
"twitterFollowing": 1726,
"twitterReplyCount": 0,
"twitterVerified": false,
"authorCountryCode": "uk",
"authorCountryName": "United Kingdom",
"authorStateCode": "engb",
"authorStateName": "England",
"authorCountyCode": "bor7",
"authorCountyName": "City of Brighton & Hove",
"authorCityCode": "brg8",
"authorCityName": "Brighton",
"authorContinentCode": "eu",
"authorContinentName": "Europe",
"twitterPageTitle": "Peggs & son. (@peggsandson): New collections now in sto ...",
"twitterAtMentions": 0,
"twitterOutreach": 5,
"twitterInfluence": 670,
"twitterTweets": 9963,
"facebookLikes": 0,
"facebookAuthorId": null,
"facebookPosts": 1,
"facebookComments": 0
}
},
{
"id": "thehipstore-twitter.com",
"name": "thehipstore",
"values": [
{
"id": 1273272814,
"name": "Battenwear",
"value": null,
"data": {}
}
],
"data": {
"domain": "twitter.com",
"pagesPerVisit": 22,
"averageVisits": 6,
"monthlyVisitors": 6000000000,
"percentFemaleVisitors": 46,
"percentMaleVisitors": 54,
"volume": 1,
"countryCode": "uk",
"countryName": "United Kingdom",
"mozRank": 9.6,
"backlinks": 49850734,
"averageDurationOfVisit": 20,
"impact": 34,
"impactRelevancy": 1,
"impactAmplification": 30,
"impactReach": 62,
"sentiment": {
"positive": 0,
"negative": 0,
"neutral": 1
},
"authorName": "thehipstore",
"authorVolume": 1,
"authorGender": null,
"authorAccountType": "organisational",
"authorInterest": [
""
],
"authorProfessions": [
{
"profession": "",
"jobTitle": ""
}
],
"authorReach": 684,
"twitterRetweets": 0,
"twitterAvatar": "https://pbs.twimg.com/profile_images/641564205393530880/8U8eLEB3_normal.jpg",
"twitterFollowers": 5994,
"twitterFollowing": 616,
"twitterReplyCount": 0,
"twitterVerified": false,
"authorCountryCode": "uk",
"authorCountryName": "United Kingdom",
"authorStateCode": null,
"authorStateName": null,
"authorCountyCode": null,
"authorCountyName": null,
"authorCityCode": null,
"authorCityName": null,
"authorContinentCode": "eu",
"authorContinentName": "Europe",
"twitterPageTitle": "The Hip Store (@thehipstore): Get set for the cold seaso ...",
"twitterAtMentions": 0,
"twitterOutreach": 4,
"twitterInfluence": 684,
"twitterTweets": 4699,
"facebookLikes": 0,
"facebookAuthorId": null,
"facebookPosts": 1,
"facebookComments": 0
}
}
]
}
Updated over 5 years ago