Get business demographic details with the Consumer to Business record Append API. With a consumer first name, last name, email or LinkedIn URL you can retrieve the business contact name, job title and business details from the Versium Data store, including:
- Job Title and Seniority
- Department
- Role
- Business email address
- LinkedIn Profile URL
- Basic business information
- Postal address
- Domain
- Industry, NAICS, SIC
- Number of employees
- Sales volume
- Year founded
Format
Here's the format to call the Consumer to Business Append API:
Data Tool
The Consumer to Business Append API accepts the following data tool:
| Data Tool Value | Description |
|---|---|
| c2b | Used to search an append firmographic data from the following consumer inputs: - First name - Last name - Consumer email - Business domain - LinedIn Url |
Example:
Inputs - what the API uses to search
Inputs are information that the Consumer to Business Append API will use to search in the Versium REACH back end. The data tool of this API service accepts the following:
-
Required data tool: First Name, Last Name, Consumer email OR LinkedIn URL
-
Optional data tool: domain
The API will then match your inputs with consumers in the Versium Data store, and returns business information, as available.
| Value | Data Tool | Description | Example |
|---|---|---|---|
| first | c2b | A person's first name | John |
| last | c2b | A person's last name | Smith |
| c2b | A valid consumer email | [email protected] | |
| domain | c2b | A business domain | microsoft.com |
| li_url | c2b | A LinkedIn URL | Accepted formats: https://www.linkedin.com/in/jooosmith www.linkedin.com/in/jooosmith linkedin.com/in/jooosmith |
Optional Parameters
Optional Configuration Parameters are used to specify and configure how the Consumer-to-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). |
| rcfg_require_email | 1 | Returns records with email |
Examples
First, Last and Email
https://api.versium.com/v2/c2b?first=john&last=doe&[email protected]
LinkedIn URL
https://api.versium.com/v2/c2b?li_url=https://www.linkedin.com/in/jooosmith
Require records with email
https://api.versium.com/v2/c2b?first=john&last=doe&li_url=https://www.linkedin.com/in/jooosmith&rcfg_require_email=1