Skip to main content
The Company News endpoint retrieves news articles, press releases, and corporate events associated with a specific organization. Articles are categorized by event type — such as funding announcements, product launches, layoffs, partnerships, acquisitions, and IPOs — making it straightforward to filter for the signals most relevant to your sales or account management workflow. Funding news, for example, signals new budget and buying potential, while expansion news can indicate greenfield opportunities. You must identify the target company using either an organisationId (from Search Organizations) or an orgLinkedinUrl, and supply a date range for published articles. The endpoint returns up to 200 articles per request.
Credit cost: 2 credits per API request regardless of how many articles are returned.Capacity: Maximum of 200 news articles per company per request. Use pagination (page) to retrieve additional results.

​
Endpoint

POST /api/v1/organisation/news

​
Request

​
Headers

HeaderValue
X-API-KEYYour Clodura API key
Content-Typeapplication/json

​
Body Parameters

​
organisationId
string
Clodura’s unique identifier for the company. Obtain this from the Search Organizations endpoint. Required if orgLinkedinUrl is not provided.
​
orgLinkedinUrl
string
Full LinkedIn Company profile URL (e.g., https://www.linkedin.com/company/clodura-ai/). Required if organisationId is not provided.
​
publishedSince
date
required
Start date for filtering news articles by publication date. Format: YYYY-MM-DD (e.g., 2024-01-01).
​
publishedUntil
date
required
End date for filtering news articles by publication date. Format: YYYY-MM-DD (e.g., 2024-12-31).
​
articleTitle
string
Exact match filter for a specific article headline. Useful for locating a known article.
​
category
array
Filter articles by event category. Accepted values: Acquisition, Announcements, Bankruptcy, Expansion, IPO, Investment, Issue, Launch, Layoff, Partnership, Patent, Funding.
​
keywords
array
Keywords to search within article content (e.g., Series B, new CEO, data breach).
​
page
integer
Page number to retrieve. Maximum: 100.
You must provide at least one of organisationId or orgLinkedinUrl. Requests that include neither will be rejected.

​
Example Request

curl --request POST \
  --url https://api.clodura.ai/api/v1/organisation/news \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "organisationId": "2389402640191586304",
    "publishedSince": "2024-01-01",
    "publishedUntil": "2024-12-31",
    "category": ["Funding", "Partnership"],
    "page": 1
  }'

​
Response

A successful 200 response returns a paginated list of news articles for the specified organization.
​
organisationId
string
The Clodura ID of the queried organization.
​
orgLinkedinUrl
string
The LinkedIn URL of the queried organization.
​
pagination
object
​
articles
array

​
Example Response

{
  "organisationId": "2389402640191586304",
  "orgLinkedinUrl": "https://www.linkedin.com/company/clodura-ai/",
  "pagination": {
    "page": 1,
    "perPage": 20,
    "totalEntries": 150,
    "totalPages": 8
  },
  "articles": [
    {
      "articleId": "art_9988",
      "source": "TechCrunch",
      "articleTitle": "Clodura.AI raises $5M Series A to expand its sales intelligence platform",
      "articleCategory": "Funding",
      "description": "Detailed summary of Clodura's latest funding round and expansion plans...",
      "datePosted": "2024-03-15T10:46:08Z",
      "link": "https://techcrunch.com/2024/03/15/clodura-ai-series-a"
    },
    {
      "articleId": "art_9989",
      "source": "Forbes",
      "articleTitle": "Clodura.AI partners with Salesforce to bring AI-powered insights to CRM",
      "articleCategory": "Partnership",
      "description": "New integration brings Clodura's prospect database directly into Salesforce workflows...",
      "datePosted": "2024-06-20T08:00:00Z",
      "link": "https://www.forbes.com/clodura-salesforce-partnership"
    }
  ]
}

​
News Category Definitions

CategoryDescription
FundingVenture rounds, seed investments, debt financing, and grants
AcquisitionCompanies acquired by the organization
PartnershipStrategic alliances and formal business partnerships
LaunchNew product, service, or feature launches
ExpansionOffice openings, market entries, and geographic growth
LayoffWorkforce reductions and restructuring announcements
IPOInitial public offering announcements or filings
InvestmentCompany investment in or by another organization
AnnouncementsGeneral corporate announcements not fitting other categories
BankruptcyFinancial distress, insolvency, or restructuring filings
PatentIntellectual property filings and grants
IssueRegulatory actions, legal disputes, or public controversies
Use the category filter to zero in on buying signals. Filter for Funding to find companies that recently closed a round and likely have new budget to deploy.

​
Error Codes

StatusMeaning
400Bad request — malformed input or domain count exceeded
401Unauthorized — your API key is missing or invalid
402Payment required — credits exhausted; upgrade your plan or add credits
403Forbidden — this endpoint requires a paid Clodura plan
404Not found — no news articles found for this organization
409Daily rate limit reached — maximum API calls for this endpoint exceeded
422Unprocessable entity — invalid parameter combination or malformed JSON
429Rate limit exceeded — reduce request frequency or upgrade your plan