Get business information with the Firmographic Append API. With a business name, domain or email you can pull all available information from the Versium Data store, including:
- Basic business information
- Postal address
- Domain
- Industry, NAICS, SIC
- Number of employees
- Sales volume
- Year founded
Format
Here's the format to call the Firmographic Append API:
Data Tool
The Firmographic Append API accepts the following data tool:
| Data Tool Value | Description |
|---|---|
| firmographic | Used to search an append firmographic data from the following business inputs: biz email biz domain biz name city and state |
Example:
https://api.versium.com/v2/firmographic?domain=versium.com
Inputs - what the API uses to search
Inputs are information that the Firmographic Append API will use to search in the Versium REACH back end. The data tool of this API service accepts the following:
- firmographic data tool: business name, business email, domain, business phone, address, city and state.
The API will then match your inputs with consumers in the Versium Data store, and returns business information, as available.
Minimum required search parameters combinations:
firmographic data tool:
- domain
- biz name + full address (address, city, state, zip)
- biz name + phone number
| Value | Data Tool | Description | Example |
|---|---|---|---|
| firmographic | A valid business email address | [email protected] | |
| domain | firmographic | A business domain | versium.com |
| business | firmographic | A business name | Versium |
| address | firmographic | An address | 7530 164th AVE NE |
| city | firmographic | A city name | Redmond |
| state | firmographic | A US state two letter abbreviation | WA |
| zip | firmographic | A 5 digit zip code | 98052 |
| phone | firmographic | A valid 10 digit business phone number | 8003950164 |
Optional Parameters
Optional Configuration Parameters are used to specify and configure how the Firmographic Append API will perform the search.
| Optional Config. Param | Value | Description |
|---|---|---|
| rcfg_max_time | A whole or decimal number | Maximum allowed API run time (in seconds). |