Shares

GET /shares/posts

Beta. Retrieve a listing of top posts by social shares across top social networks. The counting methodology is to find all posts published within the specified period (using the pub_days parameter), sort those by total shares across all social networks, and then return those top posts. By default only total shares are returned. To find out the number of shares within a time period, specify day or period_start and period_end

Optional parameters

pub_days Number of days since the article has been published to consider for _shares value. Use pub_days=1 or pub_days=3 to only consider shares from last several days.
pub_date_start Publication date of articles to consider for _shares value. Publication date in YYYY-MM-DD format, e.g. 2012-01-01 for January 1, 2012. Must be specified with pub_date_end.
pub_date_end Publication date of articles to consider for _shares value. Publication end date; must be specified with pub_date_start, must be greater than that value, and must not be in the future.
days Number of days since today to consider for shares. Use days=1 or days=3 to only consider traffic from last several days.
period_start Period of data to cover in YYYY-MM-DD format, e.g. 2012-01-01 for January 1, 2012. Must be specified with period_end.
period_end Period of data to cover; must be specified with period_start, must be greater than that value, and must not be in the future.
limit Number of records to retrieve; defaults to "10".
page Page number to retrieve if multiple pages are available; defaults to 1. Retrieving a page that is unavailable returns an empty record list.
callback JSON-P callback, a JavaScript function name that will be used to wrap the JSON response.

GET /shares/post/detail

Beta. For a given canonical URL, return the total share counts across the top social networks. The following table shows what each integer value returned in the response contains.

Key Social Network
tw Twitter
fb Facebook
li Linkedin
pi Pinterest

Response document will contain a key for each social network. There is also a total key summing them for convenience. Note that some keys may not be present for older posts.

Path arguments

url Canonical URL for which share counts should be retrieved.

Optional parameters

callback JSON-P callback, a JavaScript function name that will be used to wrap the JSON response.

GET /shares/(meta)/(value)/detail

Returns a list of posts falling under the specified author, section or tag.

Path arguments

meta one of author, section, tag
value The value of the the author, section or tag

Optional parameters

pub_date_start Publication date in YYYY-MM-DD format, e.g. 2012-01-01 for January 1, 2012. Must be specified with pub_date_end.
pub_date_end Publication end date; must be specified with pub_date_start, must be greater than that value, and must not be in the future.
limit Number of records to retrieve; defaults to 10.
page Page number to retrieve if multiple pages are available; defaults to 1. Retrieving a page that is unavailable returns an empty record list.
callback JSON-P callback, a JavaScript function name that will be used to wrap the JSON response.
Do you have an urgent support question?