> 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/signals-api/business-expansion-major-hiring/sample-requests.md).

# Intellizence Business Expansion API Sample Requests

## Business Expansion API Sample Requests

Use these sample API requests to retrieve business expansion, major hiring, facility opening, investment, and growth activity records from the Intellizence Business Expansion & Major Hiring Dataset.

These examples show common ways to filter business expansion records by date, company domain, industry, company location, expansion location, company type, ticker, expansion type, investment amount, jobs created, 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/dataset/business-expansion
```

### 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. Get Daily Updated Records

Use `dateType: "LAST-MODIFIED"` to retrieve records that were created or updated on a specific date.

This is recommended for daily syncs, alerts, enrichment workflows, and automated data pipelines.

#### Request Body

```json
{
  "dateType": "LAST-MODIFIED",
  "date": "2025-05-01",
  "limit": 5
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/business-expansion \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "dateType": "LAST-MODIFIED",
    "date": "2025-05-01",
    "limit": 5
  }'
```

***

### 2. Get Expansions Announced on a Specific Date

Use `dateType: "ANNOUNCED"` and `date` to retrieve business expansion records announced on a specific date.

#### Request Body

```json
{
  "dateType": "ANNOUNCED",
  "date": "2025-05-01",
  "limit": 10
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/business-expansion \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "dateType": "ANNOUNCED",
    "date": "2025-05-01",
    "limit": 10
  }'
```

***

### 3. Get Expansions Within a Date Range

Use `startDate` and `endDate` to retrieve business expansion records announced during a specific period.

The Intellizence Business Expansion Dataset contains data beginning from `2021-01-01`.

#### Request Body

```json
{
  "dateType": "ANNOUNCED",
  "startDate": "2025-05-01",
  "endDate": "2025-05-31",
  "limit": 25
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/business-expansion \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "dateType": "ANNOUNCED",
    "startDate": "2025-05-01",
    "endDate": "2025-05-31",
    "limit": 25
  }'
```

***

### 4. Search by Company Domain

Use `companyDomain` to retrieve business expansion records for a specific company website domain.

This is recommended for CRM enrichment, account matching, data pipelines, account monitoring, and workflow automation because domains are usually more precise than company names.

#### Request Body

```json
{
  "companyDomain": "kimberly-clark.com",
  "limit": 10
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/business-expansion \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "companyDomain": "kimberly-clark.com",
    "limit": 10
  }'
```

***

### 5. Search by Company Industry

Use `companyIndustry` to retrieve business expansion records for companies in one or more industries.

This is useful for market research, sector monitoring, investment research, sales prospecting, and competitive intelligence.

#### Request Body

```json
{
  "companyIndustry": [
    "manufacturing",
    "technology"
  ],
  "limit": 20
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/business-expansion \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "companyIndustry": [
      "manufacturing",
      "technology"
    ],
    "limit": 20
  }'
```

***

### 6. Search by Expansion Type

Use `expansionType` to retrieve records by the type of business expansion.

Examples include `Factory/Plant`, `Branch/Office`, `HQ`, `Store`, `Restaurant`, `Data Centre`, `Fulfillment/Distribution Centre/Warehouse`, `Research/Lab/Innovation`, `Country Expansion`, `Healthcare Facility`, and `Hotel/Resort`.

#### Request Body

```json
{
  "expansionType": [
    "Factory/Plant",
    "Fulfillment/Distribution Centre/Warehouse"
  ],
  "limit": 20
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/business-expansion \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "expansionType": [
      "Factory/Plant",
      "Fulfillment/Distribution Centre/Warehouse"
    ],
    "limit": 20
  }'
```

***

### 7. Search by Expansion Location

Use `expansionLocation` to find expansion events announced for a specific location.

This is useful when you want to track new facilities, offices, stores, warehouses, data centers, or hiring plans by city, state, province, country, or region.

#### Request Body

```json
{
  "expansionLocation": "United States of America",
  "limit": 20
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/business-expansion \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "expansionLocation": "United States of America",
    "limit": 20
  }'
```

***

### 8. Search by Investment Amount

Use `investment` to filter business expansion records by announced investment amount.

You can use comparison operators such as `>`, `>=`, `<`, `<=`, `=`, and `!=`.

When filtering by investment amount, include `currency` for more precise results.

#### Request Body

```json
{
  "investment": ">1000000000",
  "currency": "USD",
  "limit": 20
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/business-expansion \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "investment": ">1000000000",
    "currency": "USD",
    "limit": 20
  }'
```

***

### 9. Search by Jobs Created

Use `jobs` to filter business expansion records by the number of announced jobs created.

You can use comparison operators such as `>`, `>=`, `<`, `<=`, `=`, and `!=`.

#### Request Body

```json
{
  "jobs": ">500",
  "limit": 20
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/business-expansion \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "jobs": ">500",
    "limit": 20
  }'
```

***

### 10. Use Multiple Filters Together

Combine filters to narrow results by date range, industry, company type, expansion type, expansion location, investment amount, currency, and jobs created.

#### Request Body

```json
{
  "dateType": "ANNOUNCED",
  "startDate": "2025-01-01",
  "endDate": "2025-05-31",
  "companyIndustry": [
    "manufacturing"
  ],
  "companyType": [
    "Public"
  ],
  "expansionType": [
    "Factory/Plant",
    "Fulfillment/Distribution Centre/Warehouse"
  ],
  "expansionLocation": "United States of America",
  "investment": ">500000000",
  "currency": "USD",
  "jobs": ">250",
  "limit": 50
}
```

#### cURL Example

```bash
curl --request POST \
  --url https://connect.intellizence.com/api/dataset/business-expansion \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "dateType": "ANNOUNCED",
    "startDate": "2025-01-01",
    "endDate": "2025-05-31",
    "companyIndustry": [
      "manufacturing"
    ],
    "companyType": [
      "Public"
    ],
    "expansionType": [
      "Factory/Plant",
      "Fulfillment/Distribution Centre/Warehouse"
    ],
    "expansionLocation": "United States of America",
    "investment": ">500000000",
    "currency": "USD",
    "jobs": ">250",
    "limit": 50
  }'
```

***

## Use Case Examples

### 1. Daily Data Sync

Use this example when you want to pull newly added or updated business expansion records into your application, database, CRM, dashboard, or analytics workflow.

#### Recommended Filters

```json
{
  "dateType": "LAST-MODIFIED",
  "date": "2025-05-01",
  "limit": 100
}
```

#### Best For

* Data pipelines
* Daily refreshes
* Internal dashboards
* Alerts and workflow automation
* CRM and data warehouse enrichment

***

### 2. CRM or Account Enrichment

Use this example to check whether a company in your CRM has recent business expansion, facility opening, or major hiring activity.

#### Recommended Filters

```json
{
  "companyDomain": "kimberly-clark.com",
  "dateType": "LAST-MODIFIED",
  "startDate": "2025-01-01",
  "endDate": "2025-05-31",
  "limit": 10
}
```

#### Best For

* CRM enrichment
* Account scoring
* Sales intelligence
* Customer intelligence
* Signal-based selling workflows

***

### 3. Investment Research

Use this example to track major capital investment and expansion activity in a specific sector.

#### Recommended Filters

```json
{
  "dateType": "ANNOUNCED",
  "startDate": "2025-01-01",
  "endDate": "2025-12-31",
  "companyIndustry": [
    "manufacturing"
  ],
  "investment": ">1000000000",
  "currency": "USD",
  "limit": 50
}
```

#### Best For

* Market mapping
* Sector research
* Capital expenditure tracking
* Investment research
* Corporate development research

***

### 4. Economic Development and Location Monitoring

Use this example to monitor expansion activity, new facilities, and job creation in a specific geography.

#### Recommended Filters

```json
{
  "dateType": "ANNOUNCED",
  "startDate": "2025-01-01",
  "endDate": "2025-12-31",
  "expansionLocation": "United States of America",
  "jobs": ">250",
  "limit": 50
}
```

#### Best For

* Economic development research
* Regional investment tracking
* Job creation monitoring
* Site selection intelligence
* Location-based market analysis

***

### 5. Sales and Prospecting

Use this example to identify companies that are expanding, opening new locations, investing in facilities, or creating new jobs.

#### Recommended Filters

```json
{
  "dateType": "LAST-MODIFIED",
  "startDate": "2025-01-01",
  "endDate": "2025-05-31",
  "companyIndustry": [
    "technology",
    "manufacturing"
  ],
  "expansionType": [
    "Branch/Office",
    "Factory/Plant",
    "Fulfillment/Distribution Centre/Warehouse"
  ],
  "jobs": ">100",
  "limit": 25
}
```

#### Best For

* Prospecting
* Account prioritization
* Trigger-based outreach
* Sales and marketing campaigns
* Go-to-market workflows

***

## Recommended Use Cases

| Use Case                                     | Recommended Filters                                     |
| -------------------------------------------- | ------------------------------------------------------- |
| Daily data sync                              | `dateType`, `date`, `limit`                             |
| CRM or account enrichment                    | `companyDomain`, `dateType`, `startDate`, `endDate`     |
| Investment research                          | `companyIndustry`, date range, `investment`, `currency` |
| Economic development and location monitoring | `expansionLocation`, `jobs`, date range                 |
| Sales and prospecting                        | `companyIndustry`, `expansionType`, `jobs`, date range  |

***

## Best Practices

### Prefer company domain for company matching

For CRM enrichment, data pipelines, account matching, and automated workflows, use `companyDomain` when available.

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

```json
{
  "companyDomain": "kimberly-clark.com",
  "limit": 10
}
```

### Use company name for manual lookup

You can also use `companyName` to search for business expansion records by company name.

Company name search is useful for manual lookup, but for automated workflows, CRM enrichment, and account matching, use `companyDomain` when available.

```json
{
  "companyName": "Kimberly-Clark",
  "limit": 10
}
```

### Use ticker for public company monitoring

For public companies, use `companyTicker` when you want to search by stock ticker.

```json
{
  "companyTicker": "KMB",
  "limit": 10
}
```

### Use `LAST-MODIFIED` for daily syncs

For recurring syncs, alerts, and automated workflows, use `LAST-MODIFIED`.

```json
{
  "dateType": "LAST-MODIFIED",
  "date": "2025-05-01"
}
```

This helps retrieve records that were newly added or updated on that date.

### Use `ANNOUNCED` for event-date research

For research based on when a business expansion was announced, use `ANNOUNCED`.

```json
{
  "dateType": "ANNOUNCED",
  "startDate": "2025-01-01",
  "endDate": "2025-05-31"
}
```

### Use company location for headquarters-based analysis

Use `companyLocation` when you want to filter by where the company is headquartered.

```json
{
  "companyLocation": "Irving,Texas,United States of America",
  "limit": 20
}
```

### Use expansion location for event-location analysis

Use `expansionLocation` when you want to filter by where the expansion, facility opening, or major hiring event occurred.

```json
{
  "expansionLocation": "United States of America",
  "limit": 20
}
```

### Use expansion type to classify growth events

Use `expansionType` to distinguish between factories, offices, stores, warehouses, data centers, headquarters, research facilities, country expansion, and other expansion types.

```json
{
  "expansionType": [
    "Factory/Plant",
    "Branch/Office",
    "Data Centre"
  ],
  "limit": 25
}
```

### Use investment with currency

When filtering by investment amount, include `currency` for more precise results.

```json
{
  "investment": ">500000000",
  "currency": "USD",
  "limit": 25
}
```

### Use jobs for major hiring signals

Use `jobs` to filter records by announced job creation.

```json
{
  "jobs": ">500",
  "limit": 25
}
```

### Use `limit` to control result size

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

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

### Combine filters for more precise results

You can combine multiple filters in a single request to narrow your results.

```json
{
  "dateType": "ANNOUNCED",
  "startDate": "2025-01-01",
  "endDate": "2025-05-31",
  "companyIndustry": [
    "manufacturing"
  ],
  "expansionType": [
    "Factory/Plant"
  ],
  "investment": ">500000000",
  "currency": "USD",
  "jobs": ">250",
  "limit": 50
}
```

***

## Notes

* All parameters are optional.
* Dates should be provided in `YYYY-MM-DD` format.
* The Intellizence Business Expansion Dataset contains data beginning from `2021-01-01`.
* Use `LAST-MODIFIED` when you want newly added or updated records.
* Use `ANNOUNCED` when you want records based on the business expansion announcement date.
* Use `companyDomain` for CRM matching, account enrichment, account monitoring, and workflow automation.
* Use `companyName` for manual lookup when the company domain is not available.
* Use `companyTicker` for public company monitoring.
* Use `companyLocation` for headquarters-based filtering.
* Use `expansionLocation` for event-location filtering.
* Use `expansionType` to filter by the type of expansion or growth event.
* Include `currency` when filtering by `investment`.
* Use `jobs` to filter by announced job creation.


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.intellizence.com/signals-api/business-expansion-major-hiring/sample-requests.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.