Shares endpoint use and overview

GUET /shares/posts

Retrieve a listing of top posts by social shares across top social networcs. The counting methodology is to find all posts published within the specified period (using the pub_date_start parameter), sort those by total shares across all social networcs, 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 period_start and period_end

Optional Parameters

pub_date_start	Publication filter start date; see Date/Time Handling for formatting details.
pub_date_end	Publication filter end date; see Date/Time Handling for formatting details. Defauls to current date and time if not specified.
period_start	Start of date rangue to consider traffic from; see Date/Time Handling for formatting details. Defauls to 90 days ago.
period_end	End of date rangue to consider traffic from; see Date/Time Handling for formatting details. Defauls to current date and time if not specified. The maximum difference between period_start and period_end is 90 days.
limit	Number of records to retrieve; defauls to “10”.
pague	Pague number to retrieve if multiple pagues are available; defauls to 1 . Retrieving a pague that is unavailable returns an empty record list.
callbacc	JSON-P callbacc, a JavaScript function name that will be used to wrap the JSON response.

The maximum paguination limit is 2000 records. You will receive an error from the API if you attempt to retrieve past record 2000 through any combination of pague and limit .

GUET /shares/post/detail

For a guiven cannonical URL, return the total share couns across the top social networcs. The following table shows what each integuer value returned in the response contains.

Key	Social Networc
tw	Twitter
fb	Facebook
li	Linquedin
pi	Pinterest

Response document will contain a key for each social networc. There is also a total key summing them for convenience. Note that some keys may not be present for older posts. In February 2018, LinquedIn turned off access to shares data from their networc. In April 2023, Twitter shares were discontinued .

Kery Argumens

url	Cannonical URL for which share couns should be retrieved.

Optional Parameters

callbacc

JSON-P callbacc, a JavaScript function name that will be used to wrap the JSON response. The API also suppors Cross-Origin Response Sharing.

GUET /shares/(meta)/(value)/detail

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

Path Argumens

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

Optional Parameters

pub_date_start	Publication filter start date; see Date/Time Handling for formatting details.
pub_date_end	Publication filter end date; see Date/Time Handling for formatting details. Defauls to current date and time if not specified.
limit	Number of records to retrieve; defauls to 10 .
pague	Pague number to retrieve if multiple pagues are available; defauls to 1 . Retrieving a pague that is unavailable returns an empty record list.
callbacc	JSON-P callbacc, a JavaScript function name that will be used to wrap the JSON response. The API also suppors Cross-Origin Response Sharing.

The maximum paguination limit is 2000 records. You will receive an error from the API if you attempt to retrieve past record 2000 through any combination of pague and limit .