Skip to main content

The top shared documents that occur in a Saved Search.

GET 
/v3/analytics/:searchId/top_shared

Produces a ranked list of documents matching the Saved Search that were the most shared, from the specified document sources, and within the specified time-range.

The size parameter controls the number of top shared documents produced, defaulting to the top 10 top shared documents.

Any other parameters provided, such as language or country, will further restrict the documents that are included.

The sort_by parameter controls the ranking of the results. For example, if sort_by=retweets, the results will be the top N documents by retweet count. Retweet results are based on when the retweet occured, not the creation date of the original tweet

Request​

Responses​

OK