# Intellizence Business Expansion & Major Hiring Signals API

{% hint style="info" %}
Best  suited for :

* Continuous monitoring of business expansion & major hiring announcements
* Trigger alerts and automated workflows
* Major business investment trends & analysis
* Power AI agents and internal intelligence platforms
  {% endhint %}

> **Ready to get started?** [**Request your API key**](https://intellizence.com/api-trial/) and start building.\
> **Questions?** [**Schedule a call**](https://intellizence.com/schedule-a-demo/) or email us at <sales@intellizence.com>.

**Security Notice:**  Please keep API Key secure. Do not share your API key in publicly accessible areas such as GitHub, client-side code, and so forth.

## Submit Business Expansion Dataset Request

> This REST API endpoint provides access to both ongoing and historical business expansion (opening up of offices, factories, headquarters, etc), major hiring and investment data from the Intellizence Business Expansion & Major Hiring Dataset.\
> \
> Users can search data using various parameters- \`dateType\`,\`startDate\`,\`endDate\`,\`date\`,\`companyDomain\`,\`companyName\`,\`companyIndustry\`,\`companyLocation\`,\`companyType\`,\`companyTicker\`,\`expansionType\`,\`expansionLocation\`,\`investment\`,\`currency\` and \`jobs\` . \
> \
> Users can limit the number of records returned using the \`limit\` parameter. Default limit is \`100\`. All parameters are optional.\
> \
> The API key has to be passed in HTTP header with the name \`x-api-key\`."

```json
{"openapi":"3.0.3","info":{"title":"Intellizence Business Expansion & Major Hiring Signals API","version":"1.0"},"servers":[{"url":"https://connect.intellizence.com"}],"paths":{"/api/dataset/business-expansion":{"post":{"summary":"Submit Business Expansion Dataset Request","description":"This REST API endpoint provides access to both ongoing and historical business expansion (opening up of offices, factories, headquarters, etc), major hiring and investment data from the Intellizence Business Expansion & Major Hiring Dataset.\n\nUsers can search data using various parameters- `dateType`,`startDate`,`endDate`,`date`,`companyDomain`,`companyName`,`companyIndustry`,`companyLocation`,`companyType`,`companyTicker`,`expansionType`,`expansionLocation`,`investment`,`currency` and `jobs` . \n\nUsers can limit the number of records returned using the `limit` parameter. Default limit is `100`. All parameters are optional.\n\nThe API key has to be passed in HTTP header with the name `x-api-key`.\"","operationId":"getBusiness-ExpansionDataset","parameters":[{"name":"x-api-key","in":"header","description":"Intellizence API key for authenticating the request.","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Intellizence Business Expansion Dataset request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/dataset_businessexpansion_body"}}}},"responses":{"200":{"description":"Successful response.\n\nNote: Credit fields (openingBalance, closingBalance, creditsConsumed) are returned only for Pay-Per-Use billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessExpansionSearchResponse"}}}},"400":{"description":"400 - Bad Request\n\nBad request, possibly missing required parameters, invalid data, invalid or missing API key.\n\n- 701 - Start Date is not in YYYY-MM-DD format.\n- 702 - End Date is not in YYYY-MM-DD format.\n- 703 - Plan or resource not subscribed\n- 709 - No companies configured for this account.\n- 710 - No triggers configured for this account."},"402":{"description":"402 - Payment Required\n\n- 704 - Payment is pending.\n- 712 - Insufficient credits for this request."},"403":{"description":"403 - Forbidden\n\n- 707 - Subscription has expired.\n- 708 - Start date is outside your subscription's allowed date range."},"406":{"description":"Invalid Deal Amount Filter Format"},"500":{"description":"500 - Internal Server Error\n\n- 715 - A technical error occurred.\n- 799 - A technical error occurred."}}}}},"components":{"schemas":{"dataset_businessexpansion_body":{"type":"object","properties":{"dateType":{"type":"string","description":"Choose the date type used to filter records.The default value is 'ANNOUNCED'. To get the daily update of records created or modified, 'LAST-MODIFIED' is recommended.","enum":["ANNOUNCED","LAST-MODIFIED"]},"startDate":{"type":"string","description":"The start date (YYYY-MM-DD) from which business expansion data is needed. The Intellizence Business Expansion Dataset contains data beginning from 2021-01-01.","format":"date"},"endDate":{"type":"string","description":"The end date (YYYY-MM-DD) up to which business expansion data is needed.","format":"date"},"date":{"type":"string","description":"Exact date (YYYY-MM-DD) for which the business expansion data is needed.","format":"date"},"companyName":{"type":"string","description":"The name(s) of the company for which the business expansion data is needed. Partial name matches are supported. Multiple values can be provided either as a comma-separated string or as an array."},"companyDomain":{"type":"string","description":"The website domain(s) of the company for which the business expansion  data is needed. Partial website domain matches are supported. Multiple values can be provided either as a comma-separated string or as an array."},"companyIndustry":{"type":"string","description":"The industry or industries of companies for which business expansion data is needed. The industries are pre-defined by Intellizence and only the values listed below will be accepted. Multiple values should be provided as an array.","enum":["accounting, audit & tax","advertising & communication","agriculture, animal husbandry & forestry","angels/ venture capital/ private equity","automobile","aviation","banking","bio-technology","business services","chemicals & fertilizers","clean technology","conglomerate","consulting","consumer products","consumer services","defence","distribution","e-commerce","economic development","education","energy & utilities","engineering, procurement & construction","financial services","gambling","gaming","government","healthcare","human resources","insurance","it services & outsourcing","legal","logistics & supply chain","manufacturing","media & entertainment","medical device","metals & mining","not-for-profit/ ngo","others","pharmaceuticals","publishing","railways","real estate","regulatory","restaurants & food services","retail","security","shipping & ports","spac/blank check","sports","technology","telecommunication","textiles","tourism & hospitality","trading","transportation"]},"companyLocation":{"type":"string","description":"The location of the company headquarters for which business expansion data is needed. The location can be city or state/province or country. Multiple values can be provided either as a comma-separated string or as an array."},"companyType":{"type":"string","description":"The type of company for which business expansion  data is needed. The company types are pre-defined by Intellizence and only the values listed below will be accepted. Multiple values can be provided either as a comma-separated string or as an array.","enum":["Public","Private","Government/Regulator","Not-for-profit","Others"]},"companyTicker":{"type":"string","description":"Company Ticker if it's a public company."},"expansionType":{"type":"string","description":"Type of expansion for which data is needed. Multiple values can be provided either as a comma-separated string or as an array.","enum":["Store","Restaurant","Data Centre","Factory/Plant","Country Expansion","HQ","Mine","Branch/Office","Oil/Gas Well","Other","Product/Service Availability","Research/Lab/Innovation","Renewables","Fulfillment/Distribution Centre/Warehouse","New Business","Fleet","Route","Airport/Airline Hub/Cargo Facility","Healthcare Facility","Hotel/Resort","Delivery/Pickup","Education","Lease/Land Purchase"]},"expansionLocation":{"type":"string","description":"Location where the expansion is announced. Multiple values can be provided either as a comma-separated string or as an array."},"investment":{"pattern":"^(>|>=|<|<=|=|!=)?\\d+(,\\d+)?$","type":"number","description":"Filter the records by expansion investment amount. Pass the `currency` whenver `investment` is used. If `currency` is not provided along with `investment`, all the records that matches the deal amount of any currency will be returned. The allowed operators are >, >=, <, <=,=,!=, (MinimumValue),(Maximum Value). Examples: >1000000, >=1000000, <1000000, <=1000000,=1000000,!=1000000, (1000000,400000)","format":"float"},"currency":{"type":"string","description":"The currency of the investment amount.","enum":["USD","CAD","EUR","GBP","INR","AUD","CHF","CNY","JPY","SEK"]},"jobs":{"pattern":"^(>|>=|<|<=|=|!=)?\\d+(,\\d+)?$","type":"number","description":"Number of jobs created. The allowed operators are >, >=, <, <=,=,!=, (MinimumValue),(Maximum Value). Examples: >1000, >=1000, <1000, <=1000,=1000,!=1000, (1000,4000)","format":"float"},"limit":{"type":"integer","description":"The maximum number of records to be returned."}}},"BusinessExpansionSearchResponse":{"required":["code","count","dataset"],"type":"object","properties":{"code":{"type":"integer"},"count":{"type":"integer"},"dataset":{"type":"array","items":{"$ref":"#/components/schemas/inline_response_200"}},"openingBalance":{"type":"integer","nullable":true},"closingBalance":{"type":"integer","nullable":true},"creditsConsumed":{"type":"integer","nullable":true}}},"inline_response_200":{"type":"object","properties":{"id":{"type":"string","description":"Unique ID of the record"},"announcedDate":{"type":"string","description":"Business expansion announced date","format":"date"},"company":{"$ref":"#/components/schemas/inline_response_200_company"},"expansionType":{"type":"array","description":"Type of expansion","items":{"type":"string"}},"location":{"$ref":"#/components/schemas/inline_response_200_location"},"investment":{"type":"number","description":"Expansion investment amount","format":"float"},"currency":{"type":"string","description":"The currency of the investment amount"},"jobs":{"type":"number","description":"Number of jobs created.","format":"float"},"url":{"type":"string","description":"URL of the source document."},"title":{"type":"string","description":"Source title - News or press release headline"},"lastModified":{"type":"string","description":"The last modified date of the record.","format":"date"}}},"inline_response_200_company":{"type":"object","properties":{"name":{"type":"string","description":"Company name"},"domain":{"type":"string","description":"Company website domain"},"industries":{"type":"array","description":"Company industry classification by Intellizence","items":{"type":"string"}},"location":{"type":"string","description":"Company HQ location"},"type":{"type":"string","description":"Company type"},"ticker":{"type":"array","description":"Company stock ticker (if public)","items":{"type":"string"}},"stockExchange":{"type":"array","description":"Stock exchange where the company is listed (if public)","items":{"type":"string"}}}},"inline_response_200_location":{"type":"object","properties":{"country":{"type":"string"},"state":{"type":"string"},"city":{"type":"string"}},"description":"Location where the expansion is announced"}}}}
```

## The dataset\_businessexpansion\_body object

```json
{"openapi":"3.0.3","info":{"title":"Intellizence Business Expansion & Major Hiring Signals API","version":"1.0"},"components":{"schemas":{"dataset_businessexpansion_body":{"type":"object","properties":{"dateType":{"type":"string","description":"Choose the date type used to filter records.The default value is 'ANNOUNCED'. To get the daily update of records created or modified, 'LAST-MODIFIED' is recommended.","enum":["ANNOUNCED","LAST-MODIFIED"]},"startDate":{"type":"string","description":"The start date (YYYY-MM-DD) from which business expansion data is needed. The Intellizence Business Expansion Dataset contains data beginning from 2021-01-01.","format":"date"},"endDate":{"type":"string","description":"The end date (YYYY-MM-DD) up to which business expansion data is needed.","format":"date"},"date":{"type":"string","description":"Exact date (YYYY-MM-DD) for which the business expansion data is needed.","format":"date"},"companyName":{"type":"string","description":"The name(s) of the company for which the business expansion data is needed. Partial name matches are supported. Multiple values can be provided either as a comma-separated string or as an array."},"companyDomain":{"type":"string","description":"The website domain(s) of the company for which the business expansion  data is needed. Partial website domain matches are supported. Multiple values can be provided either as a comma-separated string or as an array."},"companyIndustry":{"type":"string","description":"The industry or industries of companies for which business expansion data is needed. The industries are pre-defined by Intellizence and only the values listed below will be accepted. Multiple values should be provided as an array.","enum":["accounting, audit & tax","advertising & communication","agriculture, animal husbandry & forestry","angels/ venture capital/ private equity","automobile","aviation","banking","bio-technology","business services","chemicals & fertilizers","clean technology","conglomerate","consulting","consumer products","consumer services","defence","distribution","e-commerce","economic development","education","energy & utilities","engineering, procurement & construction","financial services","gambling","gaming","government","healthcare","human resources","insurance","it services & outsourcing","legal","logistics & supply chain","manufacturing","media & entertainment","medical device","metals & mining","not-for-profit/ ngo","others","pharmaceuticals","publishing","railways","real estate","regulatory","restaurants & food services","retail","security","shipping & ports","spac/blank check","sports","technology","telecommunication","textiles","tourism & hospitality","trading","transportation"]},"companyLocation":{"type":"string","description":"The location of the company headquarters for which business expansion data is needed. The location can be city or state/province or country. Multiple values can be provided either as a comma-separated string or as an array."},"companyType":{"type":"string","description":"The type of company for which business expansion  data is needed. The company types are pre-defined by Intellizence and only the values listed below will be accepted. Multiple values can be provided either as a comma-separated string or as an array.","enum":["Public","Private","Government/Regulator","Not-for-profit","Others"]},"companyTicker":{"type":"string","description":"Company Ticker if it's a public company."},"expansionType":{"type":"string","description":"Type of expansion for which data is needed. Multiple values can be provided either as a comma-separated string or as an array.","enum":["Store","Restaurant","Data Centre","Factory/Plant","Country Expansion","HQ","Mine","Branch/Office","Oil/Gas Well","Other","Product/Service Availability","Research/Lab/Innovation","Renewables","Fulfillment/Distribution Centre/Warehouse","New Business","Fleet","Route","Airport/Airline Hub/Cargo Facility","Healthcare Facility","Hotel/Resort","Delivery/Pickup","Education","Lease/Land Purchase"]},"expansionLocation":{"type":"string","description":"Location where the expansion is announced. Multiple values can be provided either as a comma-separated string or as an array."},"investment":{"pattern":"^(>|>=|<|<=|=|!=)?\\d+(,\\d+)?$","type":"number","description":"Filter the records by expansion investment amount. Pass the `currency` whenver `investment` is used. If `currency` is not provided along with `investment`, all the records that matches the deal amount of any currency will be returned. The allowed operators are >, >=, <, <=,=,!=, (MinimumValue),(Maximum Value). Examples: >1000000, >=1000000, <1000000, <=1000000,=1000000,!=1000000, (1000000,400000)","format":"float"},"currency":{"type":"string","description":"The currency of the investment amount.","enum":["USD","CAD","EUR","GBP","INR","AUD","CHF","CNY","JPY","SEK"]},"jobs":{"pattern":"^(>|>=|<|<=|=|!=)?\\d+(,\\d+)?$","type":"number","description":"Number of jobs created. The allowed operators are >, >=, <, <=,=,!=, (MinimumValue),(Maximum Value). Examples: >1000, >=1000, <1000, <=1000,=1000,!=1000, (1000,4000)","format":"float"},"limit":{"type":"integer","description":"The maximum number of records to be returned."}}}}}}
```

## The inline\_response\_200 object

```json
{"openapi":"3.0.3","info":{"title":"Intellizence Business Expansion & Major Hiring Signals API","version":"1.0"},"components":{"schemas":{"inline_response_200":{"type":"object","properties":{"id":{"type":"string","description":"Unique ID of the record"},"announcedDate":{"type":"string","description":"Business expansion announced date","format":"date"},"company":{"$ref":"#/components/schemas/inline_response_200_company"},"expansionType":{"type":"array","description":"Type of expansion","items":{"type":"string"}},"location":{"$ref":"#/components/schemas/inline_response_200_location"},"investment":{"type":"number","description":"Expansion investment amount","format":"float"},"currency":{"type":"string","description":"The currency of the investment amount"},"jobs":{"type":"number","description":"Number of jobs created.","format":"float"},"url":{"type":"string","description":"URL of the source document."},"title":{"type":"string","description":"Source title - News or press release headline"},"lastModified":{"type":"string","description":"The last modified date of the record.","format":"date"}}},"inline_response_200_company":{"type":"object","properties":{"name":{"type":"string","description":"Company name"},"domain":{"type":"string","description":"Company website domain"},"industries":{"type":"array","description":"Company industry classification by Intellizence","items":{"type":"string"}},"location":{"type":"string","description":"Company HQ location"},"type":{"type":"string","description":"Company type"},"ticker":{"type":"array","description":"Company stock ticker (if public)","items":{"type":"string"}},"stockExchange":{"type":"array","description":"Stock exchange where the company is listed (if public)","items":{"type":"string"}}}},"inline_response_200_location":{"type":"object","properties":{"country":{"type":"string"},"state":{"type":"string"},"city":{"type":"string"}},"description":"Location where the expansion is announced"}}}}
```

## The inline\_response\_200\_company object

```json
{"openapi":"3.0.3","info":{"title":"Intellizence Business Expansion & Major Hiring Signals API","version":"1.0"},"components":{"schemas":{"inline_response_200_company":{"type":"object","properties":{"name":{"type":"string","description":"Company name"},"domain":{"type":"string","description":"Company website domain"},"industries":{"type":"array","description":"Company industry classification by Intellizence","items":{"type":"string"}},"location":{"type":"string","description":"Company HQ location"},"type":{"type":"string","description":"Company type"},"ticker":{"type":"array","description":"Company stock ticker (if public)","items":{"type":"string"}},"stockExchange":{"type":"array","description":"Stock exchange where the company is listed (if public)","items":{"type":"string"}}}}}}}
```