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

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"

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'

🚧

Default Limit

By default, the top 10 authors will be returned with this request. If you would like to see more authors, you can use the parameter limit and set it to an integer higher than 10.

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
            },
            "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
            },
            "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
            },
            "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
            },
            "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
            },
            "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
            },
            "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
            },
            "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
            },
            "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
            },
            "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
            },
            "values": [
                {
                    "data": {},
                    "name": "BBC",
                    "value": null,
                    "id": 1999922710
                }
            ],
            "name": "paul sandle",
            "id": "paul sandle-reuters.com"
        }
    ],
    "aggregate": "volume",
    "dimension1": "topauthors",
    "dimension2": "queries"
}