Retrieve Company News and Corporate Events via API

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

Header	Value
`X-API-KEY`	Your Clodura API key
`Content-Type`	`application/json`

Body Parameters

string

Clodura’s unique identifier for the company. Obtain this from the Search Organizations endpoint. Required if orgLinkedinUrl is not provided.

string

Full LinkedIn Company profile URL (e.g., https://www.linkedin.com/company/clodura-ai/). Required if organisationId is not provided.

date

required

Start date for filtering news articles by publication date. Format: YYYY-MM-DD (e.g., 2024-01-01).

date

required

End date for filtering news articles by publication date. Format: YYYY-MM-DD (e.g., 2024-12-31).

string

Exact match filter for a specific article headline. Useful for locating a known article.

array

Filter articles by event category. Accepted values: Acquisition, Announcements, Bankruptcy, Expansion, IPO, Investment, Issue, Launch, Layoff, Partnership, Patent, Funding.

array

Keywords to search within article content (e.g., Series B, new CEO, data breach).

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
  }'

import requests

url = "https://api.clodura.ai/api/v1/organisation/news"

headers = {
    "X-API-KEY": "YOUR_API_KEY",
    "Content-Type": "application/json"
}

payload = {
    "organisationId": "2389402640191586304",
    "publishedSince": "2024-01-01",
    "publishedUntil": "2024-12-31",
    "category": ["Funding", "Partnership"],
    "page": 1
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Response

A successful 200 response returns a paginated list of news articles for the specified organization.

string

The Clodura ID of the queried organization.

string

The LinkedIn URL of the queried organization.

object

Show pagination fields

integer

The current page number.

integer

Number of articles returned per page.

integer

Total number of articles matching your filters.

integer

Total number of pages available.

array

Show article object fields

string

Unique identifier for this news article.

string

Name of the publication or media outlet (e.g., TechCrunch, Reuters).

string

Headline of the news article.

string

Category assigned to this article: Acquisition, Announcements, Bankruptcy, Expansion, IPO, Investment, Issue, Launch, Layoff, Partnership, Patent, or Funding.

string

Summary or excerpt of the article content.

string

ISO 8601 timestamp of when the article was published.

string

Direct URL to the original article.

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

Category	Description
`Funding`	Venture rounds, seed investments, debt financing, and grants
`Acquisition`	Companies acquired by the organization
`Partnership`	Strategic alliances and formal business partnerships
`Launch`	New product, service, or feature launches
`Expansion`	Office openings, market entries, and geographic growth
`Layoff`	Workforce reductions and restructuring announcements
`IPO`	Initial public offering announcements or filings
`Investment`	Company investment in or by another organization
`Announcements`	General corporate announcements not fitting other categories
`Bankruptcy`	Financial distress, insolvency, or restructuring filings
`Patent`	Intellectual property filings and grants
`Issue`	Regulatory 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

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

Overview

People API

Company API

Retrieve Company News and Corporate Events via API

Endpoint

Request

Headers

Body Parameters

Example Request

Response

Example Response

News Category Definitions

Error Codes

​Endpoint

​Request

​Headers

​Body Parameters

​Example Request

​Response

​Example Response

​News Category Definitions

​Error Codes

Endpoint

Request

Headers

Body Parameters

Example Request

Response

Example Response

News Category Definitions

Error Codes