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
To see the full response, use the playground at https://api.salesintel.io
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