Top Authors
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 authors data. This new response is shown on the updated Top Authors page.
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 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/topauthors/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": "civiliancouture-www.instagram.com",
"name": "civiliancouture",
"values": [
{
"id": 1273272814,
"name": "Battenwear",
"value": null,
"data": {}
}
],
"data": {
"domain": "www.instagram.com",
"pagesPerVisit": 0,
"averageVisits": 0,
"monthlyVisitors": 0,
"percentFemaleVisitors": 0,
"percentMaleVisitors": 0,
"volume": 5,
"countryCode": "us",
"countryName": "United States",
"mozRank": 8.96,
"backlinks": 4574323,
"averageDurationOfVisit": 0,
"impact": 48,
"impactRelevancy": 5,
"impactAmplification": 95,
"impactReach": 31,
"sentiment": {
"positive": 1,
"negative": 0,
"neutral": 4
},
"authorName": "civiliancouture",
"authorVolume": 5,
"authorGender": null,
"authorAccountType": null,
"authorInterest": [
""
],
"authorProfessions": [
{
"profession": "",
"jobTitle": ""
}
],
"authorReach": 0,
"twitterRetweets": 0,
"twitterAvatar": "https://scontent.cdninstagram.com/t51.2885-19/s150x150/21688555_489112284802396_900780347074019328_a.jpg",
"twitterFollowers": 0,
"twitterFollowing": 0,
"twitterReplyCount": 0,
"twitterVerified": false,
"authorCountryCode": "us",
"authorCountryName": "United States",
"authorStateCode": null,
"authorStateName": null,
"authorCountyCode": null,
"authorCountyName": null,
"authorCityCode": null,
"authorCityName": null,
"authorContinentCode": "n-a",
"authorContinentName": "North America",
"twitterPageTitle": "Carousel Post by civiliancouture",
"twitterAtMentions": 0,
"twitterOutreach": 0,
"twitterInfluence": 0,
"twitterTweets": 0,
"facebookLikes": 0,
"facebookAuthorId": null,
"facebookPosts": 5,
"facebookComments": 0
}
},
{
"id": "freshstoretorino-www.instagram.com",
"name": "freshstoretorino",
"values": [
{
"id": 1273272814,
"name": "Battenwear",
"value": null,
"data": {}
}
],
"data": {
"domain": "www.instagram.com",
"pagesPerVisit": 0,
"averageVisits": 0,
"monthlyVisitors": 0,
"percentFemaleVisitors": 0,
"percentMaleVisitors": 0,
"volume": 4,
"countryCode": "it",
"countryName": "Italy",
"mozRank": 8.96,
"backlinks": 4574323,
"averageDurationOfVisit": 0,
"impact": 48,
"impactRelevancy": 4,
"impactAmplification": 95,
"impactReach": 31,
"sentiment": {
"positive": 0,
"negative": 0,
"neutral": 4
},
"authorName": "freshstoretorino",
"authorVolume": 4,
"authorGender": null,
"authorAccountType": null,
"authorInterest": [
""
],
"authorProfessions": [
{
"profession": "",
"jobTitle": ""
}
],
"authorReach": 0,
"twitterRetweets": 0,
"twitterAvatar": "https://scontent.cdninstagram.com/t51.2885-19/925366_581477441975688_1864426796_a.jpg",
"twitterFollowers": 0,
"twitterFollowing": 0,
"twitterReplyCount": 0,
"twitterVerified": false,
"authorCountryCode": "us",
"authorCountryName": "United States",
"authorStateCode": null,
"authorStateName": null,
"authorCountyCode": null,
"authorCountyName": null,
"authorCityCode": null,
"authorCityName": null,
"authorContinentCode": "n-a",
"authorContinentName": "North America",
"twitterPageTitle": "Photo by freshstoretorino",
"twitterAtMentions": 0,
"twitterOutreach": 0,
"twitterInfluence": 0,
"twitterTweets": 0,
"facebookLikes": 0,
"facebookAuthorId": null,
"facebookPosts": 4,
"facebookComments": 0
}
},
{
"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": "Pyrerift-www.reddit.com",
"name": "Pyrerift",
"values": [
{
"id": 1273272814,
"name": "Battenwear",
"value": null,
"data": {}
}
],
"data": {
"domain": "www.reddit.com",
"pagesPerVisit": 0,
"averageVisits": 0,
"monthlyVisitors": 0,
"percentFemaleVisitors": 0,
"percentMaleVisitors": 0,
"volume": 2,
"countryCode": "us",
"countryName": "United States",
"mozRank": 0,
"backlinks": 0,
"averageDurationOfVisit": 0,
"impact": 12,
"impactRelevancy": 2,
"impactAmplification": 0,
"impactReach": 31,
"sentiment": {
"positive": 0,
"negative": 0,
"neutral": 2
},
"authorName": "Pyrerift",
"authorVolume": 2,
"authorGender": null,
"authorAccountType": null,
"authorInterest": [
""
],
"authorProfessions": [
{
"profession": "",
"jobTitle": ""
}
],
"authorReach": 0,
"twitterRetweets": 0,
"twitterAvatar": "",
"twitterFollowers": 0,
"twitterFollowing": 0,
"twitterReplyCount": 0,
"twitterVerified": false,
"authorCountryCode": "us",
"authorCountryName": "United States",
"authorStateCode": null,
"authorStateName": null,
"authorCountyCode": null,
"authorCountyName": null,
"authorCityCode": null,
"authorCityName": null,
"authorContinentCode": "n-a",
"authorContinentName": "North America",
"twitterPageTitle": "Official Weekly Buy/Sell/Trade Thread - November 08, 2017",
"twitterAtMentions": 0,
"twitterOutreach": 0,
"twitterInfluence": 0,
"twitterTweets": 0,
"facebookLikes": 0,
"facebookAuthorId": null,
"facebookPosts": 0,
"facebookComments": 2
}
},
{
"id": "Darcey Alexander-www.facebook.com",
"name": "Darcey Alexander",
"values": [
{
"id": 1273272814,
"name": "Battenwear",
"value": null,
"data": {}
}
],
"data": {
"domain": "www.facebook.com",
"pagesPerVisit": 31,
"averageVisits": 7,
"monthlyVisitors": 910000000000,
"percentFemaleVisitors": 50,
"percentMaleVisitors": 50,
"volume": 1,
"countryCode": "us",
"countryName": "United States",
"mozRank": 9.55,
"backlinks": 33745067,
"averageDurationOfVisit": 25,
"impact": 9,
"impactRelevancy": 1,
"impactAmplification": 0,
"impactReach": 25,
"sentiment": {
"positive": 0,
"negative": 0,
"neutral": 1
},
"authorName": "Darcey Alexander",
"authorVolume": 1,
"authorGender": null,
"authorAccountType": null,
"authorInterest": [
""
],
"authorProfessions": [
{
"profession": "",
"jobTitle": ""
}
],
"authorReach": 0,
"twitterRetweets": 0,
"twitterAvatar": "",
"twitterFollowers": 0,
"twitterFollowing": 0,
"twitterReplyCount": 0,
"twitterVerified": false,
"authorCountryCode": "us",
"authorCountryName": "United States",
"authorStateCode": null,
"authorStateName": null,
"authorCountyCode": null,
"authorCountyName": null,
"authorCityCode": null,
"authorCityName": null,
"authorContinentCode": "n-a",
"authorContinentName": "North America",
"twitterPageTitle": "Wow @t, what a friend!",
"twitterAtMentions": 0,
"twitterOutreach": 0,
"twitterInfluence": 0,
"twitterTweets": 0,
"facebookLikes": 0,
"facebookAuthorId": "10205755431178431",
"facebookPosts": 0,
"facebookComments": 1
}
},
{
"id": "___sacai_-www.instagram.com",
"name": "___sacai_",
"values": [
{
"id": 1273272814,
"name": "Battenwear",
"value": null,
"data": {}
}
],
"data": {
"domain": "www.instagram.com",
"pagesPerVisit": 0,
"averageVisits": 0,
"monthlyVisitors": 0,
"percentFemaleVisitors": 0,
"percentMaleVisitors": 0,
"volume": 1,
"countryCode": "ca",
"countryName": "Canada",
"mozRank": 8.96,
"backlinks": 4574323,
"averageDurationOfVisit": 0,
"impact": 47,
"impactRelevancy": 1,
"impactAmplification": 95,
"impactReach": 31,
"sentiment": {
"positive": 0,
"negative": 0,
"neutral": 1
},
"authorName": "___sacai_",
"authorVolume": 1,
"authorGender": null,
"authorAccountType": null,
"authorInterest": [
""
],
"authorProfessions": [
{
"profession": "",
"jobTitle": ""
}
],
"authorReach": 0,
"twitterRetweets": 0,
"twitterAvatar": "https://scontent.cdninstagram.com/t51.2885-19/s150x150/22070842_139392903464710_8554452917979971584_n.jpg",
"twitterFollowers": 0,
"twitterFollowing": 0,
"twitterReplyCount": 0,
"twitterVerified": false,
"authorCountryCode": "us",
"authorCountryName": "United States",
"authorStateCode": null,
"authorStateName": null,
"authorCountyCode": null,
"authorCountyName": null,
"authorCityCode": null,
"authorCityName": null,
"authorContinentCode": "n-a",
"authorContinentName": "North America",
"twitterPageTitle": "Photo by ___sacai_",
"twitterAtMentions": 0,
"twitterOutreach": 0,
"twitterInfluence": 0,
"twitterTweets": 0,
"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": "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
}
},
{
"id": "blackshaq-www.instagram.com",
"name": "blackshaq",
"values": [
{
"id": 1273272814,
"name": "Battenwear",
"value": null,
"data": {}
}
],
"data": {
"domain": "www.instagram.com",
"pagesPerVisit": 0,
"averageVisits": 0,
"monthlyVisitors": 0,
"percentFemaleVisitors": 0,
"percentMaleVisitors": 0,
"volume": 1,
"countryCode": "us",
"countryName": "United States",
"mozRank": 8.96,
"backlinks": 4574323,
"averageDurationOfVisit": 0,
"impact": 47,
"impactRelevancy": 1,
"impactAmplification": 95,
"impactReach": 31,
"sentiment": {
"positive": 0,
"negative": 0,
"neutral": 1
},
"authorName": "blackshaq",
"authorVolume": 1,
"authorGender": null,
"authorAccountType": null,
"authorInterest": [
""
],
"authorProfessions": [
{
"profession": "",
"jobTitle": ""
}
],
"authorReach": 0,
"twitterRetweets": 0,
"twitterAvatar": "https://scontent.cdninstagram.com/t51.2885-19/11374111_680496552052172_1402531364_a.jpg",
"twitterFollowers": 0,
"twitterFollowing": 0,
"twitterReplyCount": 0,
"twitterVerified": false,
"authorCountryCode": "us",
"authorCountryName": "United States",
"authorStateCode": null,
"authorStateName": null,
"authorCountyCode": null,
"authorCountyName": null,
"authorCityCode": null,
"authorCityName": null,
"authorContinentCode": "n-a",
"authorContinentName": "North America",
"twitterPageTitle": "Photo by blackshaq",
"twitterAtMentions": 0,
"twitterOutreach": 0,
"twitterInfluence": 0,
"twitterTweets": 0,
"facebookLikes": 0,
"facebookAuthorId": null,
"facebookPosts": 1,
"facebookComments": 0
}
},
{
"id": "charliebigpotatos-www.instagram.com",
"name": "charliebigpotatos",
"values": [
{
"id": 1273272814,
"name": "Battenwear",
"value": null,
"data": {}
}
],
"data": {
"domain": "www.instagram.com",
"pagesPerVisit": 0,
"averageVisits": 0,
"monthlyVisitors": 0,
"percentFemaleVisitors": 0,
"percentMaleVisitors": 0,
"volume": 1,
"countryCode": "us",
"countryName": "United States",
"mozRank": 8.96,
"backlinks": 4574323,
"averageDurationOfVisit": 0,
"impact": 47,
"impactRelevancy": 1,
"impactAmplification": 95,
"impactReach": 31,
"sentiment": {
"positive": 0,
"negative": 0,
"neutral": 1
},
"authorName": "charliebigpotatos",
"authorVolume": 1,
"authorGender": null,
"authorAccountType": null,
"authorInterest": [
""
],
"authorProfessions": [
{
"profession": "",
"jobTitle": ""
}
],
"authorReach": 0,
"twitterRetweets": 0,
"twitterAvatar": "https://scontent.cdninstagram.com/t51.2885-19/s150x150/15875671_1750209818640083_71630227612106752_a.jpg",
"twitterFollowers": 0,
"twitterFollowing": 0,
"twitterReplyCount": 0,
"twitterVerified": false,
"authorCountryCode": "us",
"authorCountryName": "United States",
"authorStateCode": null,
"authorStateName": null,
"authorCountyCode": null,
"authorCountyName": null,
"authorCityCode": null,
"authorCityName": null,
"authorContinentCode": "n-a",
"authorContinentName": "North America",
"twitterPageTitle": "Photo by charliebigpotatos",
"twitterAtMentions": 0,
"twitterOutreach": 0,
"twitterInfluence": 0,
"twitterTweets": 0,
"facebookLikes": 0,
"facebookAuthorId": null,
"facebookPosts": 1,
"facebookComments": 0
}
}
]
}
Updated over 5 years ago