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 (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'
Updated 3 months ago