Top Shared Sites

You can receive a breakdown of the top sites hosting the most link shares within your query topic 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 (can be specified multiple times) (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.xxx+xxxx"
`endDate`	The end of the date range that contains the Mentions	"YYYY-MM-DD'T'hh:mm:ss.xxx+xxxx"

Note: you can specify the time zone by replacing +xxxx with the ISO UTC offset, e.g -0500 for New York standard time. Important: The character + should be URL encoded to %2B

Optional Parameter

Parameter	Definition	Accepted Values
`limit`	The number of shared sites you'd like to retrieve	int 0-1000

Example Call

curl -X GET 'https://api.brandwatch.com/projects/1998283570/data/sharedsites?startDate=2023-03-06&endDate=2023-03-12&queryId=2000031816'

The results will look like the following:

{
    "results": [
        {
            "label": null,
            "name": "www.screendaily.com",
            "volume": 393,
            "retweets": 393,
            "tweets": 0,
            "impressions": 410503
        },
        {
            "label": null,
            "name": "variety.com",
            "volume": 108,
            "retweets": 106,
            "tweets": 2,
            "impressions": 2648087
        },
        {
            "label": null,
            "name": "www.theverge.com",
            "volume": 32,
            "retweets": 17,
            "tweets": 15,
            "impressions": 2893771
        },
        {
            "label": null,
            "name": "screenrant.com",
            "volume": 27,
            "retweets": 25,
            "tweets": 2,
            "impressions": 202012
        },
        {
            "label": null,
            "name": "www.ellipsiszine.com",
            "volume": 25,
            "retweets": 23,
            "tweets": 2,
            "impressions": 88213
        },
        {
            "label": null,
            "name": "thedirect.com",
            "volume": 21,
            "retweets": 20,
            "tweets": 1,
            "impressions": 49393
        },
        {
            "label": null,
            "name": "www.bbc.co.uk",
            "volume": 20,
            "retweets": 19,
            "tweets": 1,
            "impressions": 589607
        },
        {
            "label": null,
            "name": "www.youtube.com",
            "volume": 20,
            "retweets": 15,
            "tweets": 5,
            "impressions": 146486
        },
        {
            "label": null,
            "name": "tvandcomics.wordpress.com",
            "volume": 16,
            "retweets": 4,
            "tweets": 12,
            "impressions": 7220
        },
        {
            "label": null,
            "name": "www.instagram.com",
            "volume": 13,
            "retweets": 10,
            "tweets": 3,
            "impressions": 33683
        }
    ],
    "orderBy": "volume",
    "orderDirection": "desc"
}

You may also choose how many sites are shown and the order in which they are sorted by using the limit and orderBy parameters, like so:

curl -X GET 'https://api.brandwatch.com/projects/1998283570/data/sharedsites?startDate=2023-03-06&endDate=2023-03-12&queryId=2000031816&limit=10&orderBy=volume'