Trending API

in API

API documentation > Trending API

The Trending API returns the most popular content over the last 24 hours or less. You can optionally use the topic parameter to narrow the search to one or many topics (separated by a comma).

Resource URL

GET http://api.buzzsumo.com/search/trends.json

Parameters

1) search_type (optional) either trending_now for articles sorted by trending score or most_shared for articles sorted by total shares.

2) topic (optional) One or multiple topics. Multiple topics must be separated by a comma e.g. marketing,seo,business.
3) hours (optional) Defaults to 24. Narrow your search to the last few hours to see content just going viral.

4) domains (optional) Instead of using the topic parameter, pass one or more domains (comma separated e.g. example.com,example2.com) to see content just from those sites. Note: this cannot be combined with the topic operator.

5) blocked_domains (optional) use to remove unwanted domains from results, also accepts one or more domains separated by a comma (e.g. spam.com,junk.com)

6) tld (optional) use to filter results to a specific TLD e.g. “uk”.

7) count (optional) the number of results to return. E.g. to return 10 results pass count=10 with your request.

Example Request

GET http://api.buzzsumo.com/search/trends.json?search_type=trending_now&api_key=INSERT_API_KEY&topic=marketing,business&hours=2&blocked_domains=cnn.com&tld=uk&count=10

Example Response

{  
   "results":[  
      {
      "published_date": 1448384041,
      "linkedin_shares": 0,
      "google_plus_shares": 0,
      "twitter_user_id": 5167205,
      "total_shares_with_pinterest": 19502,
      "article_types": [
        "general_article"
      ],
      "twitter_shares": 136,
      "article_amplifiers": [
        "unilad"
      ],
      "og_url": "http:\/\/www.unilad.co.uk\/news\/mafia-warn-isis-to-stay-out-of-new-york\/",
      "url": "http:\/\/www.unilad.co.uk\/news\/mafia-warn-isis-to-stay-out-of-new-york\/",
      "pinterest_shares": 0,
      "id": "912924327",
      "total_shares": 19502,
      "title": "Mafia Warn ISIS To 'Stay Out Of New York'",
      "thumbnail": "http:\/\/cdn.unilad.co.uk\/wp-content\/uploads\/2015\/11\/isisvsmob.jpg",
      "subdomain": "www.unilad.co.uk",
      "author_name": "Unilad",
      "num_words": 374,
      "article_amplifier_images": [
        "http:\/\/pbs.twimg.com\/profile_images\/665363037357006848\/Bj8HSOX3_bigger.jpg"
      ],
      "domain_name": "unilad.co.uk",
      "total_facebook_shares": 19366,
      "trending_score": 450,
      "giveaway": 0,
      "infographic": 0,
      "general_article": 1,
      "guest_post": 0,
      "interview": 0,
      "video": 0
    },
      {
      "published_date": 1448450283,
      "linkedin_shares": 0,
      "google_plus_shares": 0,
      "total_shares_with_pinterest": 7050,
      "article_types": [
        "general_article"
      ],
      "twitter_shares": 67,
      "article_amplifiers": [
        "manutdmen"
      ],
      "og_url": "http:\/\/www.manchestereveningnews.co.uk\/sport\/football\/football-news\/manchester-united-v-psv-eindhoven-10496895",
      "url": "http:\/\/www.manchestereveningnews.co.uk\/sport\/football\/football-news\/manchester-united-v-psv-eindhoven-10496895",
      "pinterest_shares": 0,
      "id": "913255150",
      "total_shares": 7050,
      "title": "Manchester United v PSV Eindhoven: Blind at centre-back, result in Moscow and other things to look out for",
      "thumbnail": "http:\/\/i3.manchestereveningnews.co.uk\/incoming\/article10360480.ece\/ALTERNATES\/s1200\/PA-24175067.jpg",
      "subdomain": "www.manchestereveningnews.co.uk",
      "author_name": "Rob Dawson",
      "num_words": 462,
      "article_amplifier_images": [
        "http:\/\/pbs.twimg.com\/profile_images\/560116179524546560\/oA_YI7Jt_bigger.png"
      ],
      "domain_name": "manchestereveningnews.co.uk",
      "total_facebook_shares": 6983,
      "trending_score": 433,
      "giveaway": 0,
      "infographic": 0,
      "general_article": 1,
      "guest_post": 0,
      "interview": 0,
      "video": 0
    },
   ],
   "total_pages":1,
   "search_type":"trends"
}

Response Fields:

Most of the response fields are self-explanatory and similar to the Most shared (articles.json) API endpoint.

total_shares This is the total number of shares for this article, counting facebook, twitter, linkedin, pinterest, and Google+

total_facebook_shares This is the total number of Facebook shares for this article

total_shares_with_pinterest This is a legacy field, which should always be equal to total_shares. It is safe to ignore.

giveaway Set to 1 if the article is a giveaway article.

guest_post Set to 1 if the article is a guest_post

video Set to 1 if the article is a video

general_article Set to 1 if the article is a general article (this is always 1 if it’s not a video)

published_date Time in epoch time when the article was first published.

thumbnail The og:image or twitter:image tag value if present in the article.

 

API documentation > Trending API

0