Most Shared API

in API

API documentation > Most Shared API

The most shared API returns the most shared content for a specific domain, or topic/keyword. It returns the same results returned by our web interface. You can also use this API to fetch the share counts for a single URL.

Resource URL



1) q (required) This is either a keyword, URL, or a domain/subdomain.

Example Value 1: marketing (returns articles related to marketing)

Example Value 2: (returns share counts for URL)

Example Value 3: (returns most shared content for domain)

Example Value 4: (returns URLs from domain containing “/blog”)

2) result_type (optional) Sort the results by this social network. Default: total, Must be one: total, facebook, twitter, linkedin, pinterest, google_plus

Example Value: total

3) page (optional) the page to get results for. Default: 0, Pages start with 0, so to get the 1st page, pass page = 0.

Example Value: 0

4) num_days (optional) the number of days to search from today. If you pass 7, it will search for articles published in the past 7 days. Default: 1

Example Value: 7

5) article_type (optional) the type of articles to search for, comma separated (no spaces). Values can be any of the following:


By default, all article types are returned.

general_article – articles that are not videos
video – videos (from YouTube or elsewhere)
list – articles that are lists (ie. 10 places to visit)
how_to_article – how to articles (ie. How to cook rice)
what_post – articles whose headline start with “What” (ie. What is minimalism?)
why_post – articles whose headline start with “Why” (ie. Why we need minimum income)
infographic – articles that have infographics

Example Value: list,video

6) begin_date (optional) The begin date to search for in Unix epoch time. If num_days is specified, this field should not be passed, and will be ignored if passed. Only articles published >= this date will be returned.

Example Value: 1444123015

7) end_date (optional) The end date to search for in Unix epoch time. If num_days is specified, this field should not be passed, and will be ignored if passed.

Example Value: 1444123015

8) num_results (optional) The number of results to return. Default: 20

Example Value: 15

9) language (optional) filter results by language. Pass the two letter ISO code:

Example Value: fr

10) tld (optional) filter results by top level domain. Pass just the tld, e.g. for French domains pass “fr”. For UK sites pass “uk”. Note “” is not a top level domain, “uk” is.

Example Value: uk

11) exact_url only return the exact URL if found.

Example Value: true

12) domains (optional) pass one or more domains comma separated to see content just from those sites.

Example Value:,

13) blocked_domains (optional) use to remove unwanted domains from results, also accepts one or more domains separated by a comma

Example Value:,

14) b2b_publishers (optional) only include results from Business to Business publishers.

Example Value: true


Example Request


Example Response

         author_name: "Aleyda Solis",
         alexa_rank: 11711,
         pinterest_shares: 9,
         num_words: 1660,
         twitter_shares: 710,
         language: "en",
         og_url: "",
         video: 0,
         title: "Monitoring web migrations: A checklist for moving from one site to another",
         evergreen_score: 0.96,
         total_shares_with_pinterest: 1164, //deprecated - use total_shares
         article_amplifiers: [
         domain_name: "",
         updated_at: 1518525885,
         facebook_likes: 62,
         id: "3540668502",
         facebook_comments: 5,
         thumbnail: "",
         twitter_user_id: 145875066,
         total_facebook_shares: 223, //total of likes, shares and comments. See note below.
         url: "",
         linkedin_shares: 222,
         facebook_shares: 156,
         num_linking_domains: 2,
         subdomain: "",
         published_date: 1518447454,
         total_shares: 1164,
         article_types: [
         general_article: 1, //deprecated - use article_types
         how_to_article: 0, //deprecated  - use article_types
         infographic: 0, //deprecated - use article_types
         list: 0, //deprecated - use article_types
         what_post: 0, //deprecated - use article_types
         why_post: 0, //deprecated - use article_types
         display_title: "Monitoring web migrations: A checklist for moving from one site to another"

Facebook Data
You’ll notice that for Facebook, we will return the “breakout” of likes, shares and comments on the network.
facebook_shares – total number of shares the URL has had on Facebook
facebook_comments – total number of comments the URL has had on Facebook
facebook_likes – total number of likes the URL has had on Facebook
total_facebook_shares – the sum of likes, shares and comments for the URL on Facebook. This is named total_facebook_shares for historic reasons as we did not use to return the breakout in the other fields.