Welcome to the NewsWhip Developer Hub!

NewsWhip APIs give you raw access to the world’s largest and fastest human engagement database; real time data trends, aggregated data, statistics, and social engagement metrics for hundreds of millions of stories, tracked since January 1, 2018.

Use the power of NewsWhip data to create and customize your own solutions, perfectly suited to your company’s goals. In the hub you'll find the information you need to be successful with our API.

Guide


Documentation about the features of the API, reference data, tutorials, and example use cases.

Go to the guide »

API reference


Interactive documentation, with code examples and guidance.

Go to the API reference »

Our top endpoints

Articles API


Find content based on topic, keyword, publisher, author and more. Discover how that content is performing, and is predicted to perform, on social media.

Go to v1/articles »

Facebook Posts API


Search for Facebook posts from specific authors and publishers, and understand how it's performing.

Go to v1/fbPosts »

Articles by HREFs API


Check article data, along with current and predicted levels of public engagement against multiple URLs per request.

Go to v1/articlesbyhrefs »

Articles API example

The Articles API lets you search for the most popular content or get info on the specific articles you're interested in. In this example, we looked for LadBible's most popular article based on Facebook engagement between March and August 2018.

Not surprisingly, Big Brother Gets Tattoo Of Little Brother With Down's Syndrome On Arm, He Absolutely Loves It topped the list, with over a quarter of a million Facebook engagements in the first 30 days since publication.

Here, you can see the comprehensive dataset returned by our API for this article. Flick through to see Facebook and Twitter engagements, information about the article itself, NewsWhip's topic classifications, author details, and more.

Head over to the API reference to try out the API live! What's the most popular content for your favourite publication?

{
  "articles": [
    {
      "delta_time": 13156,
      "recent_fb_counts": 57069,
      "recent_tw_counts": 28,
      "relatedStories": [],
      "fb_data": {
        "total_engagement_count": 2516415,
        "likes": 2179780,
        "comments": 106299,
        "shares": 230336,
        "total_count_delta": 57069,
        "delta_period": 13156,
        "delta_period_unit": "m",
        "fb_overperforming": 30.533448570072323
      },
      "tw_data": {
        "tw_count": 5420,
        "total_count_delta": 28,
        "delta_period": 13156,
        "delta_period_unit": "m",
        "tw_overperforming": 15.976443008918421
      },
      "li_data": {
        "li_count": 0,
        "total_count_delta": 0,
        "delta_period": 13156,
        "delta_period_unit": "m"
      },
      "pi_data": {
        "pi_count": 2,
        "delta_period": 13156,
        "delta_period_unit": "m"
      },
      "predicted_interactions": 2528113,
      "predicted_timestamp": 1534618685014,
      "uuid": "ee2018e0-95aa-11e8-b9c5-5b7ee2cb8ec6",
      "publication_timestamp": 1533141853000,
      "link": "http://www.ladbible.com/community/feels-big-brother-gets-tattoo-of-little-brother-with-downs-syndrome-on-arm-20180801",
      "headline": "Big Brother Gets Tattoo Of Little Brother With Down's Syndrome On Arm, He Absolutely Loves It",
      "excerpt": "The tattoo was of the LAD's face inside the mouth of a lion and he couldn't believe it as he ran his hand across his brother's arm",
      "keywords": "Community,Down's Syndrome,Feels,Inspirational,Love,Tattoo,brother",
      "source": {
        "publisher": "ladbible.com",
        "link": "http://ladbible.com",
        "country": "United Kingdom",
        "country_code": "gb"
      },
      "image_link": "http://beta.ems.ladbiblegroup.com/s3/content/808x455/d18e23f55b616895484b2bc189cb4a0b.png",
      "has_video": false,
      "nw_score": 35.567722031042315,
      "max_nw_score": 24622.43690704831,
      "topics": [
        {
          "id": 16,
          "name": "For Him"
        },
        {
          "id": 12,
          "name": "Life"
        }
      ],
      "authors": [
        "Rebecca Shepherd"
      ],
      "entities": [
        "LAD"
      ]
    }
  ]
}