# 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 . **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"}}}}}}} ``` --- # Agent Instructions: 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/signals-api/business-expansion-major-hiring.md?ask= ``` 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.