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

Mathew Cropper · about a month 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 response to your query returns topics, the Fake News category will appear as below:

    Deprecation notice: ‘mayhem’ category

    Mathew Cropper · 3 months ago

    Today we are announcing a deprecation period for the ‘mayhem’ categories filter. This affects all endpoints that accept the categories filter:

      How we use the API to put together monthly publisher rankings

      Mathew Cropper · 3 months 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 between journalists at different publications. This month, we started to use our Stats API...

        Version 1.10.0

        Mathew Cropper · 5 months ago1 changes

        In this release we removed Syndication features from the v1/articles endpoint, as previously advised in this deprecation notice. The matched_rate and matched_sourceId fields will no lo...

        • 1 broken

        Version 1.9.0

        Philip Tuomey · 6 months ago4 changes

        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 when searching using the full text option.

        Facebook data

        For all endpoints that return Faceboo...

        • 3 added
        • 1 fixed

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

        Mathew Cropper · 7 months 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 customers who have access to our Syndication product and the API. If you do not use the Syndication product...

          Version 1.8.4

          Mathew Cropper · 7 months ago1 changes

          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.topics_filter returned no results. This now works.

          For example, the following filters will now work:

          • 1 fixed

          Version 1.8.3

          Mathew Cropper · 7 months ago1 changes

          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 the correct way to query for more than one URL using cURL.

          Note the escaped " characters, as the...

          • 1 fixed

          Announcing the NewsWhip Developer Hub

          Andrew Mullaney · 7 months 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 extend our deepest welcome from Mathew Cropper, our Product Manager for APIs, and the team at NewsWhip.

            An update to API names

            Mathew Cropper · 8 months 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 the POST API. Finally, the Syndication API, for newswire services.

            We're changing the way that we ref...

              Version 1.8.2

              Mathew Cropper · 8 months ago1 changes

              Fixed an issue where ig_post_text was always blank

              • 1 fixed

              Version 1.8.1

              Mathew Cropper · 9 months ago1 changes

              Fixed an issue where properly formatted queries were being refused with a 400 error

              • 1 fixed

              Version 1.8.0

              Mathew Cropper · about a year ago2 changes

              Need to find the most influential people talking about a subject? This update is for you. We're excited to announce two new endpoints to make it easier than ever before to find Facebook and Twitter influencers.

              • 2 added

              Version 1.7.0

              Mathew Cropper · about a year ago1 changes

              An update to add Predicted Interactions to the v1/articles endpoint.

              • 1 added

              Version 1.6.0

              Mathew Cropper · about a year ago3 changes

              An update to make it easier to search for Facebook posts, and to better control the behaviour of queries when using search defaults.

              • 2 added
              • 1 improved

              Version 1.5.1

              Mathew Cropper · 2 years ago1 changes

              An update to improve documentation for v1/articles.

              • 1 improved

              Version 1.5.0

              Mathew Cropper · 2 years ago3 changes

              Various updates around Facebook engagement.

              • 1 added
              • 1 improved
              • 1 broken

              Version 1.4.0

              Mathew Cropper · 2 years ago2 changes

              An update to improve the v1/articles endpoint and our documentation around it.

              • 1 added
              • 1 improved

              Version 1.3.1

              Mathew Cropper · 3 years ago1 changes

              An update to documentation to fix a typo.

              • 1 fixed

              Version 1.3.0

              Mathew Cropper · 3 years ago2 changes

              An update to make working with regions and keywords easier.

              • 2 added

              Version 1.2.0

              Mathew Cropper · 3 years ago1 changes

              An update to make finding video content easier.

              • 1 added

              Version 1.1.0

              Mathew Cropper · 3 years ago3 changes

              In this release we refined the API to use country codes instead of countries, and deprecated the associated fields for filtering. We also added a new method of sorting.

              • 1 added
              • 2 broken

              Version 1.0.0

              Mathew Cropper · 4 years ago

              This is the first public version of the NewsWhip API.