News APIs

Use the API playground at https://api.salesintel.io to test the API request and response patterns

Retrieve news articles for identified companies

GET https://api.salesintel.io/service/news

You can use this API to retrieve news articles for a set of companies, specified by domain. Credits are consumed based on the number of articles returned.

Articles can be filtered by content category or type. Further, the response set can be limited by article publish date or by article extraction date (the date SalesIntel identified it). These two dates may be different; if you are looking to get all articles and then keep the full list up to date, extraction date is recommended.

The response set is paginated, with up to 50 records per page. You are charged credits based on the number of records on the pages accessed. If you only retrieve the first page of results out of 10, at a page size of 50, you will be charged for 50 records. The page size is adjustable.

The news article extraction timeframe started on February 20, 2023. 6 months of news data (based on published date) is available, but only starting from that extraction date.

Query Parameters

Name	Type	Description
company_domains*	String	Comma-separated list of domains
extracted_begin_date	String	Returns articles that SalesIntel identified on or after the date, in format yyyyMMdd (20230401)
location_country_codes	String	Comma-separated list of ISO-2 country codes; the same article can appear for multiple country-domain combinations. To ensure uniqueness, use the country code of your target company record
published_begin_date	String	Returns articles that were published on or after the date in format yyyyMMdd (20230401)
news_categories	String	List of news categories separated by comma
news_event_types	String	List of news types separated by comma
page	Integer	Page number
page_size	Integer	If not specified, the default page size is 50 records

Headers

Name	Type	Description
X-CB-ApiKey*		{your API key}
Accept*	String	application/json

Response

200: OK

200: OK

To see the full response, use the playground at https://api.salesintel.io

401: Unauthorized

401: Unauthorized

You have not included your credentials properly in your request

402: Payment Required

402: Payment Required

You do not have enough credits to return any/all of your request

403: Forbidden

403: Forbidden

Your account does not have the necessary permissions to access this service

500: Internal Server Error

500: Internal Server Error

There may be an outage on the SalesIntel side. If the error persists, please contact us

Response Model

{
  "aggregations": {},
  "batch_id": {},
  "error": "string",
  "is_preview": true,
  "page": 0,
  "page_size": 0,
  "result_count": 0,
  "search_results": [
    {
      "article": {
        "article_id": "string",
        "description": "string",
        "extraction_date": "string",
        "link": "string",
        "news_category": "string",
        "news_event_type": "string",
        "published_date": "string",
        "publisher_name": "string",
        "publisher_url": "string",
        "rss_url": "string",
        "title": "string"
      },
      "primary_domain": "string"
      "country": "string"
    }
  ],
  "sort_by": "string",
  "sort_direction": "string",
  "took": 0,
  "total_count": 0,
  "tracking_id": "string"
}

Enums

News Categories and Types

News Category	News Type
Corporate	Awards & Recognition
	Conference Presentation
Financial & Legal	Asset Purchase
	Asset Sales
	Bankruptcy
	Change in Control
	Delisting
	Earnings
	Fraud
	Funding
	Government Contract
	Indictment
	IPO
	JV & Partnerships
	Line of Credit
	Litigation
	M&A
	Name Change
	Other Negative News
	Restructuring
	Stock
	Subsidiary Closing
General	General/Other
Growth & Contraction	Branch Closing
	Branch Management
	Business Closing
	Product Launch
Personnel Changes	Board
	Hiring
	Layoffs
	Leadership Changes
	Workforce Change