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.

Known issues

The table below lists any known issues relating to our API.

Found something new? Please head to the forum to inform us of the issue. Our team checks the forum daily.



Pagination is not possible

Our v1 APIs do not offer pagination. If your result set exceeds 5,000 results we recommend decreasing the size of the from and to values.

Values returned in the country_code field may not always be ISO 3166 compliant

We are aware of this issue and are working to cleanse the data to comply with this standard.

LinkedIn data unavailable

On 16th February 2018 LinkedIn removed share metrics from their API. This means that:

  • No LinkedIn share data is available for posts tracked by NewsWhip from that date onwards.
  • LinkedIn share data is incomplete for posts between the 9th February and the 16th February, as we will have been unable to refresh it as usual.

Missing or reduced number of Instagram posts and engagement metrics

As a result of unplanned changes to the Instagram API we experienced the following issues:

  • For dates between 2018-03-30 and 2018-04-04 there are a reduced number of posts available via the /igPosts endpoint. Instagram engagement metrics were also refreshed less frequently than usual.
  • For dates between 2018-04-04 and 2018-04-09, and for all dates after 2018-05-01, no Instagram posts or engagement metrics are available.

Updated 2 years ago

Known issues

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.