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

news_event_types

String

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

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

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

Last updated