Services

ResearchSocialGetListTopUrls

Social Visibility (Facebook, Twitter etc.) per URL for a given domain



Cost per row: 10.00

This call returns the Social Visibility for URLs of a given domain, sorted in descending order by Social Visibility.

The Social Visibility is an indicator for the performance on leading social networks (Facebook, Twitter, LinkedIn, Google+1, Pinterest). Social Visibility includes user actions, such as liking or sharing the domain in the social media space (e.g. via Facebook’s like button). The different user actions are weighted differently depending on the influence of the network. A higher Social Visibility score indicates more popularity and interactions in the social media space.



Parameter description

GET

ParameterDescription
url (required)Either a domain, a subdomain or a directory

Format: domain.tld, subdomain.domain.tld, domain.tld/directory/
limit (optional)Limit for the number of result rows
Permitted values are 10, 25, 50, 100, 250
Default is 10.

Format: integer
offset (optional)Offset for result set
Must be a multiple of allowed values for the parameter "limit"
Default is 0.

Format: integer


Example

HTTP Request:
http://api.searchmetrics.com/v3/ResearchSocialGetListTopUrls.json?url=searchmetrics.com&access_token=xxxxx

Response:
[
   {
         "fb.to" : 47496,
         "tw.to" : 140909,
         "svi" : 2270125,
         "url" : "http://www.ebay.com/",
         "li.to" : 0,
         "gp.to" : 0,
         "pi.to" : 12854
   },
   {
         "fb.to" : 47996,
         "tw.to" : 0,
         "li.to" : 0,
         "url" : "http://esp.ebay.com/",
         "svi" : 1382375,
         "gp.to" : 0,
         "pi.to" : 0
   }
]


Result Description

KeyDescription
fbTotal number of likes, shares and comments for the respective URL on Facebook
twTotal number of shares of the respective URL in Twitter tweets
liTotal number of shares of the respective URL on LinkedIn
urlURL
sviSocial Visibility
gpTotal number of shares of the respective URL on GooglePlus
piTotal number of shares of the respective URL on Pinterest