Fetch company news by category
Retrieve recent news for a known company and focus the results on the business events that matter to your workflow. Filter by one or more categories, then page through articles returned in newest-first order.
What you can monitor
Use this endpoint when you already have a Demandbase company ID and want categorized articles instead of a general company news feed.
Track executive change
Watch for leadership changes that may create new priorities, stakeholders, or outreach opportunities.
Spot expansion and investment
Find acquisitions, funding developments, new offerings, partnerships, and expanding operations.
Monitor business pressure
Follow litigation, compliance, data security, cost cutting, restructuring, and other corporate challenges.
Understand momentum
Filter for outperforming or underperforming news to add timely context to account research.
Capture useful source details
Return article titles, links, publication timestamps, sources, images, and matching categories when available.
Process results predictably
Use page metadata and a configurable page size to move through larger news result sets.
Common requests
Find acquisition news
Find leadership changes
Combine categories
Request the next 25 articles
Quickstart
Replace COMPANY_ID with a numeric company ID returned by Company Search, Company Match, or another B2B API workflow.
Send the request
Read the response
Request anatomy
Identify the company
Place the integer Demandbase company ID directly in the request path.
companyId | Required company identifier |
Choose categories and page size
Select one or more categories and optionally control which page is returned.
newsCategories | Required category list |
page | Page number; default 1 |
perPage | Results per page; default 10 |
Authenticate and choose a format
Send a valid bearer token and request JSON or XML.
Authorization | Bearer access token |
Accept | application/json or application/xml |
Response anatomy
The response combines article records with pagination metadata for the requested company.
Company news
title | Article headline |
url | URL for the article |
publicationDate | Publication timestamp |
source | Publishing source |
imageUrl | Article image URL, when available |
newsCategory | Category assigned to the article |
Result-set metadata
pageNo | Returned page number |
pageSize | Requested results per page |
totalCount | Total matching articles |
companyId | Company used for the request |
Some article fields may be absent
Article images and other optional attributes appear only when the publishing source provides them. A valid page with no matching articles returns an empty companyNews array.
Important rules
Use an integer company ID
The companyId path value is required and must be an integer.
Use exact category identifiers
Category identifiers are uppercase and case-sensitive, such as DATA_SECURITY.
Separate values with commas
Pass multiple categories in one newsCategories value. Spaces around comma-separated values are ignored.
Stay within supported limits
page must be at least 1; perPage must be from 1 through 50.
News categories
Use one or more of these exact identifiers in newsCategories. For the shared B2B API reference list, see News Categories Reference.
| Category | Identifier |
|---|---|
| Leadership Changes | LEADERSHIP_ |
| New Offerings | NEW_ |
| Partnerships | PARTNERSHIPS |
| Company Presentation | COMPANY_ |
| Litigation | LITIGATION |
| Compliance | COMPLIANCE |
| Research & Development | RESEARCH_ |
| Data Security | DATA_ |
| Funding Developments | FUNDING_ |
| Category | Identifier |
|---|---|
| Bankruptcy & Restructuring | BANKRUPTCY_ |
| Real Estate: Deals | REALESTATE_ |
| Real Estate: Construction | REALESTATE_ |
| Corporate Challenges | CORPORATE_ |
| Acquisitions | ACQUISITIONS |
| Expanding Operations | EXPANDING_ |
| Cost Cutting | COST_ |
| Outperforming | OUTPERFORMING |
| Underperforming | UNDERPERFORMING |
Parameters
| Parameter | Location | Required | Use it to | Example |
|---|---|---|---|---|
companyId | Path | Yes | Identify the company whose news to fetch. | 725771 |
newsCategories | Query | Yes | Select one or more comma-separated news categories. | ACQUISITIONS,PARTNERSHIPS |
page | Query | No | Select the result page. Minimum 1; default 1. | 2 |
perPage | Query | No | Set the number of results per page. Range 1–50; default 10. | 25 |
Articles are returned newest first
Page through the result set in order to process the most recently published matching articles before older articles.
Common errors
| Status | Error | How to fix it |
|---|---|---|
400-103 |
companyId must be an integer. |
Use the numeric company ID returned by Company Search or another B2B API workflow. |
400-112 |
Invalid news category. | Use one or more exact identifiers from the News categories section, separated by commas. |
400-100 |
Page number must be at least 1. | Set page to 1 or greater. |
400-101 |
perPage must be between 1 and 50. |
Set perPage to a value from 1 through 50. |
401 |
Authentication failed. | Generate a valid token and send it in the Authorization: Bearer YOUR_ACCESS_TOKEN header. |
404-100 |
Invalid ID, record not found. | Confirm the company ID exists and is available to your API Key Set. |
Next steps
Open the interactive endpoint reference, switch to the unfiltered company news feed, or retrieve the company profile behind the news.
Try categorized company news → · Company news feed → · Company details →