Top Authors

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

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 Parameters

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

🚧

Maximum Limit

The maximum number of authors returned by this call is limited to 1,000. Requests specifying no limit will default to 10 authors.

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:

{
    "results": [
        {
            "data": {
                "volume": 27,
                "monthlyVisitors": 1000000,
                "countryName": "United Kingdom",
                "countryCode": "GBR",
                "authorName": "subhankar mondal",
                "authorGender": null,
                "authorAccountType": null,
                "domain": "hitc.com",
                "authorProfessions": [],
                "authorInterest": [],
                "sentiment": {
                    "negative": 0,
                    "neutral": 21,
                    "positive": 5
                },
                "authorVolume": 27,
                "reachEstimate": 545,
                "facebookAuthorId": null,
                "facebookComments": 0,
                "facebookLikes": 0,
                "facebookPosts": 0,
                "twitterFollowers": 0,
                "twitterFollowing": 0,
                "twitterRetweets": 0,
                "twitterVerified": false,
                "twitterReplyCount": 0,
                "twitterAtMentions": 0,
                "twitterAvatar": null,
                "twitterPageTitle": "Paul Merson comments on Tottenham Hotspur striker Harry Kane",
                "twitterTweets": 0,
                "impact": 30.99999903995372,
                "redditAwardeeKarma": 0,
                "redditAwarderKarma": 0,
                "redditKarma": 0
            },
            "values": [
                {
                    "data": {},
                    "name": "BBC",
                    "value": null,
                    "id": 1999922710
                }
            ],
            "name": "subhankar mondal",
            "id": "subhankar mondal-hitc.com"
        },
        {
            "data": {
                "volume": 10,
                "monthlyVisitors": 2792000,
                "countryName": "United Kingdom",
                "countryCode": "GBR",
                "authorName": "Lucy Connolly",
                "authorGender": null,
                "authorAccountType": null,
                "domain": "unilad.co.uk",
                "authorProfessions": [],
                "authorInterest": [],
                "sentiment": {
                    "negative": 0,
                    "neutral": 10,
                    "positive": 0
                },
                "authorVolume": 10,
                "reachEstimate": 1274,
                "facebookAuthorId": null,
                "facebookComments": 0,
                "facebookLikes": 0,
                "facebookPosts": 0,
                "twitterFollowers": 0,
                "twitterFollowing": 0,
                "twitterRetweets": 0,
                "twitterVerified": false,
                "twitterReplyCount": 0,
                "twitterAtMentions": 0,
                "twitterAvatar": null,
                "twitterInfluence": 0,
                "twitterOutreach": 0,
                "twitterPageTitle": "Builder Does Poo On Roof He Was Meant To Be Fixing",
                "twitterTweets": 0,
                "impact": 35.09999850756442,
                "redditAwardeeKarma": 0,
                "redditAwarderKarma": 0,
                "redditKarma": 0
            },
            "values": [
                {
                    "data": {},
                    "name": "BBC",
                    "value": null,
                    "id": 1999922710
                }
            ],
            "name": "Lucy Connolly",
            "id": "Lucy Connolly-unilad.co.uk"
        },
        {
            "data": {
                "volume": 8,
                "monthlyVisitors": 317000,
                "countryName": "United Kingdom",
                "countryCode": "GBR",
                "authorName": "\n\n (Image: Getty Images)\n \n\n\n",
                "authorGender": null,
                "authorAccountType": null,
                "domain": "theworldnews.net",
                "authorProfessions": [],
                "authorInterest": [],
                "sentiment": {
                    "negative": 5,
                    "neutral": 2,
                    "positive": 0
                },
                "authorVolume": 8,
                "reachEstimate": 185,
                "facebookAuthorId": null,
                "facebookComments": 0,
                "facebookLikes": 0,
                "facebookPosts": 0,
                "twitterFollowers": 0,
                "twitterFollowing": 0,
                "twitterRetweets": 0,
                "twitterVerified": false,
                "twitterReplyCount": 0,
                "twitterAtMentions": 0,
                "twitterAvatar": null,
                "twitterInfluence": 0,
                "twitterOutreach": 0,
                "twitterPageTitle": "Jamie Laing's Strictly future in serious doubt after suffering worrying injury",
                "twitterTweets": 0,
                "impact": 27.9000005323893,
                "redditAwardeeKarma": 0,
                "redditAwarderKarma": 0,
                "redditKarma": 0
            },
            "values": [
                {
                    "data": {},
                    "name": "BBC",
                    "value": null,
                    "id": 1999922710
                }
            ],
            "name": "\n\n (Image: Getty Images)\n \n\n\n",
            "id": "\n\n (Image: Getty Images)\n \n\n\n-theworldnews.net"
        },
        {
            "data": {
                "volume": 8,
                "monthlyVisitors": 1859714000,
                "countryName": "United Kingdom",
                "countryCode": "GBR",
                "authorName": "Jacob Jarvis",
                "authorGender": null,
                "authorAccountType": null,
                "domain": "yahoo.com",
                "authorProfessions": [],
                "authorInterest": [],
                "sentiment": {
                    "negative": 8,
                    "neutral": 0,
                    "positive": 0
                },
                "authorVolume": 8,
                "reachEstimate": 4977,
                "facebookAuthorId": null,
                "facebookComments": 0,
                "facebookLikes": 0,
                "facebookPosts": 0,
                "twitterFollowers": 0,
                "twitterFollowing": 0,
                "twitterRetweets": 0,
                "twitterVerified": false,
                "twitterReplyCount": 0,
                "twitterAtMentions": 0,
                "twitterAvatar": null,
                "twitterInfluence": 0,
                "twitterOutreach": 0,
                "twitterPageTitle": "Brexit latest: Philip Hammond hits back at claims Tory MPs who vote to block no-deal could be sacked",
                "twitterTweets": 0,
                "impact": 95.40000668541317,
                "redditAwardeeKarma": 0,
                "redditAwarderKarma": 0,
                "redditKarma": 0
            },
            "values": [
                {
                    "data": {},
                    "name": "BBC",
                    "value": null,
                    "id": 1999922710
                }
            ],
            "name": "Jacob Jarvis",
            "id": "Jacob Jarvis-yahoo.com"
        },
        {
            "data": {
                "volume": 8,
                "monthlyVisitors": 32603000,
                "countryName": "United Kingdom",
                "countryCode": "GBR",
                "authorName": "molli mitchell",
                "authorGender": null,
                "authorAccountType": null,
                "domain": "express.co.uk",
                "authorProfessions": [],
                "authorInterest": [],
                "sentiment": {
                    "negative": 0,
                    "neutral": 8,
                    "positive": 0
                },
                "authorVolume": 8,
                "reachEstimate": 3998,
                "facebookAuthorId": null,
                "facebookComments": 0,
                "facebookLikes": 0,
                "facebookPosts": 0,
                "twitterFollowers": 0,
                "twitterFollowing": 0,
                "twitterRetweets": 0,
                "twitterVerified": false,
                "twitterReplyCount": 0,
                "twitterAtMentions": 0,
                "twitterAvatar": null,
                "twitterInfluence": 0,
                "twitterOutreach": 0,
                "twitterPageTitle": "Peaky Blinders season 5: Tommy Shelby in real-life - Was he a real-life gangster? PEAKY BLINDERS season 5 airs every Sunday on BBC One but was the gang’s leader Tommy Shelby a...",
                "twitterTweets": 0,
                "impact": 44.19999998254461,
                "redditAwardeeKarma": 0,
                "redditAwarderKarma": 0,
                "redditKarma": 0
            },
            "values": [
                {
                    "data": {},
                    "name": "BBC",
                    "value": null,
                    "id": 1999922710
                }
            ],
            "name": "molli mitchell",
            "id": "molli mitchell-express.co.uk"
        },
        {
            "data": {
                "volume": 8,
                "monthlyVisitors": 37119000,
                "countryName": "United Kingdom",
                "countryCode": "GBR",
                "authorName": "reuters editorial",
                "authorGender": null,
                "authorAccountType": null,
                "domain": "reuters.com",
                "authorProfessions": [],
                "authorInterest": [],
                "sentiment": {
                    "negative": 0,
                    "neutral": 8,
                    "positive": 0
                },
                "authorVolume": 8,
                "reachEstimate": 4098,
                "facebookAuthorId": null,
                "facebookComments": 0,
                "facebookLikes": 0,
                "facebookPosts": 0,
                "twitterFollowers": 0,
                "twitterFollowing": 0,
                "twitterRetweets": 0,
                "twitterVerified": false,
                "twitterReplyCount": 0,
                "twitterAtMentions": 0,
                "twitterAvatar": null,
                "twitterInfluence": 0,
                "twitterOutreach": 0,
                "twitterPageTitle": "UK's Labour will focus on preventing no-deal Brexit - Starmer",
                "twitterTweets": 0,
                "impact": 44.70000046256775,
                "redditAwardeeKarma": 0,
                "redditAwarderKarma": 0,
                "redditKarma": 0
            },
            "values": [
                {
                    "data": {},
                    "name": "BBC",
                    "value": null,
                    "id": 1999922710
                }
            ],
            "name": "reuters editorial",
            "id": "reuters editorial-reuters.com"
        },
        {
            "data": {
                "volume": 5,
                "monthlyVisitors": 1859714000,
                "countryName": "United Kingdom",
                "countryCode": "GBR",
                "authorName": "Stephanie Cockroft",
                "authorGender": null,
                "authorAccountType": null,
                "domain": "yahoo.com",
                "authorProfessions": [],
                "authorInterest": [],
                "sentiment": {
                    "negative": 5,
                    "neutral": 0,
                    "positive": 0
                },
                "authorVolume": 5,
                "reachEstimate": 4977,
                "facebookAuthorId": null,
                "facebookComments": 0,
                "facebookLikes": 0,
                "facebookPosts": 0,
                "twitterFollowers": 0,
                "twitterFollowing": 0,
                "twitterRetweets": 0,
                "twitterVerified": false,
                "twitterReplyCount": 0,
                "twitterAtMentions": 0,
                "twitterAvatar": null,
                "twitterInfluence": 0,
                "twitterOutreach": 0,
                "twitterPageTitle": "Brexit news: Michael Gove refuses to say if government would abide by legislation blocking no-deal",
                "twitterTweets": 0,
                "impact": 95.40000668541317,
                "redditAwardeeKarma": 0,
                "redditAwarderKarma": 0,
                "redditKarma": 0
            },
            "values": [
                {
                    "data": {},
                    "name": "BBC",
                    "value": null,
                    "id": 1999922710
                }
            ],
            "name": "Stephanie Cockroft",
            "id": "Stephanie Cockroft-yahoo.com"
        },
        {
            "data": {
                "volume": 5,
                "monthlyVisitors": 32603000,
                "countryName": "United Kingdom",
                "countryCode": "GBR",
                "authorName": "charlie milward",
                "authorGender": null,
                "authorAccountType": null,
                "domain": "express.co.uk",
                "authorProfessions": [],
                "authorInterest": [],
                "sentiment": {
                    "negative": 0,
                    "neutral": 5,
                    "positive": 0
                },
                "authorVolume": 5,
                "reachEstimate": 3998,
                "facebookAuthorId": null,
                "facebookComments": 0,
                "facebookLikes": 0,
                "facebookPosts": 0,
                "twitterFollowers": 0,
                "twitterFollowing": 0,
                "twitterRetweets": 0,
                "twitterVerified": false,
                "twitterReplyCount": 0,
                "twitterAtMentions": 0,
                "twitterAvatar": null,
                "twitterInfluence": 0,
                "twitterOutreach": 0,
                "twitterPageTitle": "Countryfile: Fans puzzled over 'political' report in World War II special 'Why the hell?'",
                "twitterTweets": 0,
                "impact": 44.19999998254461,
                "redditAwardeeKarma": 0,
                "redditAwarderKarma": 0,
                "redditKarma": 0
            },
            "values": [
                {
                    "data": {},
                    "name": "BBC",
                    "value": null,
                    "id": 1999922710
                }
            ],
            "name": "charlie milward",
            "id": "charlie milward-express.co.uk"
        },
        {
            "data": {
                "volume": 5,
                "monthlyVisitors": 32603000,
                "countryName": "United Kingdom",
                "countryCode": "GBR",
                "authorName": "kaisha langton",
                "authorGender": null,
                "authorAccountType": null,
                "domain": "express.co.uk",
                "authorProfessions": [],
                "authorInterest": [],
                "sentiment": {
                    "negative": 0,
                    "neutral": 5,
                    "positive": 0
                },
                "authorVolume": 5,
                "reachEstimate": 3998,
                "facebookAuthorId": null,
                "facebookComments": 0,
                "facebookLikes": 0,
                "facebookPosts": 0,
                "twitterFollowers": 0,
                "twitterFollowing": 0,
                "twitterRetweets": 0,
                "twitterVerified": false,
                "twitterReplyCount": 0,
                "twitterAtMentions": 0,
                "twitterAvatar": null,
                "twitterInfluence": 0,
                "twitterOutreach": 0,
                "twitterPageTitle": "Toyah Willcox husband: The secret to 30 year marriage is separate HOUSES",
                "twitterTweets": 0,
                "impact": 44.19999998254461,
                "redditAwardeeKarma": 0,
                "redditAwarderKarma": 0,
                "redditKarma": 0
            },
            "values": [
                {
                    "data": {},
                    "name": "BBC",
                    "value": null,
                    "id": 1999922710
                }
            ],
            "name": "kaisha langton",
            "id": "kaisha langton-express.co.uk"
        },
        {
            "data": {
                "volume": 5,
                "monthlyVisitors": 37119000,
                "countryName": "United Kingdom",
                "countryCode": "GBR",
                "authorName": "paul sandle",
                "authorGender": null,
                "authorAccountType": null,
                "domain": "reuters.com",
                "authorProfessions": [],
                "authorInterest": [],
                "sentiment": {
                    "negative": 0,
                    "neutral": 5,
                    "positive": 0
                },
                "authorVolume": 5,
                "reachEstimate": 4096,
                "facebookAuthorId": null,
                "facebookComments": 0,
                "facebookLikes": 0,
                "facebookPosts": 0,
                "twitterFollowers": 0,
                "twitterFollowing": 0,
                "twitterRetweets": 0,
                "twitterVerified": false,
                "twitterReplyCount": 0,
                "twitterAtMentions": 0,
                "twitterAvatar": null,
                "twitterInfluence": 0,
                "twitterOutreach": 0,
                "twitterPageTitle": "UK lawmakers against no-deal Brexit to bring forward legislation - Reuters",
                "twitterTweets": 0,
                "impact": 44.70000046256775,
                "redditAwardeeKarma": 0,
                "redditAwarderKarma": 0,
                "redditKarma": 0
            },
            "values": [
                {
                    "data": {},
                    "name": "BBC",
                    "value": null,
                    "id": 1999922710
                }
            ],
            "name": "paul sandle",
            "id": "paul sandle-reuters.com"
        }
    ],
    "aggregate": "volume",
    "dimension1": "topauthors",
    "dimension2": "queries"
}