API Reference

πŸš€

You can access real-time news across all UK private companies, giving you more coverage, faster insights, and richer company intelligence.

βœ… At least 1,000 new articles published every day
βœ… News available within six hours of publication
βœ… Deeper context on company events, funding, and leadership changes

Key details

  • Use your Beauhurst API Key to authorise your request
  • Search with the Companies House IDs of the company you are interested in
  • Use the date range filters to see news articles published before or after a set date

If you are using our older Company News API you will need to use the Company News API Key which can be found in your subscription settings on the platform. Move across to this new version to access news across all companies rather than only our tracked ones and see the news topics mentioned in the articles.


Parameters

limit integer

Number of results to return per page


offset integer

The initial index from which to return the results


company_id string

Companies House ID


article_date_lte string

Return news published before the date provided in YYYY-MM-DD



article_date_gte string

Return news published since the date provided in YYYY-MM-DD



News object

companies_house_ids array

List of Companies House IDs for companies mentioned in the article


headline string

News headline


source string

Source of news article URL


source_title string

Name of news source


news_topics array of strings

List of news topics mentioned in the article



date string

Date of publication in YYYY-MM-DD format


behind_paywall boolean

If the article is behind a paywall