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, 2014.

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.

New 'Fake News' Category

Posted by Mathew Cropper about a year ago

Today we're making a new Fake News category (ID: 868) available in the API. You'll start seeing this category appear in API responses, and you'll be able to filter your queries using it. If the API...

Deprecation notice: ‘mayhem’ category

Posted by Mathew Cropper about a year ago

Today we are announcing a deprecation period for the ‘mayhem’ categories filter. This affects all endpoints that accept the categories filter: /region. [/articles](/v...

How we use the API to put together monthly publisher rankings

Posted by Mathew Cropper about a year ago

Customers and friends of NewsWhip look forward to our monthly rankings, showing which publishers are getting the most engagement. It often results in lively debate and a little friendly rivalry betwee...

Version 1.10.0

Posted by Mathew Cropper about a year ago

In this release we removed Syndication features from the v1/articles endpoint, as previously advised in this deprecation notice...

Version 1.9.0

Posted by Philip Tuomey about a year ago

In this release, we have made improvements to the Facebook data that we provide in all of our endpoints and also fixed an issue where a low number of results was returned in the v1/articles response...

Deprecation notice: NewsWhip Syndication features in the v1/articles API

Posted by Mathew Cropper about a year ago

Today we are announcing a deprecation period for the matched_rate and matched_sourceId fields in the v1/articles API response. The affected fields are visible to custome...

Version 1.8.4

Posted by Mathew Cropper about a year ago

Two releases in one day! Double whammy. In this update, we fix an issue in the Syndication API where searching by _type and _value in the `syndication_query.to...

Version 1.8.3

Posted by Mathew Cropper about a year ago

This release fixes an issue where filtering for more than one URL in the filters parameter of the v1/articles endpoint would result in a 400 - bad query error. For info, the example below shows...

Announcing the NewsWhip Developer Hub

Posted by Andrew Mullaney about a year ago

On behalf of the API team at NewsWhip, it is my pleasure to announce the launch of our Developer Hub. I can't think of a better day for us to announce the beginning of our community, so let me exten...

An update to API names

Posted by Mathew Cropper about a year ago

Traditionally we've grouped our APIs into three plans. The first, optimised for the most common real-time use cases, was the GET API. The second, with historical data going as far back as 2014, was th...