Ctrlk

Intellizence Business Expansion API Sample Requests

Sample requests for the Intellizence Business Expansion API, including filters for date, company domain, industry, company location, expansion location, company type, expansion type, investment, etc.

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.

All request parameters are optional. You can use a single filter or combine multiple filters based on your use case.

Endpoint

POST https://connect.intellizence.com/api/dataset/business-expansion

Authentication

Include your API key in the request header.

x-api-key: YOUR_API_KEY

Content Type

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

cURL Example

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

cURL Example

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

cURL Example

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

cURL Example

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

cURL Example

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

cURL Example

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

cURL Example

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

cURL Example

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

cURL Example

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

cURL Example

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

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

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

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

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

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.

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.

Use ticker for public company monitoring

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

Use LAST-MODIFIED for daily syncs

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

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.

Use company location for headquarters-based analysis

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

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.

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.

Use investment with currency

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

Use jobs for major hiring signals

Use jobs to filter records by announced job creation.

Use limit to control result size

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

Combine filters for more precise results

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

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.

PreviousIntellizence Business Expansion & Major Hiring Signals APINextIntellizence C-Suite Changes Signals API

Last updated