> For the complete documentation index, see [llms.txt](https://docs.intellizence.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.intellizence.com/company-api/search-signals-by-company-domain/sample-requests.md).

# Intellizence Company News Signals API Sample Requests

## Company News Signals API Sample Requests

Use these sample API requests to retrieve curated company news signals from the Intellizence Company News Signals API.

These examples show common ways to search company news by company domain, trigger code, news published date range, and limit.

{% hint style="info" %}
All request parameters are optional. You can use a single filter or combine multiple filters based on your use case.
{% endhint %}

***

### Endpoint

```http
POST https://connect.intellizence.com/api/news
```

### Authentication

Include your API key in the request header.

```http
x-api-key: YOUR_API_KEY
```

### Content Type

```http
Content-Type: application/json
```

***

## Sample API Requests

### 1. Search Latest News Signals for a Company Domain

Use `companyDomains` to retrieve curated company news signals for a specific company website domain.

This is recommended for CRM enrichment, account monitoring, signal-based selling, workflow automation, and AI agents because domains are usually more precise than company names.

#### Request Body

```json
{
  "companyDomains": [
    "openai.com"
  ],
  "limit": 10
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/news \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "companyDomains": [
      "openai.com"
    ],
    "limit": 10
  }'
```

***

### 2. Search News Signals for Multiple Company Domains

Use `companyDomains` to search news signals for multiple companies in a single request.

#### Request Body

```json
{
  "companyDomains": [
    "openai.com",
    "anthropic.com",
    "databricks.com"
  ],
  "limit": 25
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/news \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "companyDomains": [
      "openai.com",
      "anthropic.com",
      "databricks.com"
    ],
    "limit": 25
  }'
```

***

### 3. Search News Signals Within a Date Range

Use `startDate` and `endDate` to retrieve company news signals published during a specific period.

Dates should be provided in `YYYY-MM-DD` format.

#### Request Body

```json
{
  "companyDomains": [
    "openai.com"
  ],
  "startDate": "2026-01-01",
  "endDate": "2026-01-31",
  "limit": 25
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/news \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "companyDomains": [
      "openai.com"
    ],
    "startDate": "2026-01-01",
    "endDate": "2026-01-31",
    "limit": 25
  }'
```

***

### 4. Search M\&A News Signals

Use `triggerCodes` to filter company news by specific Intellizence signal types.

Use `KW_518` to retrieve Merger & Acquisition signals.

#### Request Body

```json
{
  "companyDomains": [
    "openai.com",
    "anthropic.com"
  ],
  "triggerCodes": [
    "KW_518"
  ],
  "startDate": "2026-01-01",
  "endDate": "2026-01-31",
  "limit": 20
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/news \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "companyDomains": [
      "openai.com",
      "anthropic.com"
    ],
    "triggerCodes": [
      "KW_518"
    ],
    "startDate": "2026-01-01",
    "endDate": "2026-01-31",
    "limit": 20
  }'
```

***

### 5. Search Startup Funding and Investment Signals

Use funding and investment trigger codes to retrieve company news related to fundraising and investments.

Common trigger codes:

* `KW_514`: Fundraising
* `KW_708`: Investment

#### Request Body

```json
{
  "companyDomains": [
    "anthropic.com",
    "databricks.com"
  ],
  "triggerCodes": [
    "KW_514",
    "KW_708"
  ],
  "startDate": "2026-01-01",
  "endDate": "2026-01-31",
  "limit": 20
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/news \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "companyDomains": [
      "anthropic.com",
      "databricks.com"
    ],
    "triggerCodes": [
      "KW_514",
      "KW_708"
    ],
    "startDate": "2026-01-01",
    "endDate": "2026-01-31",
    "limit": 20
  }'
```

***

### 6. Search Leadership Change Signals

Use leadership and management change trigger codes to retrieve executive change, appointment, and organizational restructuring news.

Common trigger codes:

* `KW_502`: Executive Change
* `KW_591`: Executive Appointment
* `KW_536`: Organizational Restructuring

#### Request Body

```json
{
  "companyDomains": [
    "microsoft.com",
    "salesforce.com"
  ],
  "triggerCodes": [
    "KW_502",
    "KW_591",
    "KW_536"
  ],
  "startDate": "2026-01-01",
  "endDate": "2026-01-31",
  "limit": 20
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/news \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "companyDomains": [
      "microsoft.com",
      "salesforce.com"
    ],
    "triggerCodes": [
      "KW_502",
      "KW_591",
      "KW_536"
    ],
    "startDate": "2026-01-01",
    "endDate": "2026-01-31",
    "limit": 20
  }'
```

***

### 7. Search Business Expansion and Hiring Signals

Use business expansion and hiring trigger codes to retrieve signals related to company growth, new locations, hiring, and relocation.

Common trigger codes:

* `KW_527`: Business Expansion
* `KW_529`: Hiring
* `KW_640`: Branch/Store Opening
* `KW_713`: Relocation

#### Request Body

```json
{
  "companyDomains": [
    "amazon.com",
    "tesla.com"
  ],
  "triggerCodes": [
    "KW_527",
    "KW_529",
    "KW_640",
    "KW_713"
  ],
  "startDate": "2026-01-01",
  "endDate": "2026-01-31",
  "limit": 20
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/news \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "companyDomains": [
      "amazon.com",
      "tesla.com"
    ],
    "triggerCodes": [
      "KW_527",
      "KW_529",
      "KW_640",
      "KW_713"
    ],
    "startDate": "2026-01-01",
    "endDate": "2026-01-31",
    "limit": 20
  }'
```

***

### 8. Search Layoff, Cost-Cutting, and Restructuring Signals

Use layoff and cost-cutting trigger codes to retrieve workforce reduction, downsizing, restructuring, and cost reduction signals.

Common trigger codes:

* `KW_528`: Downsizing / Layoff
* `KW_687`: Cost-Cutting
* `KW_536`: Organizational Restructuring

#### Request Body

```json
{
  "companyDomains": [
    "intel.com",
    "cisco.com"
  ],
  "triggerCodes": [
    "KW_528",
    "KW_687",
    "KW_536"
  ],
  "startDate": "2026-01-01",
  "endDate": "2026-01-31",
  "limit": 20
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/news \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "companyDomains": [
      "intel.com",
      "cisco.com"
    ],
    "triggerCodes": [
      "KW_528",
      "KW_687",
      "KW_536"
    ],
    "startDate": "2026-01-01",
    "endDate": "2026-01-31",
    "limit": 20
  }'
```

***

### 9. Search Product Launch Signals

Use product and service launch trigger codes to retrieve company news related to new products, services, platforms, features, and commercial launches.

Common trigger codes:

* `KW_521`: Product Launch
* `KW_566`: Service Launch
* `KW_642`: Platform Launch

#### Request Body

```json
{
  "companyDomains": [
    "hubspot.com",
    "shopify.com",
    "stripe.com"
  ],
  "triggerCodes": [
    "KW_521",
    "KW_566",
    "KW_642"
  ],
  "startDate": "2026-01-01",
  "endDate": "2026-01-31",
  "limit": 20
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/news \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "companyDomains": [
      "hubspot.com",
      "shopify.com",
      "stripe.com"
    ],
    "triggerCodes": [
      "KW_521",
      "KW_566",
      "KW_642"
    ],
    "startDate": "2026-01-01",
    "endDate": "2026-01-31",
    "limit": 20
  }'
```

***

### 10. Search Adverse and Negative News Signals

Use adverse and negative news trigger codes to monitor company risk signals such as layoffs, cost-cutting, bankruptcy, business shutdowns, restructuring, and financial distress.

Common trigger codes:

* `KW_528`: Downsizing / Layoff
* `KW_687`: Cost-Cutting
* `KW_536`: Organizational Restructuring
* `KW_584`: Bankruptcy
* `KW_586`: Business Shutdown
* `KW_641`: Financial Distress

#### Request Body

```json
{
  "companyDomains": [
    "salesforce.com",
    "workday.com",
    "servicenow.com"
  ],
  "triggerCodes": [
    "KW_528",
    "KW_687",
    "KW_536",
    "KW_584",
    "KW_586",
    "KW_641"
  ],
  "startDate": "2026-01-01",
  "endDate": "2026-01-31",
  "limit": 50
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/news \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "companyDomains": [
      "salesforce.com",
      "workday.com",
      "servicenow.com"
    ],
    "triggerCodes": [
      "KW_528",
      "KW_687",
      "KW_536",
      "KW_584",
      "KW_586",
      "KW_641"
    ],
    "startDate": "2026-01-01",
    "endDate": "2026-01-31",
    "limit": 50
  }'
```

***

## Use Case Examples

### 1. Daily Company News Monitoring

Use this example when you want to pull recent company news signals into your application, CRM, dashboard, or AI workflow.

#### Recommended Filters

```json
{
  "companyDomains": [
    "openai.com",
    "anthropic.com",
    "databricks.com"
  ],
  "startDate": "2026-01-01",
  "endDate": "2026-01-31",
  "limit": 100
}
```

#### Best For

* Daily company monitoring
* CRM enrichment
* Account intelligence
* Internal dashboards
* AI agent workflows

***

### 2. Sales and Prospecting Signals

Use this example to identify sales-relevant company events such as funding, M\&A, leadership changes, expansion, hiring, partnerships, and product launches.

#### Recommended Filters

```json
{
  "companyDomains": [
    "openai.com",
    "anthropic.com",
    "databricks.com"
  ],
  "triggerCodes": [
    "KW_514",
    "KW_708",
    "KW_518",
    "KW_502",
    "KW_591",
    "KW_527",
    "KW_529",
    "KW_512",
    "KW_513",
    "KW_521"
  ],
  "startDate": "2026-01-01",
  "endDate": "2026-01-31",
  "limit": 100
}
```

#### Best For

* Prospecting
* Signal-based selling
* Account prioritization
* Trigger-based outreach
* Sales and marketing campaigns

***

### 3. Customer / Account Intelligence: Growth and Risk Signals

Use this example to monitor both growth and risk signals across customers, target accounts, partners, competitors, or watchlists. Growth signals may indicate expansion, upsell, cross-sell, or competitive movement, while risk signals may indicate churn, downsell, renewal risk, or business uncertainty.

#### Recommended Filters

```json
{
  "companyDomains": [
    "hubspot.com",
    "shopify.com",
    "stripe.com"
  ],
  "triggerCodes": [
    "KW_514",
    "KW_708",
    "KW_527",
    "KW_529",
    "KW_521",
    "KW_512",
    "KW_502",
    "KW_528",
    "KW_687",
    "KW_536",
    "KW_584",
    "KW_586",
    "KW_641"
  ],
  "startDate": "2026-01-01",
  "endDate": "2026-01-31",
  "limit": 100
}
```

#### Best For

* Customer intelligence
* Account monitoring
* Expansion and upsell signals
* Renewal and churn risk monitoring
* Watchlist intelligence

***

### 4. Risk and Adverse News Monitoring

Use this example to monitor adverse company events such as layoffs, cost-cutting, restructuring, bankruptcy, financial distress, and business shutdowns.

#### Recommended Filters

```json
{
  "companyDomains": [
    "salesforce.com",
    "workday.com",
    "servicenow.com"
  ],
  "triggerCodes": [
    "KW_528",
    "KW_687",
    "KW_536",
    "KW_584",
    "KW_586",
    "KW_641"
  ],
  "startDate": "2026-01-01",
  "endDate": "2026-01-31",
  "limit": 100
}
```

#### Best For

* Risk monitoring
* Customer risk detection
* Vendor risk monitoring
* Churn and downsell risk workflows
* Financial distress and restructuring tracking

***

### 5. Investment and Market Research

Use this example to monitor investment-relevant company events such as M\&A, fundraising, IPOs, financial results, business outlook, business expansion, layoffs, and restructuring.

#### Recommended Filters

```json
{
  "companyDomains": [
    "tesla.com",
    "nvidia.com",
    "microsoft.com"
  ],
  "triggerCodes": [
    "KW_518",
    "KW_514",
    "KW_516",
    "KW_510",
    "KW_688",
    "KW_527",
    "KW_528",
    "KW_536"
  ],
  "startDate": "2026-01-01",
  "endDate": "2026-01-31",
  "limit": 100
}
```

#### Best For

* Investment research
* Market intelligence
* Competitive intelligence
* Portfolio monitoring
* Event-driven research

***

## Recommended Use Cases

| Use Case                         | Recommended Filters                                              |
| -------------------------------- | ---------------------------------------------------------------- |
| Daily company news monitoring    | `companyDomains`, `startDate`, `endDate`, `limit`                |
| Sales and prospecting signals    | `companyDomains`, sales-relevant `triggerCodes`, date range      |
| Customer / account intelligence  | `companyDomains`, growth and risk `triggerCodes`, date range     |
| Risk and adverse news monitoring | `companyDomains`, adverse / negative `triggerCodes`, date range  |
| Investment and market research   | `companyDomains`, investment-relevant `triggerCodes`, date range |

***

## Best Practices

### Prefer company domains for company matching

Use `companyDomains` to retrieve news signals for specific companies.

Company domains are usually more precise than company names and help reduce duplicate or ambiguous matches.

```json
{
  "companyDomains": [
    "openai.com"
  ],
  "limit": 10
}
```

### Use multiple company domains for account monitoring

You can pass multiple company domains in a single request.

```json
{
  "companyDomains": [
    "openai.com",
    "anthropic.com",
    "databricks.com"
  ],
  "limit": 25
}
```

### Use trigger codes to filter by signal type

Use `triggerCodes` to retrieve specific types of company events such as M\&A, fundraising, layoffs, business expansion, executive changes, partnerships, and product launches.

```json
{
  "triggerCodes": [
    "KW_518",
    "KW_514",
    "KW_528"
  ],
  "limit": 25
}
```

### Use date ranges for published news search

Use `startDate` and `endDate` to search news published during a specific period.

```json
{
  "startDate": "2026-01-01",
  "endDate": "2026-01-31",
  "limit": 25
}
```

### Use limit to control result size

The default limit is `100` records if no limit is provided.

```json
{
  "limit": 100
}
```

### Combine company domains, trigger codes, and dates

For more precise results, combine company domains, trigger codes, published date range, and limit.

```json
{
  "companyDomains": [
    "openai.com",
    "anthropic.com"
  ],
  "triggerCodes": [
    "KW_518",
    "KW_514"
  ],
  "startDate": "2026-01-01",
  "endDate": "2026-01-31",
  "limit": 50
}
```

***

## Common Trigger Codes

| Signal Category                 | Trigger Codes                                              |
| ------------------------------- | ---------------------------------------------------------- |
| Mergers & Acquisitions          | `KW_518`, `KW_519`, `KW_520`, `KW_534`, `KW_535`, `KW_666` |
| Fundraising & Investment        | `KW_514`, `KW_708`                                         |
| IPO                             | `KW_516`                                                   |
| Leadership / Management Changes | `KW_502`, `KW_536`, `KW_591`, `KW_741`                     |
| Business Expansion & Hiring     | `KW_527`, `KW_529`, `KW_640`, `KW_713`                     |
| Product & Service Launch        | `KW_521`, `KW_566`, `KW_642`                               |
| Partnerships & Joint Ventures   | `KW_512`, `KW_513`                                         |
| Layoffs & Cost-Cutting          | `KW_528`, `KW_687`                                         |
| Bankruptcy & Business Shutdown  | `KW_584`, `KW_586`, `KW_641`                               |

{% hint style="info" %}
For the full list of available trigger codes, see the Intellizence Trigger Codes Reference page.
{% endhint %}

***

## Notes

* All parameters are optional.
* Dates should be provided in `YYYY-MM-DD` format.
* Use `companyDomains` to search news signals for one or more companies.
* Use `triggerCodes` to filter news signals by company event type.
* Use `startDate` and `endDate` to filter by news published date.
* Use `limit` to control the number of records returned.
* A news record may include clustered or related articles under `similarNews`.
* Credit fields such as `openingBalance`, `closingBalance`, and `creditsConsumed` may be returned for Pay-Per-Use billing.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.intellizence.com/company-api/search-signals-by-company-domain/sample-requests.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.