> ## Documentation Index
> Fetch the complete documentation index at: https://testdocs.clodura.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve Company News and Corporate Events via API

> Fetch categorized news articles, announcements, and corporate events for any company — including funding rounds, layoffs, launches, and partnerships.

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](/api/company/search-organizations)) or an `orgLinkedinUrl`, and supply a date range for published articles. The endpoint returns up to 200 articles per request.

<Note>
  **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.
</Note>

## Endpoint

`POST /api/v1/organisation/news`

## Request

### Headers

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

### Body Parameters

<ParamField body="organisationId" type="string">
  Clodura's unique identifier for the company. Obtain this from the [Search Organizations](/api/company/search-organizations) endpoint. Required if `orgLinkedinUrl` is not provided.
</ParamField>

<ParamField body="orgLinkedinUrl" type="string">
  Full LinkedIn Company profile URL (e.g., `https://www.linkedin.com/company/clodura-ai/`). Required if `organisationId` is not provided.
</ParamField>

<ParamField body="publishedSince" type="date" required>
  Start date for filtering news articles by publication date. Format: `YYYY-MM-DD` (e.g., `2024-01-01`).
</ParamField>

<ParamField body="publishedUntil" type="date" required>
  End date for filtering news articles by publication date. Format: `YYYY-MM-DD` (e.g., `2024-12-31`).
</ParamField>

<ParamField body="articleTitle" type="string">
  Exact match filter for a specific article headline. Useful for locating a known article.
</ParamField>

<ParamField body="category" type="array">
  Filter articles by event category. Accepted values: `Acquisition`, `Announcements`, `Bankruptcy`, `Expansion`, `IPO`, `Investment`, `Issue`, `Launch`, `Layoff`, `Partnership`, `Patent`, `Funding`.
</ParamField>

<ParamField body="keywords" type="array">
  Keywords to search within article content (e.g., `Series B`, `new CEO`, `data breach`).
</ParamField>

<ParamField body="page" type="integer">
  Page number to retrieve. Maximum: `100`.
</ParamField>

<Warning>
  You must provide at least one of `organisationId` or `orgLinkedinUrl`. Requests that include neither will be rejected.
</Warning>

## Example Request

<CodeGroup>
  ```bash cURL theme={null}
  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
    }'
  ```

  ```python Python theme={null}
  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())
  ```
</CodeGroup>

## Response

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

<ResponseField name="organisationId" type="string">
  The Clodura ID of the queried organization.
</ResponseField>

<ResponseField name="orgLinkedinUrl" type="string">
  The LinkedIn URL of the queried organization.
</ResponseField>

<ResponseField name="pagination" type="object">
  <Expandable title="pagination fields">
    <ResponseField name="page" type="integer">
      The current page number.
    </ResponseField>

    <ResponseField name="perPage" type="integer">
      Number of articles returned per page.
    </ResponseField>

    <ResponseField name="totalEntries" type="integer">
      Total number of articles matching your filters.
    </ResponseField>

    <ResponseField name="totalPages" type="integer">
      Total number of pages available.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="articles" type="array">
  <Expandable title="article object fields">
    <ResponseField name="articleId" type="string">
      Unique identifier for this news article.
    </ResponseField>

    <ResponseField name="source" type="string">
      Name of the publication or media outlet (e.g., `TechCrunch`, `Reuters`).
    </ResponseField>

    <ResponseField name="articleTitle" type="string">
      Headline of the news article.
    </ResponseField>

    <ResponseField name="articleCategory" type="string">
      Category assigned to this article: `Acquisition`, `Announcements`, `Bankruptcy`, `Expansion`, `IPO`, `Investment`, `Issue`, `Launch`, `Layoff`, `Partnership`, `Patent`, or `Funding`.
    </ResponseField>

    <ResponseField name="description" type="string">
      Summary or excerpt of the article content.
    </ResponseField>

    <ResponseField name="datePosted" type="string">
      ISO 8601 timestamp of when the article was published.
    </ResponseField>

    <ResponseField name="link" type="string">
      Direct URL to the original article.
    </ResponseField>
  </Expandable>
</ResponseField>

### Example Response

```json theme={null}
{
  "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  |

<Tip>
  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.
</Tip>

## 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     |