Introduction
6sense Revenue AI is a comprehensive platform that puts the power of AI, big data, and machine learning in every revenue team member's hands. With 6sense, revenue teams can capture anonymous buying signals throughout the buyer’s journey, target the right accounts at precisely the right time, and boost revenue performance with AI-driven recommendations for the channels and messages most likely to convert.
6sense curates the most relevant B2B dataset available, arming revenue teams with the right information to engage with the right accounts, with the right messages, at precisely the right time.
API Overview
The 6sense APIs are HTTP-based and allow programmatic communication between 6sense and other applications. Depending on the endpoint, the 6sense API requires different input data, and relevant data is provided in the response.
See below for descriptions of each API and the input and output data.
List of 6sense APIs
6senses APIs are used across customer systems like CRM, Marketing Automation Platform, and other technology commonly used to fill in data gaps ensuring revenue teams have the data necessary to make confident data driven GTM decisions. Responses are returned in JSON to support integration with common programming languages and development kits.
| API Name | Description |
|---|---|
| Company Identification API | Company Identification API (previously known as Company Details API) identifies anonymous website visitors by taking an IP address and matching it to an Account. Data returned from this API includes company firmographics, segments, and score data associated with that IP and company. Customers need the 6sense Platform to access this API. Know more about API Credits. |
| Company Firmographics API | Company Firmographics API (previously known as the Lead Enrichment API) delivers company firmographics and segments data attributes using the email id. Customers need 6sense Platform or Sales Intelligence package to access this API. Know more about API Credits. |
| Lead Scoring and Firmographics API | Lead Scoring and Firmographics API (previously known as Lead Enrichment and Scoring API) combines the responses from the Company Firmographics and Lead scoring APIs into a single response. This API is primarily designed for customers using Marketo and to access this API, customers need any 6sense Platform or Sales Intelligence package (for enrichment information) and need the Advanced package (for scoring information). Know more about API Credits. |
| Lead Scoring API | Lead Scoring API scores your net new leads using email id and returns predictive scores at the product level. Customers need 6sense Platform Advanced package to access the API. |
| People Enrichment API | Enrich contact level data using 6sense People Enrichment API directly in your rev-tech platforms (e.g.: CRM, MAP, BI, etc). This API delivers contact information and company firmographics attributes using the email id or LinkedIn URL or people ID. To access this API, customers need to purchase this API as add on and it will work with any 6sense Platform or Sales Intelligence package. Know more about API Credits. |
| People Search API | Easily search for people (or contacts or Leads) in an organisation to find the right one. People Search API delivers the list of profiles matching an account for a given domain. You can narrow down your search using filters like locations, Industries & job titles. This API returns whether or not 6sense has contact information details like Email, Phone, Mobile Number. To get actual contact details of the people using peopleID, use People Enrichment API. |
If your organization doesn’t have access to the 6sense ABM platform, click here to contact.
Types of API Credits
There are 2 types of API credits. These Credits are required to access the mentioned APIs. Please reach out to your CSM to get access to these APIs.
| API Credits | Description |
|---|---|
| Company Identification API Credits |
|
| Enrichment APIs Credit |
|
The same records exported from different APIs are counted toward API credits deduction. APIs like People Search and Lead Scoring don't deduct any API credits.
Best Practices
At 6sense, we are committed to the security and privacy of your data. Keeping that in mind, we recommend following best practices around API management.
- Give your API Token an appropriate name to help you track where it is being used. This can be the same as the integration for which the token is used.
- Do not assign the same API Token to more than one integration, unless necessary.
- Rotate your API tokens every 90 days.
- Migrate any “default_existing_token” as per guidance in the Migrate Existing Tokens section.
- Deactivate tokens that are not in use and delete tokens that you don’t plan to use anymore. Before deleting a token, if you need the token-related historical match rates and usage graph, follow instructions provided in Option 2 under the Migrate Existing Tokens section to save a copy.
- The API Token settings (Score and Segments Settings) are secure by default (does not return detailed information). Please adjust these settings as required to fetch information that is necessary for your use cases.
- For enrichment APIs as outlined above, please ensure that the API token is never exposed on any public domain. These APIs are designed for server-to-server communication.
Let’s start with the first step!
Get your API Token
A 6sense API token is an alphanumeric 40 character long key phrase randomly generated that gives you access to the APIs you purchased. 6sense recommends customers create unique API tokens per use case or integration to help track usage. For example, customers deploying the Company Identification API with Drift, PathFactory, and Google Analytics would create 3 unique API tokens – one for each system. This helps with usage tracking and troubleshooting.
Based on your API Credits purchase, you will be able to generate API tokens for all the APIs of the purchased credit type(s).
To generate a unique API token:
- You can go to the Settings >> API Token management page in the 6sense Platform.
- Click on Generate New API token.
- Select the API group and name your token.
- Select the Integrations.
- Add Allowed domains, if you want to restrict the usage of API on selected domains. This option is only available for Company Identification API.
- Copy your API token.
For generating API Token for Segments API, please reach out to 6sense support. Read more
HTTP Response Codes
6sense uses standard HTTP response codes to indicate the success or failure of an API request. Codes in the 2xx range indicate success; Codes in the 4xx or 5xx range indicate an error.
| Code | Description |
|---|---|
200 |
OK Successfully returned response. The response message varies, depending on the request method/endpoint and the requested data. |
201 |
Created The request has been fulfilled and has resulted in one or more new resources being created. |
204 |
No content The server has successfully fulfilled the request and that there is no additional content to send in the response payload body. |
400 |
Bad request Required fields cannot be blank. Do not repeat the request without first modifying it; check the request for errors, fix them and then retry the request. |
401 |
Unauthorized Your API token is invalid or auth token is invalid or missing authorization header. |
402 |
Quota Exhausted Your allocated Quota is exhausted, please upgrade/top-up your API limit by reaching out to your CSM. |
403 |
Forbidden You do not have the appropriate user rights to access the request. Do not repeat the request. |
404 |
Not found The resource does not exist. |
422 |
Validation error A validation error occurred. |
429 |
Too Many Requests You have sent too many requests in a given amount of time ("rate limit"). Please try again later. |
50X |
Internal Server Error Something went wrong with the 6sense API. These errors are logged on our side. You can contact our team to resolve the issue. |
Error Responses
For each endpoint, errors are returned in the form of a JSON with a type and optional message.
| Type | Example |
|---|---|
| Required parameters are blank | {"status": "error", "message": "Email ID is mandatory and can’t be blank"} |
| No data found | {"status": "error", "message": "No data found. Please contact 6sense support, if you think this is an unexpected error."} |
Versioning
Each API will show the list of versions supported. You may receive timely notifications to upgrade the APIs to the latest stable version as we will deprecate the older versions which are no longer recommended to use.
| API | Current stable version |
|---|---|
| Company Identification API | v3 |
| Lead Scoring API | v2 |
| Company Firmographics API (previously known as the Lead Enrichment API) | v3 |
| Lead Scoring and Firmographics API | v2 |
| People Enrichment API | v2 |
| People Search API | v2 |
API Rate Limit
All API requests are subject to rate limits. A rate limit is the number of API calls an app or user can make within a given time period. If this limit is exceeded or if CPU or total time limits are exceeded, the app or user may be throttled. API requests made by a throttled user or app will fail.
For our APIs we enforce a rate limit of 100 requests per minute interval, which is monitored for adjustment, if required, to ensure valid API requests are fulfilled successfully. In case you want to get this limit increased, please reach out to your CSM.
Company Identification API
Company Identification API identifies anonymous website visitors by taking an IP address and matching it to an Account. Data returned from this API includes company firmographics, segments, and score data associated with that IP and company. Customers need the 6sense RAIM Platform to access this API.
Client-side integration of this API is available within your Webtag configurations. Please use the same to turn ON this API.
For webtag, you do not need to create any API token. If you want to integrate this API outside of the webtag, then you need to create a new API token.
To create a new API token, follow the instructions within our knowledge base.
Company Identification API is designed for client-side implementation to unlock use cases like real time web visitor de-anonymization, website personalization, etc. where latency is a important. We do not recommend server side implementation of this API. If you have a complex use case, please talk to your CSM.
Please review the Version Information before using this API.
HTTP Request
Endpoint
GET
https://epsilon.6sense.com/v3/company/details
Headers
Sample Request
curl --location --request GET 'https://epsilon.6sense.com/v3/company/details' \
--header 'Authorization: Token {your_api_token}' \
--header 'X-6s-CustomID: {partner_name-partner_api_token}'
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function() {
if (this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("GET", "https://epsilon.6sense.com/v3/company/details");
xhr.setRequestHeader("Authorization", "Token {your_api_token}");
xhr.setRequestHeader("X-6s-CustomID", "{partner_name-partner_api_token}");
var request = require('request');
var options = {
'method': 'GET',
'url': 'https://epsilon.6sense.com/v3/company/details',
'headers': {
'Authorization': 'Token {your_api_token}',
'X-6s-CustomID': '{partner_name-partner_api_token}'
}
};
request(options, function(error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
import requests
url = "https://epsilon.6sense.com/v3/company/details"
payload = {}
headers = {
"Authorization": "Token {your_api_token}",
"X-6s-CustomID": "{partner_name-partner_api_token}"
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
{
"info": {
"name": "6signal",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
},
"item": [
{
"name": "https://epsilon.6sense.com/v3/company/details",
"request": {
"method": "GET",
"header": [
{
"key": "Authorization",
"type": "text",
"value": "Token {your_api_token}"
},
{
"key": "Content-Type",
"name": "Content-Type",
"type": "text",
"value": "application/x-www-form-urlencoded",
"disabled": true
},
{
"key": "EpsilonCookie",
"type": "text",
"value": "{optional cookie value}",
"disabled": true
},
{
"key": "X-6s-CustomID",
"type": "text",
"value": "{partner_name-partner_api_token}"
}
],
"url": {
"raw": "https://epsilon.6sense.com/v3/company/details",
"protocol": "https",
"host": [
"epsilon",
"6sense",
"com"
],
"path": [
"v3",
"company",
"details"
]
}
},
"response": []
}
]
}
| Header | Value |
|---|---|
| Authorization | Token <api_token> |
| EpsilonCookie(optional) |
If you are a Partner then, you must send this additional header for customer data identification.
| Header | Value |
|---|---|
| X-6s-CustomID |
|
Response Data
Sample Response
{
"company": {
"company_match": "Match",
"additional_comment": "Company name or domain match was found",
"companyId": "j776sdf7sdfh766777dsf",
"domain": "g.ucla.edu",
"name": "UCLA",
"region": "Northern America",
"country": "United States",
"state": "California",
"city": "Los Angeles",
"industry": "Education",
"country_iso_code": "US",
"address": "308 Charles E. Young Drive North A210 Fowler Building/Box 951510",
"zip": "90095",
"phone": "(310) 825-4321",
"employee_range": "10,000+",
"revenue_range": "$5B+",
"employee_count": "22000",
"annual_revenue": "7449000000",
"is_blacklisted": false,
"is_6qa": true,
"geoIP_country": "United States",
"geoIP_state": "California",
"geoIP_city": "San Jose",
"state_code": "CA",
"industry_v2": [
{
"industry": "Education",
"subindustry": "Colleges & Universities"
}
],
"sic_description": "",
"sic": "",
"naics": "6113",
"naics_description": "Colleges, Universities, and Professional Schools"
},
"scores": [
{
"is_6qa": true,
"product": "6sense",
"product_display_name": "6sense",
"intent_score": 63,
"buying_stage": "Consideration",
"profile_score": 9,
"profile_fit": "Weak"
}
],
"segments": {
"ids": [
4713,
28237,
218915,
53685
],
"names": [
"Net New Logo Website Engagement Last 30 Days",
"6s for 6s: Keyword_Sales Intelligence",
"Cvent: Researching Virtual Events",
"EY - Enterprise Accounts (DemandGen)"
],
"list": [
{
"name": "Net New Logo Website Engagement Last 30 Days",
"id": 4713
},
{
"name": "6s for 6s: Keyword_Sales Intelligence",
"id": 28237
},
{
"name": "Cvent: Researching Virtual Events",
"id": 218915
},
{
"name": "EY - Enterprise Accounts (DemandGen)",
"id": 53685
}
]
},
"confidence": "Very High"
}
| Parameters | |
|---|---|
| Account/company Level Variables |
Below are the list of company variables that will be available in the API response.
Below are sample values for these parameters.
|
| company_match |
String
Identifies if 6sense has matched an IP to an Account. Response could be "Match" or "Non-actionable Match" or "No Match"
"Match" or "Non-actionable Match" or "No Match"
|
| additional_comment |
String
Provides details into the company_match status and match reasons.
In case of "Match" it will return "Company name or domain match was found".
In case of "Non-actionable Match" it will return "There is no valid B2B use case as this was matched to something other than a company name/domain (i.e.: bot, host, noisy signal, etc.)". And In case of "No match" it will return "No company name or domain was found". |
| companyId |
String
6sense Unique ID of the Company or Account
78678as6d6as87d6as
|
| name |
String
Name of the company
6sense
|
| domain |
String
Website of the company
6sense .com
|
| industry |
String
Industry of the company
Software and Technology
|
| industry_v2 |
Object
Industry and Sub-Industry of the company
"industry": "Education","subindustry": "Colleges & Universities"
|
| country |
String
Country of the company’s Headquarter
United States
|
| address |
String
Address
450 Mission
|
| state |
String
State
California
|
| city |
String
City or Location
San Francisco
|
| zip |
String
Zip code
94107
|
| employee_count |
String
Approximate Employee count
201
|
| employee_range |
String
Employee Range
100 - 249
|
| annual_revenue |
String
Approximate Annual Revenue
$12,603,100
|
| revenue_range |
String
Annual Revenue Range
$10M - $25M
|
| sic |
String
Standard Industrial Classification Codes (SIC Codes) of the company
7372
|
| sic_description |
String
Additional details provided by SIC
Prepackaged Software
|
| naics |
String
North American Industry Classification System (NAICS)
5112
|
| naics_description |
String
Additional details provided by NAICS
Software Publishers
|
| region |
String
Geographic Region of the Headquarter
North America
|
| country_iso_code |
String
Country ISO code
US
|
| phone |
String
Company Phone Number
(415) 212-9225
|
| is_blacklisted |
True
|
| is_6qa |
Boolean
Account level 6QA (true when this account is considered as hot account by 6sense)
True
|
| geoIP_country |
String
geographical country of the visitor IP address
United States
|
| geoIP_state |
String
geographical state of the visitor IP address
California
|
| geoIP_city |
String
geographical city of the visitor IP address
San Jose
|
| Score for each product |
Predictive scores will be returned at the product level. If you have multiple product model, they API will return scores for each product category. To receive score information in the API you will need to enable this feature in the API Settings & Configurations. For more details on scoring and how scores are determined please visit the 6sense Knowledge Base in Rev City.
Below are sample values for these parameters.
|
| is_6qa |
Boolean
Account level 6QA (true when account is considered as hot account by 6sense for this product)
True
|
| product |
String
The name of the specific predictive model when a customer has more than one model. The product category values are the model names.
ace
|
| intent_score |
Number
The numerical intent score that is tied to a specific buying stage. The numerical range is 0-100.
81
|
| buying_stage |
String
A 6sense AI-derived in-market prediction of the likelihood to open an opportunity in the next 90 days for a particular product category. Response could be Purchase, Decision, Consideration, Awareness, Target.
Purchase
|
| profile_score |
Number
The numerical profile fit score that is tied to a specific profile fit. The numerical range is 0-100.
73
|
| profile_fit |
String
Profile fit identifies accounts based on ideal customer profile (ICP) by looking at historical firmographic data within the CRM. Response could be Strong, Moderate, Weak.
Strong
|
| product_display_name |
String
Name of your product displayed externally.
ace
|
| Segments | |
| ids |
Array
Id for single or multiple segments
12121 or 456456, 119900, 226688,
|
| names |
Array
This gives out the Segment Name. Visibility of Segment Name can be controlled in API Settings. To control these settings within the 6sense platform review the instructions here.
“Web Visitors Last 30 days”, “second”, “third”
|
| list |
Array
Combined response for Segment ID and Name. Visibility of Segment Name can be controlled in API Settings. To control these settings within the 6sense platform review the instructions here.
"name": "Web Visitors Last 30 days", "id": 123123
|
| confidence |
String
The 6sense's confidence in the accuracy of the identity of the account. Response could be Very High, High, Moderate, Low.
Very High
|
Response Codes
| Code | Definition |
|---|---|
200 |
OK Successfully returned response. The response message varies, depending on the request method/endpoint and the requested data. |
OTHERS |
Other common HTTP response codes Please see HTTP Response Codes to know more codes. |
Currently, we support only IPV4 IP addresses.In case of invalid IP Address, you will get blank data for each of these above mentioned variables.
If a field is not present, then we’ll return an empty list or null value for that field.
Company Firmographics API
The Company Firmographics API (previously known as Lead Enrichment API) delivers company firmographics data for the provided people (or lead or contact) email address. The response also includes segment information. Customers need 6sense Platform or Sales Intelligence package to access this API.
You would need Enrichment APIs Credit to access this API. If you want to create or delete these API tokens, please reach out to support. Read more
Please review the Version Information before using this API.
Version 3 (Latest)
HTTP Request
Endpoint
POSThttps://api.6sense.com/v1/enrichment/company
Headers
| Header | Value |
|---|---|
| Authorization | Token <api_token> |
| Content-Type | application/x-www-form-urlencoded |
Input Params
Sample Request
curl --location --request POST 'https://api.6sense.com/v1/enrichment/company' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Cache-Control: no-cache' \
--header 'Authorization: Token {your_api_token}' \
--data-urlencode 'email=<user_name>@<domain>.com' \
--data-urlencode 'domain=<domain_value>' \
--data-urlencode 'country=<country_value>' \
--data-urlencode 'company=<company_value>' \
--data-urlencode 'industry=<industry_value>' \
--data-urlencode 'title=<title_value>' \
--data-urlencode 'role=<role_value>' \
--data-urlencode 'firstname=<firstname_value>' \
--data-urlencode 'lastname=<lastname_value>' \
--data-urlencode 'leadsource=<leadsource_value>'
var data = "email=<user_name>@<domain>.com &
domain = < domain_value >
&
country = < country_value >
&
company = < company_value >
&
industry = < industry_value >
&
title = < title_value >
&
role = < role_value >
&
firstname = < firstname_value >
&
lastname = < lastname_value >
&
leadsource = < leadsource_value >
";
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function() {
if (this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("POST", "https://api.6sense.com/v1/enrichment/company");
xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
xhr.setRequestHeader("Cache-Control", "no-cache");
xhr.setRequestHeader("Authorization", "Token {your_api_token}");
xhr.send(data);
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://api.6sense.com/v1/enrichment/company',
'headers': {
'Content-Type': 'application/x-www-form-urlencoded',
'Cache-Control': 'no-cache',
'Authorization': 'Token {your_api_token}'
},
form: {
'email': '<user_name>@<domain>.com',
'domain': '<domain_value>',
'country': '<country_value>',
'company': '<company_value>',
'industry': '<industry_value>',
'title': '<title_value>',
'role': '<role_value>',
'firstname': '<firstname_value>',
'lastname': '<lastname_value>',
'leadsource': '<leadsource_value>'
}
};
request(options, function(error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
import requests
url = "https://api.6sense.com/v1/enrichment/company"
payload=’email=<user_name>@<domain>.com
&domain=<domain_value>
&country=<country_value>
&company=<company_value>
&industry=<industry_value>
&title=<title_value>
&role=<role_value>
&firstname=<firstname_value>
&lastname=<lastname_value>
&leadsource=<leadsource_value>’
headers = {
'Content-Type': 'application/x-www-form-urlencoded',
'Cache-Control': 'no-cache',
'Authorization': 'Token {your_api_token}'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
{
"info": {
"name": "sample_scribe",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
},
"item": [
{
"name": "https://api.6sense.com/v1/enrichment/company",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/x-www-form-urlencoded",
"type": "text"
},
{
"key": "Cache-Control",
"value": "no-cache",
"type": "text"
},
{
"key": "Authorization",
"value": "Token {your_api_token}",
"type": "text"
}
],
"body": {
"mode": "urlencoded",
"urlencoded": [
{
"key": "email",
"value": "<user_name>@<domain>.com\n",
"type": "text"
},
{
"key": "domain",
"value": "<domain_value>",
"type": "text"
},
{
"key": "country",
"value": "<country_value>",
"type": "text"
},
{
"key": "company",
"value": "<company_value>",
"type": "text"
},
{
"key": "industry",
"value": "<industry_value>",
"type": "text"
},
{
"key": "title",
"value": "<title_value>",
"type": "text"
},
{
"key": "role",
"value": "<role_value>",
"type": "text"
},
{
"key": "firstname",
"value": "<firstname_value>",
"type": "text"
},
{
"key": "lastname",
"value": "<lastname_value>",
"type": "text"
},
{
"key": "leadsource",
"value": "<leadsource_value>",
"type": "text"
}
]
},
"url": {
"raw": "https://api.6sense.com/v1/enrichment/company",
"protocol": "https",
"host": [
"api",
"6sense",
"com"
],
"path": [
"v1",
"enrichment",
"company"
],
"query": [
{
"key": "country",
"value": "",
"disabled": true
}
]
}
},
"response": []
}
]
}
| Parameters | |
|---|---|
|
StringMandatory only if domain is blank
If both email and domain are provided as input then, we should prioritize email for match and then fall back to domain
abc.xyz@6sense.com
|
|
| domain |
StringMandatory only if email is blank
If both email and domain are provided as input then, we should prioritize email for match and then fall back to domain.
6sense.com
|
| country |
Stringoptional
Used as filter along with the mandatory parameter
US
|
| company |
Stringoptional
Used as filter along with the mandatory parameter
Dell
|
| industry |
Stringoptional
Used as filter along with the mandatory parameter
Software and Technology
|
| title |
Stringoptional
Used as filter along with the mandatory parameter
Procurement Manager
|
| role |
Stringoptional
Used as filter along with the mandatory parameter
Procurement Manager
|
| firstname |
Stringoptional
Used as filter along with the mandatory parameter
ABC
|
| lastname |
Stringoptional
Used as filter along with the mandatory parameter
XYZ
|
| leadsource |
Stringoptional
Used as filter along with the mandatory parameter
Website form
|
Response Data
Sample Response
{
"company": {
"companyId": "j776sdf7sdfh766777dsf",
"domain": "6sense.com",
"name": "6sense",
"region": "Northern America",
"country": "United States",
"countryISOCode": "US",
"state": "California",
"city": "San Francisco",
"streetAddress": "450 Mission St,",
"postalCode": "94105",
"companyPhone": "415-212-9225",
"industry": "Software and Technology",
"employeeRange": "1,000 - 4,999",
"revenueRange": "$100M - $250M",
"employeeCount": "1192",
"annualRevenue": "104000000",
"titleLevel": "staff",
"titleFunction": "engineering",
"sicdescription": "Prepackaged Software",
"siccode": "7372",
"naicscode": "511210",
"naicsdescription": "Software Publishers"
},
"segments": {
"ids": [],
"names": [],
"list": []
}
}
Account/company Level Variables: Below are the data points that are available in the API response.
| Parameters | |
|---|---|
| companyId |
String
6sense Unique Id of the Company or Account
78678as6d6as87d6as
|
| domain |
String
Website of the company
6sense.com
|
| name |
String
Name of the company
6sense
|
| industry |
String
Industry of the company
Software and Technology
|
| country |
String
Country of the company’s Headquarter
United States
|
| streetAddress |
String
Address
450 Mission
|
| state |
String
State
California
|
| city |
String
City or Location
San Francisco
|
| postalCode |
String
Zip code
94107
|
| employeeCount |
String
Approximate Employee count
201
|
| employeeRange |
String
Employee Range
100 - 249
|
| annualRevenue |
String
Approximate Annual Revenue
$12,603,100
|
| titleLevel |
String
Title of the Org-structure level
staff
|
| titleFunction |
String
Function title
engineering
|
| revenueRange |
String
Annual Revenue Range
$10M - $25M
|
| siccode |
String
Standard Industrial Classification Codes (SIC Codes) of the company
7372
|
| sicdescription |
String
Additional details provided by SIC
Prepackaged Software
|
| naicscode |
String
North American Industry Classification System (NAICS)
5112
|
| naicsdescription |
String
Additional details provided by NAICS
Software Publishers
|
| region |
String
Geographic Region of the Headquarter
North America
|
| countryISOCode |
String
Country ISO code
US
|
| companyPhone |
String
Company Phone Number
(415) 212-9225
|
| Segments |
Segments published within the 6sense ABM platform will be available in the API response. Segments Name will be available only if enabled in API Settings. To control these settings within the 6sense platform review the instructions here.
Below are sample values for these parameters.
|
| ids |
Array
Id for single or multiple segments
12121 or 456456, 119900, 226688,
|
| names |
Array
This gives out the Segment Name. Visibility of Segment Name can be controlled in API Settings. To control these settings within the 6sense platform review the instructions here.
“Web Visitors Last 30 days”, “second”, “third”
|
| list |
Array
Combined response for Segment ID and Name. Visibility of Segment Name can be controlled in API Settings. To control these settings within the 6sense platform review the instructions here.
"name": "Web Visitors Last 30 days",
|
Response Codes
| Code | Definition |
|---|---|
200 |
OK Successfully returned response against an email address |
404 |
Not found Invalid email ID. Please make sure you have sent a valid email address in email field. |
OTHERS |
Other common HTTP response codes Please see HTTP Response Codes to know more codes. |
In case of invalid email Address, you will get blank data for each of these above mentioned variables.If a field is not present, then we’ll return an empty list or null value for that field.
Version 2
HTTP Request
Endpoint
POSThttps://scribe.6sense.com/v2/people/enrichment
Headers
| Header | Value |
|---|---|
| Authorization | Token <api_token> |
| Content-Type | application/x-www-form-urlencoded |
Input Params
Sample Request
curl --location --request POST 'https://scribe.6sense.com/v2/people/enrichment' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Cache-Control: no-cache' \
--header 'Authorization: Token {your_api_token}' \
--data-urlencode 'email=<user_name>@<domain>.com' \
--data-urlencode 'country=<country_value>' \
--data-urlencode 'company=<company_value>' \
--data-urlencode 'website=<website_value>' \
--data-urlencode 'title=<title_value>' \
--data-urlencode 'leadsource=<leadsource_value>' \
--data-urlencode 'firstname=<firstname_value>' \
--data-urlencode 'lastname=<lastname_value>' \
--data-urlencode 'role=<role_value>' \
--data-urlencode 'industry=<industry_value>'
var data = "email=<user_name>@<domain>.com &
country = < country_value >
&
company = < company_value >
&
website = < website_value >
&
title = < title_value >
&
leadsource = < leadsource_value >
&
firstname = < firstname_value >
&
lastname = < lastname_value >
&
role = < role_value >
&
industry = < industry_value > ";
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function() {
if (this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("POST", "https://scribe.6sense.com/v2/people/enrichment");
xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
xhr.setRequestHeader("Cache-Control", "no-cache");
xhr.setRequestHeader("Authorization", "Token {your_api_token}");
xhr.send(data);
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://scribe.6sense.com/v2/people/enrichment',
'headers': {
'Content-Type': 'application/x-www-form-urlencoded',
'Cache-Control': 'no-cache',
'Authorization': 'Token {your_api_token}'
},
form: {
'email': '<user_name>@<domain>.com',
'country': '<country_value>',
'company': '<company_value>',
'website': '<website_value>',
'title': '<title_value>',
'leadsource': '<leadsource_value>',
'firstname': '<firstname_value>',
'lastname': '<lastname_value>',
'role': '<role_value>',
'industry': '<industry_value>'
}
};
request(options, function(error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
import requests
url = "https://scribe.6sense.com/v2/people/enrichment"
payload=’email=<user_name>@<domain>.com
&country=<country_value>
&company=<company_value>
&website=<website_value>
&title=<title_value>
&leadsource=<leadsource_value>
&firstname=<firstname_value>
&lastname=<lastname_value>
&role=<role_value>
&industry=<industry_value>’
headers = {
'Content-Type': 'application/x-www-form-urlencoded',
'Cache-Control': 'no-cache',
'Authorization': 'Token {your_api_token}'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
{
"info": {
"name": "sample_scribe",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
},
"item": [
{
"name": "https://scribe.6sense.com/v2/people/enrichment",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/x-www-form-urlencoded",
"type": "text"
},
{
"key": "Cache-Control",
"value": "no-cache",
"type": "text"
},
{
"key": "Authorization",
"value": "Token {your_api_token}",
"type": "text"
}
],
"body": {
"mode": "urlencoded",
"urlencoded": [
{
"key": "email",
"value": "<user_name>@<domain>.com\n",
"type": "text"
},
{
"key": "country",
"value": "<country_value>",
"type": "text"
},
{
"key": "company",
"value": "<company_value>",
"type": "text"
},
{
"key": "website",
"value": "<website_value>",
"type": "text"
},
{
"key": "title",
"value": "<title_value>",
"type": "text"
},
{
"key": "leadsource",
"value": "<leadsource_value>",
"type": "text"
},
{
"key": "firstname",
"value": "<firstname_value>",
"type": "text"
},
{
"key": "lastname",
"value": "<lastname_value>",
"type": "text"
},
{
"key": "role",
"value": "<role_value>",
"type": "text"
},
{
"key": "industry",
"value": "<industry_value>",
"type": "text"
}
]
},
"url": {
"raw": "https://scribe.6sense.com/v2/people/enrichment",
"protocol": "https",
"host": [
"scribe",
"6sense",
"com"
],
"path": [
"v2",
"people",
"enrichment"
],
"query": [
{
"key": "country",
"value": "",
"disabled": true
}
]
}
},
"response": []
}
]
}
| Parameters | |
|---|---|
|
Stringrequired
A Valid Email address for which you are requesting details.
xyz@acme.com
|
|
| country |
Stringoptional
Base country of the company/account
US
|
| website |
Stringoptional
Website of the company/account
acme.com
|
| company |
Stringoptional
Name of the company/account
Dell
|
| title |
Stringoptional
Designation of the Lead
Procurement Manager
|
| leadsource |
Stringoptional
Source of the lead as per your database
Website form
|
| firstname |
Stringoptional
First name of the Lead
ABC
|
| lastname |
Stringoptional
Last name of the Lead
XYZ
|
| role |
Stringoptional
Role of the Lead
Procurement Manager
|
| industry |
Stringoptional
Industry of the company
Software and Technology
|
Response Data
Sample Response
{
"company": {
"domain": "6sense.com",
"name": "6sense",
"region": "Northern America",
"country": "United States",
"countryISOCode": "US",
"state": "California",
"city": "San Francisco",
"streetAddress": "450 Mission St,",
"postalCode": "94105",
"companyPhone": "415-212-9225",
"industry": "Software and Technology",
"employeeRange": "1,000 - 4,999",
"revenueRange": "$100M - $250M",
"employeeCount": "1192",
"annualRevenue": "104000000",
"titleLevel": "staff",
"titleFunction": "engineering",
"sicdescription": "Prepackaged Software",
"siccode": "7372",
"naicscode": "511210",
"naicsdescription": "Software Publishers"
},
"segments": {
"ids": [],
"names": [],
"list": []
}
}
Account/company Level Variables: Below are the data points that are available in the API response.
| Parameters | |
|---|---|
| domain |
String
Website of the company
6sense.com
|
| name |
String
Name of the company
6sense
|
| industry |
String
Industry of the company
Software and Technology
|
| country |
String
Country of the company’s Headquarter
United States
|
| streetAddress |
String
Address
450 Mission
|
| state |
String
State
California
|
| city |
String
City or Location
San Francisco
|
| postalCode |
String
Zip code
94107
|
| employeeCount |
String
Approximate Employee count
201
|
| employeeRange |
String
Employee Range
100 - 249
|
| annualRevenue |
String
Approximate Annual Revenue
$12,603,100
|
| titleLevel |
String
Title of the Org-structure level
staff
|
| titleFunction |
String
Function title
engineering
|
| revenueRange |
String
Annual Revenue Range
$10M - $25M
|
| siccode |
String
Standard Industrial Classification Codes (SIC Codes) of the company
7372
|
| sicdescription |
String
Additional details provided by SIC
Prepackaged Software
|
| naicscode |
String
North American Industry Classification System (NAICS)
5112
|
| naicsdescription |
String
Additional details provided by NAICS
Software Publishers
|
| region |
String
Geographic Region of the Headquarter
North America
|
| countryISOCode |
String
Country ISO code
US
|
| companyPhone |
String
Company Phone Number
(415) 212-9225
|
| Segments |
Segments published within the 6sense ABM platform will be available in the API response. Segments Name will be available only if enabled in API Settings. To control these settings within the 6sense platform review the instructions here.
Below are sample values for these parameters.
|
| ids |
Array
Id for single or multiple segments
12121 or 456456, 119900, 226688,
|
| names |
Array
This gives out the Segment Name. Visibility of Segment Name can be controlled in API Settings. To control these settings within the 6sense platform review the instructions here.
“Web Visitors Last 30 days”, “second”, “third”
|
| list |
Array
Combined response for Segment ID and Name. Visibility of Segment Name can be controlled in API Settings. To control these settings within the 6sense platform review the instructions here.
"name": "Web Visitors Last 30 days",
|
Response Codes
| Code | Definition |
|---|---|
200 |
OK Successfully returned response against an email address |
404 |
Not found Invalid email ID. Please make sure you have sent a valid email address in email field. |
OTHERS |
Other common HTTP response codes Please see HTTP Response Codes to know more codes. |
In case of invalid email Address, you will get blank data for each of these above mentioned variables.If a field is not present, then we’ll return an empty list or null value for that field.
Lead Scoring and Firmographics API
Lead Scoring and Firmographics API (previously known as Lead Enrichment and Scoring API) combines the API responses for Company Firmographics API and Lead Scoring API. This API is specifically designed to unlock real-time enrichment and scoring use cases from marketing automation platforms like Marketo.
If configured from Marketo, the API will fire when a new lead is added to Marketo and matches based on the email address. It returns scores (based on the product category), company firmographics, and segment data.
To use this API, customers need a valid Platform subscription for enrichment use cases and an Advanced package for scoring. You would also need Enrichment APIs Credit to access this API. If you want to create or delete these API tokens, please reach out to support. Read more
Please review the Version Information before using this API.
HTTP Request
Endpoint
POSThttps://scribe.6sense.com/v2/people/full
Headers
| Header | Value |
|---|---|
| Authorization | Token <api_token> |
| Content-Type | application/x-www-form-urlencoded |
Input Params
Sample Request
curl --location --request POST 'https://scribe.6sense.com/v2/people/full' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Cache-Control: no-cache' \
--header 'Authorization: Token {your_api_token}' \
--data-urlencode 'email=<user_name>@<domain>.com' \
--data-urlencode 'country=<country_value>' \
--data-urlencode 'company=<company_value>' \
--data-urlencode 'website=<website_value>' \
--data-urlencode 'title=<title_value>' \
--data-urlencode 'leadsource=<leadsource_value>' \
--data-urlencode 'firstname=<firstname_value>' \
--data-urlencode 'lastname=<lastname_value>' \
--data-urlencode 'role=<role_value>' \
--data-urlencode 'industry=<industry_value>'
var data = "email=<user_name>@<domain>.com &
country = < country_value >
&
company = < company_value >
&
website = < website_value >
&
title = < title_value >
&
leadsource = < leadsource_value >
&
firstname = < firstname_value >
&
lastname = < lastname_value >
&
role = < role_value >
&
industry = < industry_value > ";
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function() {
if (this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("POST", "https://scribe.6sense.com/v2/people/full");
xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
xhr.setRequestHeader("Cache-Control", "no-cache");
xhr.setRequestHeader("Authorization", "Token {your_api_token}");
xhr.send(data);
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://scribe.6sense.com/v2/people/full',
'headers': {
'Content-Type': 'application/x-www-form-urlencoded',
'Cache-Control': 'no-cache',
'Authorization': 'Token {your_api_token}'
},
form: {
'email': '<user_name>@<domain>.com\n',
'country': '<country_value>',
'company': '<company_value>',
'website': '<website_value>',
'title': '<title_value>',
'leadsource': '<leadsource_value>',
'firstname': '<firstname_value>',
'lastname': '<lastname_value>',
'role': '<role_value>',
'industry': '<industry_value>'
}
};
request(options, function(error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
import requests
url = "https://scribe.6sense.com/v2/people/full"
payload=’email=<user_name>@<domain>.com
&country=<country_value>
&company=<company_value>
&website=<website_value>
&title=<title_value>
&leadsource=<leadsource_value>
&firstname=<firstname_value>
&lastname=<lastname_value>
&role=<role_value>
&industry=<industry_value>’
headers = {
'Content-Type': 'application/x-www-form-urlencoded',
'Cache-Control': 'no-cache',
'Authorization': 'Token {your_api_token}'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
{
"info": {
"name": "sample_scribe",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
},
"item": [
{
"name": "https://scribe.6sense.com/v2/people/full",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/x-www-form-urlencoded",
"type": "text"
},
{
"key": "Cache-Control",
"value": "no-cache",
"type": "text"
},
{
"key": "Authorization",
"value": "Token {your_api_token}",
"type": "text"
},
{
"key": "X-Forwarded-For",
"value": "1.0.185.47",
"type": "text",
"disabled": true
}
],
"body": {
"mode": "urlencoded",
"urlencoded": [
{
"key": "email",
"value": "<user_name>@<domain>.com\n",
"type": "text"
},
{
"key": "country",
"value": "<country_value>",
"type": "text"
},
{
"key": "company",
"value": "<company_value>",
"type": "text"
},
{
"key": "website",
"value": "<website_value>",
"type": "text"
},
{
"key": "title",
"value": "<title_value>",
"type": "text"
},
{
"key": "leadsource",
"value": "<leadsource_value>",
"type": "text"
},
{
"key": "firstname",
"value": "<firstname_value>",
"type": "text"
},
{
"key": "lastname",
"value": "<lastname_value>",
"type": "text"
},
{
"key": "role",
"value": "<role_value>",
"type": "text"
},
{
"key": "industry",
"value": "<industry_value>",
"type": "text"
}
]
},
"url": {
"raw": "https://scribe.6sense.com/v2/people/full",
"protocol": "https",
"host": [
"scribe",
"6sense",
"com"
],
"path": [
"v2",
"people",
"full"
],
"query": [
{
"key": "country",
"value": "",
"disabled": true
}
]
}
},
"response": []
}
]
}
| Parameters | |
|---|---|
|
Stringrequired
A Valid Email address for which you are requesting details.
xyz@acme.com
|
|
| country |
Stringrequired
Base country of the company/account
US
|
| website |
Stringoptional
Website of the company/account
acme.com
|
| company |
Stringoptional
Name of the company/account
Dell
|
| title |
Stringoptional
Designation of the Lead
Procurement Manager
|
| leadsource |
Stringoptional
Source of the lead as per your database
Website form
|
| firstname |
Stringoptional
First name of the Lead
ABC
|
| lastname |
Stringoptional
Last name of the Lead
XYZ
|
| role |
Stringoptional
Role of the Lead
Procurement Manager
|
| industry |
Stringoptional
Industry of the company
Software and Technology
|
Response Data
Sample Response
{
"company": {
"companyId": "j776sdf7sdfh766777dsf",
"domain": "6sense.com",
"name": "6sense",
"region": "Northern America",
"country": "United States",
"countryISOCode": "US",
"state": "California",
"city": "San Francisco",
"streetAddress": "450 Mission St,",
"postalCode": "94105",
"companyPhone": "415-212-9225",
"industry": "Software and Technology",
"employeeRange": "1,000 - 4,999",
"revenueRange": "$100M - $250M",
"employeeCount": "1192",
"annualRevenue": "104000000",
"titleLevel": "staff",
"titleFunction": "engineering",
"sicdescription": "Prepackaged Software",
"siccode": "7372",
"naicscode": "511210",
"naicsdescription": "Software Publishers"
},
"scores": [
{
"product": "6sense",
"company_intent_score": 0,
"company_buying_stage": "Target",
"company_profile_score": 81,
"company_profile_fit": "Strong",
"contact_intent_score": 0,
"contact_grade": "D",
"contact_profile_score": 58,
"contact_profile_fit": "Moderate"
}
],
"segments": {
"ids": [
4713,
28237,
218915,
53685
],
"names": [
"Net New Logo Website Engagement Last 30 Days",
"6s for 6s: Keyword_Sales Intelligence",
"Cvent: Researching Virtual Events",
"EY - Enterprise Accounts (DemandGen)"
],
"list": [
{
"name": "Net New Logo Website Engagement Last 30 Days",
"id": 4713
},
{
"name": "6s for 6s: Keyword_Sales Intelligence",
"id": 28237
},
{
"name": "Cvent: Researching Virtual Events",
"id": 218915
},
{
"name": "EY - Enterprise Accounts (DemandGen)",
"id": 53685
}
]
},
}
| Parameters | |
|---|---|
| Account/company Level Variables |
Below are the data points that are available in the API response.
Below are sample values for these parameters.
|
| companyId |
String
6sense Unique Id of the Company or Account
78678as6d6as87d6as
|
| name |
String
Name of the company
6sense
|
| domain |
String
Website of the company
6sense.com
|
| industry |
String
Industry of the company
Software and Technology
|
| country |
String
Country of the company’s Headquarter
United States
|
| address |
String
Address
450 Mission
|
| state |
String
State
California
|
| city |
String
City or Location
San Francisco
|
| zip |
String
Zip code
94107
|
| employee_count |
String
Approximate Employee count
201
|
| employee_range |
String
Employee Range
100 - 249
|
| annual_revenue |
String
Approximate Annual Revenue
$12,603,100
|
| titleLevel |
String
Title of the Org-structure level
staff
|
| titleFunction |
String
Function title
engineering
|
| revenue_range |
String
Annual Revenue Range
$10M - $25M
|
| sic |
String
Standard Industrial Classification Codes (SIC Codes) of the company
7372
|
| sic_description |
String
Additional details provided by SIC
Prepackaged Software
|
| naics |
String
North American Industry Classification System (NAICS)
5112
|
| naics_description |
String
Additional details provided by NAICS
Software Publishers
|
| region |
String
Geographic Region of the Headquarter
North America
|
| country_iso_code |
String
Country ISO code
US
|
| phone |
String
Company Phone Number
(415) 212-9225
|
| is_blacklisted |
True
|
| Score for each product |
Predictive scores will be returned at the product level. If you have multiple product model, they API will return scores for each product category. To receive score information in the API you will need to enable this feature in the API Settings & Configurations. For more details on scoring and how scores are determined, please visit the 6sense Knowledge Base in Rev City.
Below are sample values for these parameters.
|
| product |
String
The name of the specific predictive model when a customer has more than one model. The product category values are the model names.
ace
|
| company_intent_score |
Number
The numerical intent score that is tied to a specific buying stage. The numerical range is 0-100.
81
|
| company_buying_stage |
String
A 6sense AI-derived in-market prediction of the likelihood to open an opportunity in the next 90 days for a particular product category. Response could be Purchase, Decision, Consideration, Awareness, Target.
Purchase
|
| company_profile_score |
Number
The numerical profile fit score that is tied to a specific profile fit. The numerical range is 0-100.
73
|
| company_profile_fit |
String
Profile fit identifies accounts based on ideal customer profile (ICP) by looking at historical firmographic data within the CRM. Response could be Strong, Moderate, Weak.
Strong
|
| contact_intent_score |
Number
The numerical contact intent score that is tied to a specific contact intent grade. The numerical range is 0-100.
0
|
| contact_grade |
String
A measure of how engaged a person is with your first-party sales and marketing tactics, including any known activity of this type from the MAP or CRM (such as clicking on a website, responding to sales or marketing emails, attending events, and attending webinars). Response could be A, B, C, D.
D
|
| contact_profile_score |
String
The numerical contact profile fit score that is tied to a specific contact profile fit. The numerical range is 0-100.
51
|
| contact_profile_fit |
String
Contact profile fit identifies the fit of a person based on the historical CRM data of who you’ve sold to in the past. Response could be Strong, Moderate, Weak.
Moderate
|
| Segments |
Segments published within the 6sense ABM platform will be available in the API response. Segments Name will be available only if enabled in API Settings. To control these settings within the 6sense platform review the instructions here.
Below are sample values for these parameters.
|
| ids |
Array
Id for single or multiple segments
12121 or 456456, 119900, 226688,
|
| names |
Array
This gives out the Segment Name. Visibility of Segment Name can be controlled in API Settings. To control these settings within the 6sense platform review the instructions here.
“Web Visitors Last 30 days”, “second”, “third”
|
| list |
Array
Combined response for Segment ID and Name. Visibility of Segment Name can be controlled in API Settings. To control these settings within the 6sense platform review the instructions here.
"name": "Web Visitors Last 30 days",
"id": 123123 |
Response Codes
| Code | Definition |
|---|---|
200 |
OK Successfully returned response against an email address |
404 |
Not found Invalid email ID. Please make sure you have sent a valid email address in email field. |
OTHERS |
Other common HTTP response codes Please see HTTP Response Codes to know more codes. |
In case of invalid email Address, you will get blank data for each of these above mentioned variables.If a field is not present, then we’ll return an empty list or null value for that field.
Lead Scoring API
The Lead Scoring API allows customers to update people (or lead or contact) with 6sense Predictive Scores. The API matches based on the input email address and returns account and person-level scores by product category. Customers need the 6sense Advanced Package to have access to this API.
API Token for this API is auto-generated. If you want to create or delete these API tokens, please reach out to support. Read more
Please review the Version Information before using this API.
HTTP Request
Endpoint
POSThttps://scribe.6sense.com/v2/people/score
Headers
| Header | Value |
|---|---|
| Authorization | Token <api_token> |
| Content-Type | application/x-www-form-urlencoded |
Input Params
Sample Request
curl --location --request POST 'https://scribe.6sense.com/v2/people/score' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Cache-Control: no-cache' \
--header 'Authorization: Token {your_api_token}' \
--data-urlencode 'email=<user_name>@<domain>.com' \
--data-urlencode 'country=<country_value>' \
--data-urlencode 'company=<company_value>' \
--data-urlencode 'website=<website_value>' \
--data-urlencode 'title=<title_value>' \
--data-urlencode 'leadsource=<leadsource_value>' \
--data-urlencode 'firstname=<firstname_value>' \
--data-urlencode 'lastname=<lastname_value>' \
--data-urlencode 'role=<role_value>' \
--data-urlencode 'industry=<industry_value>'
var data = "email=<user_name>@<domain>.com &
country = < country_value >
&
company = < company_value >
&
website = < website_value >
&
title = < title_value >
&
leadsource = < leadsource_value >
&
firstname = < firstname_value >
&
lastname = < lastname_value >
&
role = < role_value >
&
industry = < industry_value > ";
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function() {
if (this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("POST", "https://scribe.6sense.com/v2/people/score");
xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
xhr.setRequestHeader("Cache-Control", "no-cache");
xhr.setRequestHeader("Authorization", "Token {your_api_token}");
xhr.send(data);
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://scribe.6sense.com/v2/people/score',
'headers': {
'Content-Type': 'application/x-www-form-urlencoded',
'Cache-Control': 'no-cache',
'Authorization': 'Token {your_api_token}'
},
form: {
'email': '<user_name>@<domain>.com\n',
'country': '<country_value>',
'company': '<company_value>',
'website': '<website_value>',
'title': '<title_value>',
'leadsource': '<leadsource_value>',
'firstname': '<firstname_value>',
'lastname': '<lastname_value>',
'role': '<role_value>',
'industry': '<industry_value>'
}
};
request(options, function(error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
import requests
url = "https://scribe.6sense.com/v2/people/score"
payload=’email=<user_name>@<domain>.com
&country=<country_value>
&company=<company_value>
&website=<website_value>
&title=<title_value>
&leadsource=<leadsource_value>
&firstname=<firstname_value>
&lastname=<lastname_value>
&role=<role_value>
&industry=<industry_value>’
headers = {
'Content-Type': 'application/x-www-form-urlencoded',
'Cache-Control': 'no-cache',
'Authorization': 'Token {your_api_token}'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
{
"info": {
"name": "sample_scribe",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
},
"item": [
{
"name": "https://scribe.6sense.com/v2/people/score",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/x-www-form-urlencoded",
"type": "text"
},
{
"key": "Cache-Control",
"value": "no-cache",
"type": "text"
},
{
"key": "Authorization",
"value": "Token {your_api_token}",
"type": "text"
},
{
"key": "X-Forwarded-For",
"value": "1.0.185.47",
"type": "text",
"disabled": true
}
],
"body": {
"mode": "urlencoded",
"urlencoded": [
{
"key": "email",
"value": "<user_name>@<domain>.com\n",
"type": "text"
},
{
"key": "country",
"value": "<country_value>",
"type": "text"
},
{
"key": "company",
"value": "<company_value>",
"type": "text"
},
{
"key": "website",
"value": "<website_value>",
"type": "text"
},
{
"key": "title",
"value": "<title_value>",
"type": "text"
},
{
"key": "leadsource",
"value": "<leadsource_value>",
"type": "text"
},
{
"key": "firstname",
"value": "<firstname_value>",
"type": "text"
},
{
"key": "lastname",
"value": "<lastname_value>",
"type": "text"
},
{
"key": "role",
"value": "<role_value>",
"type": "text"
},
{
"key": "industry",
"value": "<industry_value>",
"type": "text"
}
]
},
"url": {
"raw": "https://scribe.6sense.com/v2/people/score",
"protocol": "https",
"host": [
"scribe",
"6sense",
"com"
],
"path": [
"v2",
"people",
"score"
],
"query": [
{
"key": "country",
"value": "",
"disabled": true
}
]
}
},
"response": []
}
]
}
| Parameters | |
|---|---|
|
Stringrequired
A Valid Email address for which you are requesting details.
xyz@acme.com
|
|
| country |
Stringrequired
Base country of the company/account
US
|
| website |
Stringoptional
Website of the company/account
acme.com
|
| company |
Stringoptional
Name of the company/account
Dell
|
| title |
Stringoptional
Designation of the Lead
Procurement Manager
|
| leadsource |
Stringoptional
Source of the lead as per your database
Website form
|
| firstname |
Stringoptional
First name of the Lead
ABC
|
| lastname |
Stringoptional
Last name of the Lead
XYZ
|
| role |
Stringoptional
Role of the Lead
Procurement Manager
|
| industry |
Stringoptional
Industry of the company
Software and Technology
|
Response Data
Sample Response
{
"scores": [
{
"product": "6sense",
"company_intent_score": 0,
"company_buying_stage": "Target",
"company_profile_score": 81,
"company_profile_fit": "Strong",
"contact_intent_score": 0,
"contact_grade": "D",
"contact_profile_score": 58,
"contact_profile_fit": "Moderate"
}
]
}
Predictive scores will be returned at the product level. If you have multiple product model, they API will return scores for each product category. To receive score information in the API you will need to enable this feature in the API Settings & Configurations.
For more details on scoring and how scores are determined, please visit the 6sense Knowledge Base in Rev City.
| Parameters | |
|---|---|
| product |
String
The name of the specific predictive model when a customer has more than one model. The product category values are the model names.
ace
|
| company_intent_score |
Number
The numerical intent score that is tied to a specific buying stage. The numerical range is 0-100.
81
|
| company_buying_stage |
String
A 6sense AI-derived in-market prediction of the likelihood to open an opportunity in the next 90 days for a particular product category. Response could be Purchase, Decision, Consideration, Awareness, Target.
Purchase
|
| company_profile_score |
Number
The numerical profile fit score that is tied to a specific profile fit. The numerical range is 0-100.
73
|
| company_profile_fit |
String
Profile fit identifies accounts based on ideal customer profile (ICP) by looking at historical firmographic data within the CRM. Response could be Strong, Moderate, Weak.
Strong
|
| contact_intent_score |
Number
The numerical contact intent score that is tied to a specific contact intent grade. The numerical range is 0-100.
0
|
| contact_grade |
String
A measure of how engaged a person is with your first-party sales and marketing tactics, including any known activity of this type from the MAP or CRM (such as clicking on a website, responding to sales or marketing emails, attending events, and attending webinars). Response could be A, B, C, D.
D
|
| contact_profile_score |
Number
The numerical contact profile fit score that is tied to a specific contact profile fit. The numerical range is 0-100.
51
|
| contact_profile_fit |
String
Contact profile fit identifies the fit of a person based on the historical CRM data of who you’ve sold to in the past. Response could be Strong, Moderate, Weak.
Moderate
|
Response Codes
| Code | Definition |
|---|---|
200 |
OK Successfully returned response against an email address |
404 |
Not found Invalid email ID. Please make sure you have sent a valid email address in email field. |
OTHERS |
Other common HTTP response codes Please see HTTP Response Codes to know more codes. |
In case of invalid email Address, you will get blank data for each of these above mentioned variables. If a field is not present, then we’ll return an empty list or null value for that field.
People Enrichment API
Overview
The People Enrichment API helps you enhance and complete your contact records by returning detailed, structured information about individual professionals. The API uses basic information such as an email ID, LinkedIn URL, or peopleID to get accurate, complete, and verified data about individual professionals. The return data includes job title, company, contact details, social profiles, location, and so on.
Key Benefits
- Enhance lead quality: Update missing details such as job title, company, and seniority to improve lead scoring and routing.
- Improve CRM data: Keep your contact records accurate and complete with real-time enrichment.
- Boost personalization: Power tailored marketing messages and sales outreach using enriched profile data.
Common Use Cases
Real-Time Enrichment in Lead Capture Workflows
Scenario: You want to deliver qualified leads to sales teams instantly after form submissions or chatbot interactions.
Solution: Trigger the enrichment API immediately after a lead is captured using the submitted email or LinkedIn URL.
CRM Lead and Contact Enrichment
Scenario: You receive leads from various sources such as forms, webinars, and events; however, the records are often incomplete.
Solution: Use the People Search API to validate the email or LinkedIn profile is accurate and verify if 6sense has a match. Then use the API to enrich each contact using an email, LinkedIn URL, or 6sense People ID. The API returns verified job titles, company info, seniority level, and contact methods. Sync new data to your CRM.
Data Hygiene and Record Normalization
Scenario: Your CRM and CDP contains outdated or inconsistent contact data, making it hard to maintain accuracy and trust in reports.
Solution: Periodically enrich contacts to validate and normalize fields such as title, phone numbers, and company domain.
Third-Party Data Matching and Attribution
Scenario: You've acquired a third-party list of contacts, but you need to validate identities and attribute them to your internal audiences or campaigns.
Solution: Use the API to enrich the list using emails or LinkedIn URLs and link the enriched profiles to your campaign identifiers through referenceKeys.
How It Works
The API helps you purchase contact data. The following section describes the rules and logic applied to each request.
Input Requirement
You must provide at least one of the following parameters in your request:
- peopleId
- linkedinUrl
Query Logic
Use a single query schema for each contact you wish to purchase; multiple queries can be grouped in a single API call.
Contact Credit Consumption
Each record successfully matched and returned will consume one credit. If a contact is matched from multiple inputs, only a single credit will be consumed
Filtering Rules
The API filters out any contact that appears in your client's exclusion list (https://support.6sense.com/docs/company-exclusion).
Limits
You can include up to 25 queries in a single API call. Each query should include a single input parameter (see example).
Rate Limits
The People Enrichment API supports up to 20 queries per second, per customer.
Please review the Version Information before using this API.
Version 2 (Latest)
HTTP Request
Endpoint
POSThttps://api.6sense.com/v2/enrichment/people
Headers
| Header | Value |
|---|---|
| Authorization | Token <api_token> |
| Content-Type | application/json |
Input Params
Following inputs are accepted as query parameters for the request
Sample Request
curl --location --request POST https://api.6sense.com/v2/enrichment/people \
--header 'Content-Type: application/json' \
--header 'Cache-Control: no-cache' \
--header 'Authorization: Token {your_api_key}' \
--data-raw '[
{
"email": "jfrancis@darcosc.net",
"linkedInUrl": "",
"peopleId": "",
"referenceKeys": {
"bpId": "5678",
"bpName": "Beta Inc",
"trackingId": "91011"
}
},
{
"email": "regan.kebede@zemenbank.com",
"linkedInUrl": "",
"peopleId": "",
"referenceKeys": {
"bpId": "5678",
"bpName": "Beta Inc",
"trackingId": "91011"
}
},
{
"email": "",
"linkedInUrl": "",
"peopleId": "a3fa13d3d-77b9-42ae-bcea-4fe214e24dfc",
"referenceKeys": {
"bpId": "1234",
"bpName": "Neta Inc",
"trackingId": "12011"
}
},
{
"email": "",
"linkedInUrl": "",
"peopleId": "af3b0a4a-2123-49b5-b8aa-24822859ae7a",
"referenceKeys": {
"crystalName": "John doe"
}
},
{
"email": "",
"linkedInUrl": "",
"peopleId": "48cbf3e903-4231-4671-a30c-180f5bd18cec",
"referenceKeys": {
"crystalName": "John doe"
}
}
]'
var data = JSON.stringify([
{
"email": "jfrancis@darcosc.net",
"linkedInUrl": "",
"peopleId": "",
"referenceKeys": {
"bpId": "5678",
"bpName": "Beta Inc",
"trackingId": "91011"
}
},
{
"email": "regan.kebede@zemenbank.com",
"linkedInUrl": "",
"peopleId": "",
"referenceKeys": {
"bpId": "5678",
"bpName": "Beta Inc",
"trackingId": "91011"
}
},
{
"email": "",
"linkedInUrl": "",
"peopleId": "a3fa13d3d-77b9-42ae-bcea-4fe214e24dfc",
"referenceKeys": {
"bpId": "1234",
"bpName": "Neta Inc",
"trackingId": "12011"
}
},
{
"email": "",
"linkedInUrl": "",
"peopleId": "af3b0a4a-2123-49b5-b8aa-24822859ae7a",
"referenceKeys": {
"crystalName": "John doe"
}
},
{
"email": "",
"linkedInUrl": "",
"peopleId": "48cbf3e903-4231-4671-a30c-180f5bd18cec",
"referenceKeys": {
"crystalName": "John doe"
}
}
]);
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function() {
if(this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("POST", "https://api.6sense.com/v2/enrichment/people");
xhr.setRequestHeader("Content-Type", "application/json");
xhr.setRequestHeader("Cache-Control", "no-cache");
xhr.setRequestHeader("Authorization", "Token {your_api_token}");
xhr.send(data);
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://api.6sense.com/v2/enrichment/people',
'headers': {
'Content-Type': 'application/json',
'Cache-Control': 'no-cache',
'Authorization': 'Token {your_api_token}'
},
body: JSON.stringify([
{
"email": "jfrancis@darcosc.net",
"linkedInUrl": "",
"peopleId": "",
"referenceKeys": {
"bpId": "5678",
"bpName": "Beta Inc",
"trackingId": "91011"
}
},
{
"email": "regan.kebede@zemenbank.com",
"linkedInUrl": "",
"peopleId": "",
"referenceKeys": {
"bpId": "5678",
"bpName": "Beta Inc",
"trackingId": "91011"
}
},
{
"email": "",
"linkedInUrl": "",
"peopleId": "a3fa13d3d-77b9-42ae-bcea-4fe214e24dfc",
"referenceKeys": {
"bpId": "1234",
"bpName": "Neta Inc",
"trackingId": "12011"
}
},
{
"email": "",
"linkedInUrl": "",
"peopleId": "af3b0a4a-2123-49b5-b8aa-24822859ae7a",
"referenceKeys": {
"crystalName": "John doe"
}
},
{
"email": "",
"linkedInUrl": "",
"peopleId": "48cbf3e903-4231-4671-a30c-180f5bd18cec",
"referenceKeys": {
"crystalName": "John doe"
}
}
])
};
request(options, function(error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
import requests
import json
url = "https://api.6sense.com/v2/enrichment/people"
payload = json.dumps([
{
"email": "jfrancis@darcosc.net",
"linkedInUrl": "",
"peopleId": "",
"referenceKeys": {
"bpId": "5678",
"bpName": "Beta Inc",
"trackingId": "91011"
}
},
{
"email": "regan.kebede@zemenbank.com",
"linkedInUrl": "",
"peopleId": "",
"referenceKeys": {
"bpId": "5678",
"bpName": "Beta Inc",
"trackingId": "91011"
}
},
{
"email": "",
"linkedInUrl": "",
"peopleId": "a3fa13d3d-77b9-42ae-bcea-4fe214e24dfc",
"referenceKeys": {
"bpId": "1234",
"bpName": "Neta Inc",
"trackingId": "12011"
}
},
{
"email": "",
"linkedInUrl": "",
"peopleId": "af3b0a4a-2123-49b5-b8aa-24822859ae7a",
"referenceKeys": {
"crystalName": "John doe"
}
},
{
"email": "",
"linkedInUrl": "",
"peopleId": "48cbf3e903-4231-4671-a30c-180f5bd18cec",
"referenceKeys": {
"crystalName": "John doe"
}
}
])
headers = {
'Content-Type': 'application/json',
'Cache-Control': 'no-cache',
'Authorization': 'Token {your_api_token}'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
{
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
},
{
"key": "Cache-Control",
"value": "no-cache",
"type": "text"
},
{
"key": "Authorization",
"value": "Token {your_api_token}",
"type": "text"
},
{
"key": "X-Forwarded-For",
"value": "1.0.185.47",
"type": "text",
"disabled": true
}
],
"body": {
"mode": "raw",
"raw": "[\n {\n \"email\": \"jfrancis@darcosc.net\",\n \"linkedInUrl\": \"\",\n \"peopleId\": \"\",\n \"referenceKeys\": {\n \"bpId\": \"5678\",\n \"bpName\": \"Beta Inc\",\n \"trackingId\": \"91011\"\n }\n },\n {\n \"email\": \"regan.kebede@zemenbank.com\",\n \"linkedInUrl\": \"\",\n \"peopleId\": \"\",\n \"referenceKeys\": {\n \"bpId\": \"5678\",\n \"bpName\": \"Beta Inc\",\n \"trackingId\": \"91011\"\n }\n },\n {\n \"email\": \"\",\n \"linkedInUrl\": \"\",\n \"peopleId\": \"a3fa13d3d-77b9-42ae-bcea-4fe214e24dfc\",\n \"referenceKeys\": {\n \"bpId\": \"1234\",\n \"bpName\": \"Neta Inc\",\n \"trackingId\": \"12011\"\n }\n },\n {\n \"email\": \"\",\n \"linkedInUrl\": \"\",\n \"peopleId\": \"af3b0a4a-2123-49b5-b8aa-24822859ae7a\",\n \"referenceKeys\": {\n \"crystalName\": \"John doe\"\n }\n },\n {\n \"email\": \"\",\n \"linkedInUrl\": \"\",\n \"peopleId\": \"48cbf3e903-4231-4671-a30c-180f5bd18cec\",\n \"referenceKeys\": {\n \"crystalName\": \"John doe\"\n }\n }\n]",
"options": {
"raw": { "language": "json" }
}
},
"url": "https://api.6sense.com/v2/enrichment/people"
},
"response": []
}
| Parameters | |
|---|---|
| peopleId |
Stringrequired (only if email or linkedinUrl is empty)
A unique 6sense People ID. Note - To retrieve 6sense People ID, use People Search API. Maximum items: 25
hlud-asdsad-asd9as7-28323
|
|
Stringrequired (only if peopleId or linkedinUrl is empty)
Corporate email address. Maximum items: 25
user@example.com
|
|
| linkedinUrl |
Stringrequired (only if peopleId or email is empty)
Public LinkedIn profile URL. Maximum items: 25.
https://www.linkedin.com/us/profilename
|
| referenceKeys |
Objectoptional
Your custom metadata. This is useful for tracking, attribution, or mapping enriched records back to the internal system. In the API response, the exact name will be returned along with the enriched contact data, allowing you to correlate the request and response easily.
CrmLeadID, campaignId, trackingId
|
Response Data
Sample Response
{
"contacts": [
{
"id": "0cac3c15-c1b0-4f78-8a80-e6182c4ee936",
"email": "user@example.com",
"emailConfidence": "A+",
"fullName": "Alex John",
"firstName": "Alex",
"lastName": "John",
"education": [
{
"schoolName": "Darlington High School",
"degrees": [],
"startDate": "",
"endDate": "",
"schoolWebsite": "",
"schoolLocation": ""
}
],
"skills": [
"Blueprint Reading",
"Conduit Installation",
"Construction Safety",
"Customer Service",
"Desire To Learn",
"Electrical Maintenance",
"Electrical Safety",
"Electrical Troubleshooting",
"Leadership",
"Management",
"People Skills",
"Project Management",
"Supervisory Skills",
"Team Leadership"
],
"jobTitle": "Deputy Facilities Manager",
"function": "Administrative",
"level": "Manager",
"division": "Administrative",
"linkedinUrl": "https://www.linkedin.com/in/profilename",
"twitterUrl": "",
"facebookUrl": "",
"phone": "+111223344",
"workPhone": "",
"phoneDNC": "",
"workPhoneDNC": "",
"city": "Darlington",
"state": "South Carolina",
"country": "United States",
"postalCode": "",
"lastUpdated": "2025-01-07T00:00:00Z",
"company": {
"companyId": "23a6dcce8af3aii",
"name": "Darlington County",
"domain": "example.com",
"region": "Northern America",
"country": "United States",
"state": "South Carolina"
},
"referenceKeys": {
"bpId": "5678",
"bpName": "Beta Inc",
"trackingId": "91011"
}
}
]
}
| Parameters | |
|---|---|
| Contact Details |
Basic contact details and identification
|
| contacts[].id |
String
A unique 6sense People ID
0cac3c15-c1b0-4f78-8a80-e6182c4ee936
|
| contacts[].email |
String
Corporate email address
user@example.com
|
| contacts[].emailConfidence |
String
Email confidence. A+ - High Confidence, A - Medium Confidence, B - Low Confidence
A+
|
| contacts[].fullName |
String
Full name of the contact
Alex John
|
| contacts[].firstName |
String
First name of the contact
Alex
|
| contacts[].lastName |
String
Last name of the contact
John
|
| Education |
Education history and details
|
| contacts[].education[].schoolName |
String
Name of the school
Darlington High School
|
| contacts[].education[].degrees[] |
Array
List of degrees obtained
["Bachelor of Science"]
|
| contacts[].education[].startDate |
String
Degree start date
2010-09-01
|
| contacts[].education[].endDate |
String
Degree end date
2014-05-30
|
| contacts[].education[].schoolWebsite |
String
URL of the school website
www.darlington.k12.sc.us
|
| contacts[].education[].schoolLocation |
String
School location
Darlington, SC, USA
|
| Professional Details |
Job and career information
|
| contacts[].skills[] |
Array
A list of professional skills
["Leadership", "Project Management", "Team Leadership"]
|
| contacts[].jobTitle |
String
Current Job title
Deputy Facilities Manager
|
| contacts[].function |
String
Functional area of the job
Administrative
|
| contacts[].level |
String
Seniority level
Manager
|
| contacts[].division |
String
Division within the company
Administrative
|
| Contact Information |
Ways to contact the individual
|
| contacts[].linkedinUrl |
String
Public LinkedIn profile URL
https://www.linkedin.com/in/profilename
|
| contacts[].twitterUrl |
String
Public Twitter profile URL |
| contacts[].facebookUrl |
String
Public Facebook profile URL |
| contacts[].phone |
String
Personal phone number
+111223344
|
| contacts[].workPhone |
String
Work phone number
+18005551234
|
| contacts[].phoneDNC |
String
DNC status of phone. Yes, No, Pending, Disabled
No
|
| contacts[].workPhoneDNC |
String
DNC status of work phone
No
|
| Location |
Geographic information
|
| contacts[].city |
String
City where the contact is based
Darlington
|
| contacts[].state |
String
State
South Carolina
|
| contacts[].country |
String
Country location
United States
|
| contacts[].postalCode |
String
Postal or Zip code
29532
|
| Company Information |
Details about the contact's employer
|
| contacts[].company.companyId |
String
Company ID
23a6dcce8af3aii
|
| contacts[].company.name |
String
Company name
Darlington County
|
| contacts[].company.domain |
String
Company's website domain
example.com
|
| contacts[].company.region |
String
Office region
Northern America
|
| contacts[].company.country |
String
Country of the company's office
United States
|
| contacts[].company.state |
String
State
South Carolina
|
| Reference Keys |
Custom tracking and reference information
|
| contacts[].referenceKeys.custom |
String
A user-defined key to store internal metadata. You can use it for labelling, tracking, reporting, and so on.
5678
|
| Metadata |
Additional information
|
| lastUpdated |
String
Last updated date (YYYY-MM-DD format)
2025-01-07T00:00:00Z
|
Response Codes
| Code | Definition |
|---|---|
200 |
OK Successfully returned response against the given input parameter (email or linkedinUrl or peopleId) |
204 |
No Match Found There are no records available for this request. |
OTHERS |
Other common HTTP response codes Please see HTTP Response Codes to know more codes. |
Version 1
HTTP Request
Endpoint
POSThttps://api.6sense.com/v1/enrichment/people
Headers
| Header | Value |
|---|---|
| Authorization | Token <api_token> |
| Content-Type | application/x-www-form-urlencoded |
Input Params
Following inputs are accepted as query parameters for the request
Sample Request
curl --location --request POST https://api.6sense.com/v1/enrichment/people\
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Cache-Control: no-cache' \
--header 'Authorization: Token {your_api_key}' \
--data-urlencode 'email=<user_name>@<domain>.com' \
OR
curl --location --request POST https://api.6sense.com/v1/enrichment/people\
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Cache-Control: no-cache' \
--header 'Authorization: Token {your_api_key}' \
--data-urlencode 'linkedinUrl={your input value}' \
OR
curl --location --request POST https://api.6sense.com/v1/enrichment/people\
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Cache-Control: no-cache' \
--header 'Authorization: Token {your_api_key}' \
--data-urlencode 'peopleId={your input value}' \
var data = "email=<user_name>@<domain>.com
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function() {
if(this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("POST", "https://api.6sense.com/v1/enrichment/people");
xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
xhr.setRequestHeader("Cache-Control", "no-cache");
xhr.setRequestHeader("Authorization", "Token {your_api_token}");
xhr.send(data);
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://api.6sense.com/v1/enrichment/people',
'headers': {
'Content-Type': 'application/x-www-form-urlencoded',
'Cache-Control': 'no-cache',
'Authorization': 'Token {your_api_token}'
},
form: {
'email': '<user_name>@<domain>.com',
}
};
request(options, function(error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
import requests
url = "https://api.6sense.com/v1/enrichment/people"
payload=’email=<user_name>@<domain>.com’
headers = {
'Content-Type': 'application/x-www-form-urlencoded',
'Cache-Control': 'no-cache',
'Authorization': 'Token {your_api_token}'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
{
"item": [
{
"name": "https://api.6sense.com/v1/enrichment/people",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/x-www-form-urlencoded",
"type": "text"
},
{
"key": "Cache-Control",
"value": "no-cache",
"type": "text"
},
{
"key": "Authorization",
"value": "Token {your_api_token}",
"type": "text"
},
{
"key": "X-Forwarded-For",
"value": "1.0.185.47",
"type": "text",
"disabled": true
}
],
"body": {
"mode": "urlencoded",
"urlencoded": [
{
"key": "email",
"value": "<user_name>@<domain>.com",
"type": "text"
},
]
}
"url": "https://api.6sense.com/v1/enrichment/people"
},
"response": []
}
]
}
| Parameters | |
|---|---|
|
Stringrequired (only if linkedinUrl or peopleId is empty)
A Valid Email address for which you are requesting details.
naveen.titare@6sense.com
|
|
| or linkedinUrl |
Stringrequired (only if email or peopleId is empty)
A Valid LinkedIn Url of a contact for which you are requesting details.
https://www.linkedin.com/in/naveentitare
|
| or peopleId |
Stringrequired (only if email or linkedinUrl is empty)
6sense People id of the Contact for which you are requesting details. These IDs are returned in People Search API.
hlud-asdsad-asd9as7-28323
|
Response Data
Sample Response
{
"person": {
"id": "d121d17f-fc27-4edc-9d19-ce83137c8213",
"email": "abc.xyze@6sense.com",
"emailConfidence": "A+",
"fullName": "ABC XYZ",
"firstName": "ABC",
"lastName": "XYZ",
"title": "senior product manager",
"function": "Product Management",
"level": "Senior",
"division": "Product Management",
"education": [],
"skills": [
"Seo",
"Digital Marketing",
"Marketing Strategy",
"Product Management",
"Project Management",
"Html",
"Product Requirements",
"B2B Software",
"It Strategy",
"Strategy",
"Business Development",
"Business Strategy",
"Consulting"
],
"city": "Pune",
"state": "Maharashtra",
"country": "India",
"postalCode": "",
"phone": "",
"workPhone": "",
"linkedinUrl": "https://www.linkedin.com/in/naveentitare/",
"twitterUrl": "",
"facebookUrl": "https://www.facebook.com/naveen.titare"
},
"company": {
"domain": "6sense.com",
"name": "6sense",
"region": "Southern Asia",
"country": "India",
"state": "Maharashtra"
}
}
| Parameters | |
|---|---|
| Person |
Below are the data points that are available in the API response.
Below are some example of data points that are available in the API response.
|
| id |
String
6sense People id of the Contact
1111-1111-1111-11
|
|
String
Corporate Email address of the Contact
hello@acme.com
|
|
| emailConfidence |
String
Confidence level of email field A+ means High Confidence A means Medium and B means Low confidence
A
|
| fullName |
String
Full Name of the Contact
Road Runner
|
| firstName |
String
First Name of the Contact
Road
|
| lastName |
String
Last Name of the Contact
Runner
|
| education |
String
Education details of the Contact. Variables with empty values are not returned in education. { "startDate": 2021, "endDate": 2008, "schoolLocation": "Indore, Madhya Pradesh, India", "schoolWebsite": "iimidr.ac.in", "schoolName": "Indian Institute Of Management", "degrees": [ "Master Of Business Administration", "Masters" ], }
|
| skills |
String
Professional skills of the Contact { "Business Strategy", "Portfolio Management", "Financial Modelling", "Management", "Banking", }
|
| city |
String
City of the Postal Address
Los Angeles
|
| state |
String
State of the Postal Address
California
|
| country |
String
Country of the Postal Address
US
|
| postalCode |
String
Postal code of the Postal Address
12345
|
| function |
String
Function of the Contact in the organization
Product Management
|
| level |
String
Role/level of the Contact
Sr. Product Manager
|
| division |
String
Division of the Contact
General
|
| title |
String
Job Title of the Contact
Founder
|
| linkedinUrl |
String
LinkedIn profile link of the Contact
link
|
| twitterUrl |
String
Twitter profile link of the Contact
link
|
| facebookUrl |
String
Facebook profile link of the Contact
link
|
| phone |
String
Phone number of the Contact
(415) 212-9225
|
| workPhone |
String
Work phone number of the Contact
(415) 212-9225
|
| Firmographic Variables |
Below are the list of firmographics variables that will be available in the API response.
Below are the list of firmographics variables that will be available in the API response.
|
| name |
String
Name of the company
6sense
|
| domain |
String
Website of the company
6sense.com
|
| region |
String
Office region
North America
|
| country |
String
Office country
United States
|
| state |
String
State
California
|
Response Codes
| Code | Definition |
|---|---|
200 |
OK Successfully returned response against the given input parameter (email or linkedinUrl or peopleId) |
204 |
No Match Found There are no records available for this request. |
OTHERS |
Other common HTTP response codes Please see HTTP Response Codes to know more codes. |
People Search API
Overview
The People Search API allows you to discover new B2B contacts in bulk from the 6sense People database. The 6sense People database is one of the most comprehensive and continuously updated databases of business professionals. By applying various criteria, such as job title, seniority, industry, company domain, location, and others, in a single request, you can search and discover bulk contacts. The endpoint is useful for identifying leads, personalizing outreach, and powering Account-Based Marketing (ABM) efforts.
Key Benefits
- Search for Contact: You can search for people based on company, job title, department, location, or other filters.
- Access Contact Data: You receive results that help identify the contact, along with the type and quality of the data 6sense has available for the contact. Note: The People Search API doesn't return email or phone number fields directly. To retrieve this information, you must use the People Enrichment API.
- Update Contacts in your CRM or Marketing Tools: You can use the People Search API to find relevant contacts and then enrich them using the People Enrichment API before syncing them with your CRMs, such as Salesforce, and HubSpot, or feed into marketing platforms for campaigns.
- Pagination: Results are paginated to manage large datasets.
- Filter to relevant contacts: You can narrow down the results by applying various filters.
Common Use Cases
Building Targeted Contact Lists for Outbound Campaigns
Scenario: You're launching an outbound sales or email campaign and need to identify relevant contacts across a specific industry or account list.
Solution: Use filters such as jobTitle country, domain, and industryNAICS to return contacts who match your target profile.
Identifying Buying Committee Members Across Key Accounts
Scenario: You’re targeting strategic accounts and want to find multiple roles within the buying group—like decision-makers, influencers, and users.
Solution: Use a combination of domain, jobTitle, level, and function to uncover full buying teams inside your target companies.
Segment and Expand Market Coverage by Region or Industry
Scenario: You’re expanding into a new vertical or region and need a broad list of relevant contacts to feed your top-of-funnel engine.
Solution: Use filters like industryNAICS, country, state, and jobTitle to pull contacts that match your new go-to-market segment.
Feed Enrichment Pipelines with Net-New Contact
Scenario: You want to discover new contacts for enrichment, scoring, and routing within your existing lead management system.
Solution: Use the People Search API to generate contact records, then send the peopleId into the People Enrichment API for full details.
Lead Validation
Scenario: You capture a lead’s email or LinkedIn URL from a form and want to check if it’s valid and known to 6sense.
Solution: Use the People Search API to check for a match. Only enrich leads that return a match.
How It Works
The API helps you retrieve targeted contact data using a flexible query structure. The following section describes the rules and logic applied to each request.
Input Requirement
You must provide at least one of the following parameters in your request:
- domain
- industryNAICS
- linkedinUrl
- country
- jobTitle
Query Logic
Search queries use a flat combination of AND and OR logic. For example:
(Product Manager OR Engineer) AND (US OR Canada)
Nested groupings, for example, (A OR B) AND (C OR D)) are not supported. All filters must be applied in a flat structure.
Filtering Rules
The API filters out any contact that appears in your client's exclusion list (https://support.6sense.com/docs/company-exclusion). Use optional fields such as hasEmail, hasPhone, and emailConfidence to narrow down the dataset further.
Limits
You can include up to 10 values per filter field. For example, 10 job titles, 10 domains, and so on. You can use pagination parameters pageNo and pageSize to manage large result sets. The maximum page size is 1000.
Rate Limits
The People Search API supports up to 10 queries per second, per customer.
Please review the Version Information before using this API.
Version 2 (Latest)
HTTP Request
Endpoint
POSThttps://api.6sense.com/v2/search/people
Headers
| Header | Value |
|---|---|
| Authorization | Token <api_token> |
| Content-Type | application/json |
Input Params
Following inputs are accepted as query parameters for the request
Sample Request
curl --location --request POST 'https://api.6sense.com/v2/search/people' \
--header 'accept: application/json' \
--header 'Authorization: Token {your-token-here}' \
--header 'Content-Type: application/json' \
--data-raw '{
"domain": ["example.com", "2example.com"],
"industryNAICS": 54151,
"email": "user@example.com",
"linkedinUrl": "linkedin.com/us/user",
"country": "US, Canada",
"jobTitle": "cxo, manager",
"function": "CEO",
"division": "General",
"level": "Director",
"city": "San Francisco",
"state": "California",
"hasEmail": true,
"emailConfidence": "A+",
"hasPhone": true,
"hasWorkPhone": true,
"hasLinkedinUrl": true,
"hasTwitterUrl": true,
"hasFacebookUrl": true,
"pageNo": 1,
"pageSize": 1000
}'
var data = JSON.stringify({
"domain": ["example.com", "2example.com"],
"industryNAICS": 54151,
"email": "user@example.com",
"linkedinUrl": "linkedin.com/us/user",
"country": "US, Canada",
"jobTitle": "cxo, manager",
"function": "CEO",
"division": "General",
"level": "Director",
"city": "San Francisco",
"state": "California",
"hasEmail": true,
"emailConfidence": "A+",
"hasPhone": true,
"hasWorkPhone": true,
"hasLinkedinUrl": true,
"hasTwitterUrl": true,
"hasFacebookUrl": true,
"pageNo": 1,
"pageSize": 1000
});
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function() {
if(this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("POST", "https://api.6sense.com/v2/search/people");
xhr.setRequestHeader("accept", "application/json");
xhr.setRequestHeader("Authorization", "Token {your-token-here}");
xhr.setRequestHeader("Content-Type", "application/json");
xhr.send(data);
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://api.6sense.com/v2/search/people',
'headers': {
'Content-Type': 'application/json',
'Authorization': 'Token {your_api_token}'
},
form: {
"domain": ["example.com", "2example.com"],
"industryNAICS": 54151,
"email": "user@example.com",
"linkedinUrl": "linkedin.com/us/user",
"country": "US, Canada",
"jobTitle": "cxo, manager",
"function": "CEO",
"division": "General",
"level": "Director",
"city": "San Francisco",
"state": "California",
"hasEmail": true,
"emailConfidence": "A+",
"hasPhone": true,
"hasWorkPhone": true,
"hasLinkedinUrl": true,
"hasTwitterUrl": true,
"hasFacebookUrl": true,
"pageNo": 1,
"pageSize": 1000
}
};
request(options, function(error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
import requests
url = "https://api.6sense.com/v2/search/people"
payload=’domain=["example.com", "2example.com"]&
industryNAICS=54151&
email="user@example.com"&
linkedinUrl="linkedin.com/us/user"&
country="US& Canada"&
jobTitle="cxo& manager"&
function="CEO"&
division="General"&
level="Director"&
city="San Francisco"&
state="California"&
hasEmail=true&
emailConfidence="A+"&
hasPhone=true&
hasWorkPhone=true&
hasLinkedinUrl=true&
hasTwitterUrl=true&
hasFacebookUrl=true&
pageNo=1&
pageSize=1000’
headers = {
'Content-Type': 'application/json',
'Authorization': 'Token {your_api_token}'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
{
"item": [
{
"name": "https://api.6sense.com/v2/search/people",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/json",
"type": "text"
},
{
"key": "Authorization",
"value": "Token {your_api_token}",
"type": "text"
},
],
"body": {
"mode": "raw",
"raw": "{\n \"domain\": [\"example.com\", \"2example.com\"],\n \"industryNAICS\": \"54151\",\n \"email\": \"user@example.com\",\n \"linkedinUrl\": \"linkedin.com/us/user\",\n \"country\": \"US, Canada\",\n \"jobTitle\": \"cxo, manager\",\n \"function\": \"CEO\",\n \"division\": \"General\",\n \"level\": \"Director\",\n \"city\": \"San Francisco\",\n \"state\": \"California\",\n \"hasEmail\": true,\n \"emailConfidence\": \"A+\",\n \"hasPhone\": true,\n \"hasWorkPhone\": true,\n \"hasLinkedinUrl\": true,\n \"hasTwitterUrl\": true,\n \"hasFacebookUrl\": true,\n \"pageNo\": 1,\n \"pageSize\": 1000\n}",
"options": {
"raw": {
"language": "json"
}
}
}
"url": "https://api.6sense.com/v2/search/people"
},
"response": []
}
]
}
| Parameters | |
|---|---|
| domain |
ArrayRequired
A list of company domains to search. Maximum items 10. Note: You must provide at least one of following parameters in your request: domain, industryNAICS, email, linkedinUrl, country, or jobTitle. This ensures the API can return relevant contact matches.
["example.com", "2example.com"]
|
| industryNAICS |
StringRequired
North American Industry Classification System (NAICS) codes to filter by industry. Maximum items 10. Note: You must provide at least one of following parameters in your request: domain, industryNAICS, email, linkedinUrl, country, or jobTitle. This ensures the API can return relevant contact matches.
54151
|
|
StringRequired
A list of email addresses to match. Maximum items 10. Note: You must provide at least one of following parameters in your request: domain, industryNAICS, email, linkedinUrl, country, or jobTitle. This ensures the API can return relevant contact matches.
user@example.com
|
|
| linkedinUrl |
StringRequired
A list of Linkedin URLs to match. Maximum items 10. Note: You must provide at least one of following parameters in your request: domain, industryNAICS, email, linkedinUrl, country, or jobTitle. This ensures the API can return relevant contact matches.
https://www.linkedin.com/in/profilename
|
| country |
StringRequired
Filters by country. Supports fuzzy matching. If not specified, results will include all country locations where the company has offices. Maximum items 10. Note: You must provide at least one of following parameters in your request: domain, industryNAICS, email, linkedinUrl, country, or jobTitle. This ensures the API can return relevant contact matches.
US, Canada
|
| jobTitle |
StringRequired
Filters by job title. Supports fuzzy matching. Maximum items 10. Note: You must provide at least one of following parameters in your request: domain, industryNAICS, email, linkedinUrl, country, or jobTitle. This ensures the API can return relevant contact matches.
cxo, manager
|
| function |
StringOptional
Filters by job function.
CEO
|
| division |
StringOptional
Filters by company division within company.
General
|
| level |
StringOptional
Filters by job level.
Director
|
| city |
StringOptional
Filters by city. If not specified, results will include all city locations where the company has offices. Maximum items 10.
San Francisco
|
| hasEmail |
BooleanOptional
Filters by email availability.
true
|
| emailConfidence |
StringOptional
Filters by email confidence. A+ - High Confidence, A - Medium Confidence, B - Low Confidence
A+
|
| hasPhone |
BooleanOptional
Filters by phone availability.
true
|
| hasWorkPhone |
BooleanOptional
Filters by work phone availability.
true
|
| hasLinkedinUrl |
BooleanOptional
Filters by presence of LinkedIn URL.
true
|
| hasTwitterUrl |
BooleanOptional
Filters by presence of Twitter URL.
true
|
| hasFacebookUrl |
BooleanOptional
Filters by presence of Facebook URL.
true
|
| pageNo |
IntegerOptional
Page number for pagination.
1
|
| pageSize |
IntegerOptional
Number of records per page. Maximum items 1000. Default value is 1000.
1000
|
Response Data
Sample Response
{
"totalRecordCount": 1,
"totalPage": 1,
"pageNumber": 1,
"pageSize": 50,
"contacts": [
{
"id": "8ac238ce-e201-4eb0-9e59-05c8faa8df69",
"fullName": "alexjohn",
"firstName": "alex",
"lastName": "john",
"jobTitle": "Senior Treasury Manager",
"hasEmail": true,
"emailConfidence": "A",
"hasPhone": true,
"phoneDNC": "No",
"hasWorkPhone": false,
"workPhoneDNC": "No",
"hasLinkedinUrl": true,
"hasTwitterUrl": true,
"hasFacebookUrl": true,
"hasCity": true,
"hasState": true,
"hasCountry": true,
"hasPostalCode": false,
"hasFunction": true,
"hasLevel": true,
"hasDivision": true,
"lastUpdated": "2025-06-29",
"company": {
"companyID": "03ca7b44bc5a7c2",
"name": "Company name",
"domain": "example.com",
"country": "United States"
}
}
]
}
| Parameters | |
|---|---|
| Detail |
Below are the data points that are available in the API response.
Below are some example of data points that are available in the API response.
|
| totalRecordCount |
Integer
Total number of matched records.
1
|
| totalPage |
Integer
Total number of pages available.
1
|
| pageNumber |
Integer
The current page number returned.
1
|
| pageSize |
Integer
Number of records per page
50
|
| contacts |
Array
List of contacts records. |
| contacts[].id |
String
A unique 6sense People ID. You can use the 6sense People ID with the People Enrichment API.
8ac238ce-e201-4eb0-9e59-05c8faa8df69
|
| contacts[].fullName |
String
Contact's full name.
alexjohn
|
| contacts[].firstName |
String
First name of the contact.
alex
|
| contacts[].lastName |
String
Last name of the contact.
john
|
| contacts[].jobTitle |
String
Contact's current job title.
Senior Treasury Manager
|
| contacts[].hasEmail |
Boolean
Indicates whether a corporate email address is available.
true
|
| contacts[].emailConfidence |
String
Email confidence level. A+ - High confidence, A - Medium confidence, B - Low confidence.
A
|
| contacts[].hasPhone |
String
Indicates whether a personal phone number is available.
true
|
| contacts[].phoneDNC |
String
DNC status of personal phone. (Yes, No, Pending, etc.)
No
|
| contacts[].hasWorkPhone |
Boolean
Indicates whether a work phone number is available.
false
|
| contacts[].workPhoneDNC |
String
DNC status of work phone.
No
|
| contacts[].hasLinkedinUrl |
Boolean
Indicates whether a LinkedIn URL is available.
true
|
| contacts[].hasTwitterUrl |
Boolean
Indicates whether a Twitter URL is available.
true
|
| contacts[].hasFacebookUrl |
Boolean
Indicates whether a Facebook URL is available.
true
|
| contacts[].hasCity |
Boolean
Indicates whether city-level location is available.
true
|
| contacts[].hasState |
Boolean
Indicates whether state-level location is available.
true
|
| contacts[].hasCountry |
Boolean
Indicates whether country-level location is available.
true
|
| contacts[].hasPostalCode |
Boolean
Indicates whether a postal code is available.
false
|
| contacts[].hasFunction |
Boolean
Indicates whether the contact's job function is available.
true
|
| contacts[].hasLevel |
Boolean
Indicates whether the contact's seniority level is available.
true
|
| contacts[].hasDivision |
Boolean
Indicates whether the business division is available.
true
|
| contacts[].lastUpdated |
String (date)
Date when the contact was last updated (YYYY-MM-DD format)
2025-06-29
|
| contacts[].company.companyID |
String
A unique 6sense Company ID.
03ca7b44bc5a7c2
|
| contacts[].company.name |
String
Company name
Company name
|
| contacts[].company.domain |
String
Company's website domain
example.com
|
| contacts[].company.country |
String
Country of the company's office.
United States
|
Response Codes
| Code | Definition |
|---|---|
200 |
OK Successfully returned response against an account. |
204 |
No Match Found There are no records available for this request. |
OTHERS |
Other common HTTP response codes Please see HTTP Response Codes to know more codes. |
Version 1
HTTP Request
Endpoint
POSThttps://api.6sense.com/v1/search/people
Headers
| Header | Value |
|---|---|
| Authorization | Token <api_token> |
| Content-Type | application/json |
Input Params
Following inputs are accepted as query parameters for the request
Sample Request
curl --location --request POST 'https://api.6sense.com/v1/search/people' \
--header 'accept: application/json' \
--header 'Authorization: Token {your-token-here}' \
--header 'Content-Type: application/json' \
--data-raw '{
"domain": "6sense.com",
"industry": "Software",
"city": [ "Austin", "Bangalore", "pune" ],
"state": [ "karnataka", "England", "maharashtra" ],
"titles": [ "abx manager", "senior product manager" ]
}
var data = JSON.stringify({
"domain": "6sense.com",
"industry": "Software",
"city": [ "Austin", "Bangalore", "pune" ],
"state": [ "karnataka", "England", "maharashtra" ],
"titles": [ "abx manager", "senior product manager" ]
});
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function() {
if(this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("POST", "https://api.6sense.com/v1/search/people");
xhr.setRequestHeader("accept", "application/json");
xhr.setRequestHeader("Authorization", "Token {your-token-here}");
xhr.setRequestHeader("Content-Type", "application/json");
xhr.send(data);
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://api.6sense.com/v1/search/people',
'headers': {
'Content-Type': 'application/json',
'Authorization': 'Token {your_api_token}'
},
form: {
"domain": "6sense.com",
"industry": "Software",
"city": [ "Austin", "Bangalore", "pune" ],
"state": [ "karnataka", "England", "maharashtra" ],
"titles": [ "abx manager", "senior product manager" ]
}
};
request(options, function(error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
import requests
url = "https://api.6sense.com/v1/search/people"
payload=’domain=6sense.com&
industry="Software"&
city="[ "Austin", "Bangalore", "pune" ]&
state=[ "karnataka", "England", "maharashtra" ]&
titles=[ "abx manager", "senior product manager" ]’
headers = {
'Content-Type': 'application/json',
'Authorization': 'Token {your_api_token}'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
{
"item": [
{
"name": "https://api.6sense.com/v1/search/people",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/json",
"type": "text"
},
{
"key": "Authorization",
"value": "Token {your_api_token}",
"type": "text"
},
],
"body": {
"mode": "urlencoded",
"urlencoded": [
{
"key": "domain",
"value": "6sense.com",
"type": "text"
},
{
"key": "industry",
"value": "Software",
"type": "text"
},
{
"key": "city",
"value": [ "Austin", "Bangalore", "pune" ],
"type": "list"
},
{
"key": "state",
"value": [ "karnataka", "England", "maharashtra" ],
"type": "list"
},
{
"key": "titles",
"value": [ "abx manager", "senior product manager" ],
"type": "list"
},
]
}
"url": "https://api.6sense.com/v1/search/people"
},
"response": []
}
]
}
| Parameters | |
|---|---|
| domain |
StringRequired
A Valid domain of the account for which you are requesting details.
6sense.com
|
| city |
ArrayOptional
Applicable city list can be found in the People Search Dictionary API for the input domain. Accepts single or multiple values separated by comma and maximum 10 values are accepted. If you don’t pass any filter values then response will include all the city location of the account.
San Francisco, Los Angeles
|
| state |
ArrayOptional
Applicable state list can be found in the People Search Dictionary API for the input domain. Accepts single or multiple values separated by comma and maximum 10 values are accepted. If you don’t pass any filter values then response will include all the state location of the account.
California, Florida
|
| country |
StringOptional
Applicable country list can be found in the People Search Dictionary API for the input domain. Accepts single or multiple values separated by comma and maximum 10 values are accepted. If you don’t pass any filter values then response will include all the country location of the account.
US, Canada
|
| industry |
StringOptional
Applicable Industry list can be found in the People Search Dictionary API for the input domain. Accepts single value only. If you don’t pass any filter values then response will include all the Industries mapped with the account.
Information Technology
|
| titles |
ArrayOptional
List of all Job Titles can be found in the People Search Dictionary API for the input domain. Accepts single or multiple values separated by comma and maximum 10 values are accepted. If you don’t pass any filter values then response will include all the Job titles available for the account.
cxo, manager, vp
|
| pageNo |
IntegerOptional
Valid page number for which you want to get results.
1
|
| pageSize |
IntegerOptional
Use pageSize to limit the number of responses per page. Maximum and default page size is 50 results per page.
50
|
Response Data
Sample Response
{
"domain": "6sense.com",
"city": [ "Bangalore", "Pune" ],
"state": [ "Karnataka", "Maharashtra" ],
"country": [ "India" ],
"titles": [ "senior product manager" ],
"totalRecordCount": 8,
"totalPage": 1,
"pageNumber": 1,
"pageSize": 50,
"data": [
{
"peopleId": "xxx-xxx-xxx-xx-xx",
"hasEmail": true,
"fullName": "A******* S****",
"firstName": "A*******",
"lastName": "S****",
"hasPhone": false,
"city": "Bangalore",
"state": "Karnataka",
"country": "India",
"function": "Product Management",
"division": "Product Management",
"seniorityLevel": "Senior"
}, {
"peopleId": "xxx-xxx-xxx-xx-xx",
"hasEmail": true,
"fullName": "S**** J*****",
"firstName": "S****",
"lastName": "J*****",
"hasPhone": false,
"city": "Pune",
"state": "Maharashtra",
"country": "India",
"function": "Product Management",
"division": "Product Management",
"seniorityLevel": "Senior"
}
]
}
| Parameters | |
|---|---|
| Detail |
Below are the data points that are available in the API response.
Below are some example of data points that are available in the API response.
|
| domain |
String
Domain name of the account, for which you have requested data.
6sense.com
|
| city |
String
List of cities, for which you have requested data. If you have not used any filter values then response will include all the city location of the account.
San Francisco, Los Angeles
|
| state |
String
List of states, for which you have requested data. If you have not used any filter values then response will include all the state location of the office of the account.
California, Florida
|
| country |
String
List of countries, for which you have requested data. If you have not used any filter values then response will include all the country location of the office of the account.
US, Canada
|
| titles |
String
List of titles, for which you have requested data. If you have not used any filter values then response will include all the job titles available for that account.
cxo, manager, vp
|
| totalRecordCount |
Number
Total number of records available for the requested data.
6
|
| totalPage |
Number
Total no. of pages available for the requested data. You can use this range as reference and accordingly use it in pageNumber.
10
|
| pageNumber |
Number
Page no. for which you have requested data.
3
|
| pageSize |
Number
Number of records available per page.
10
|
| peopleId |
String
Unique 6sense ID of a people (or contact or lead). You can use this in People Enrichment API and get contact details.
121212
|
| hasEmail |
Boolean
Whether or not 6sense has people (or contact or lead) information. True represents data is available and False represents data is not available.
true
|
| fullName |
String
Masked Full Name of the people (or contact or lead)
N**** X**
|
| firstName |
String
Masked First Name of the people (or contact or lead)
N****
|
| lastName |
String
Masked Last Name of the people (or contact or lead
X**
|
| hasPhone |
Boolean
Whether or not 6sense has contact information. True represents data is available and False represents data is not available.
true
|
| hasWorkPhone |
Boolean
Whether or not 6sense has contact information. True represents data is available and False represents data is not available.
true
|
| city |
String
City location of the people (or contact or lead)
san francisco
|
| state |
String
State location of the people (or contact or lead)
california
|
| country |
String
Country location of the people (or contact or lead)
United States
|
| function |
String
Function of the people (or contact or lead) in the company
CEO
|
| division |
String
Division in which the people (or contact or lead) works in the company.
General
|
| seniorityLevel |
String
Seniority level of the people (or contact or lead) in the company.
Director
|
Response Codes
| Code | Definition |
|---|---|
200 |
OK Successfully returned response against an account. |
204 |
No Match Found There are no records available for this request. |
OTHERS |
Other common HTTP response codes Please see HTTP Response Codes to know more codes. |
People Search Dictionary API
This Dictionary API is a supporting API for People Search API. This API delivers the list of data that you need to use in input parameters for People Search API. Dictionary API will work with the API token used for People Search API.
HTTP Request
Endpoint
GEThttps://api.6sense.com/v1/dictionary/peopleSearch
Headers
| Header | Value |
|---|---|
| Authorization | Token <api_token> |
Input Params
Following inputs are accepted as query parameters for the request
Sample Request
curl --location --request GET 'https://api.6sense.com/v1/dictionary/peopleSearch?domainName=6sense.com&pageNumber=1&pageSize=999' \
--header 'accept: application/json' \
--header 'Authorization: Token {your-token-here}'
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function() {
if(this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("GET", "https://api.6sense.com/v1/dictionary/peopleSearch?domainName=6sense.com&pageNumber=1&pageSize=999");
xhr.setRequestHeader("accept", "application/json");
xhr.setRequestHeader("Authorization", "Token cf7f1f732b9c2ee213f338ee281df4a0746262be");
xhr.send();
var request = require('request');
var options = {
'method': 'GET',
'url': 'https://api.6sense.com/v1/dictionary/peopleSearch?domainName=6sense.com&pageNumber=1&pageSize=999',
'headers': {
'Authorization': 'Token {your_api_token}'
}
};
request(options, function(error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
import requests
url = "https://api.6sense.com/v1/dictionary/peopleSearch?domainName=6sense.com&pageNumber=1&pageSize=999"
headers = {
'Authorization': 'Token {your_api_token}'
}
response = requests.request("GET", url, headers=headers)
print(response.text)
{
"item": [
{
"name": "https://api.6sense.com/v1/dictionary/peopleSearch?domainName=6sense.com&pageNumber=1&pageSize=999",
"request": {
"method": "GET",
"header": [
{
"key": "Authorization",
"value": "Token {your_api_token}",
"type": "text"
},
],
"url": "https://api.6sense.com/v1/dictionary/peopleSearch?domainName=6sense.com&pageNumber=1&pageSize=999"
},
"response": []
}
]
}
| Parameters | |
|---|---|
| domainName |
StringRequired
A Valid domain of the account for which you are requesting details.
6sense.com
|
| pageNumber |
IntegerOptional
Provide the Page number to get that page response.
1
|
| pageSize |
IntegerOptional
Use pageSize to limit the number of responses per page. Maximum and default page size is 1000 results per page.
50
|
Response Data
Sample Response
{
"city": [ "Auckland", "Barcelona", "Kharkiv", "Kolding" ],
"state": [ "Auckland", "Catalonia", "Kharkiv", "South Denmark" ],
"country": [ "Denmark", "Libya", "New Zealand", "Spain", "Ukraine" ],
"titles": [ "account manager", "business development representative smb uk ireland", "customer engineer", "educator", "group lead" ],
"industry": [ "Business Services", "Information Technology", "Internet", "Software" ],
"totalRecordCount": 146975,
"totalPage": 29395,
"pageNumber": 1,
"pageSize": 5
}
| Parameters | |
|---|---|
| Detail |
Below are the data points that are available in the API response.
Below are some example of data points that are available in the API response.
|
| city |
String
All the cities where the account has offices.
San Francisco, Los Angeles
|
| state |
String
All the states where the account has offices.
California, Florida
|
| country |
String
All the countries where the account has offices.
US, Canada
|
| titles |
String
List of all the job titles available for that account.
cxo, manager, vp
|
| totalRecordCount |
Number
Maximum number of records available for city, state, country and titles.
6
|
| totalPage |
Number
Total no. of pages available for the requested data. You can use this range as reference and accordingly use it in pageNumber.
10
|
| pageNumber |
Number
Page no. for which you have requested data.
3
|
| pageSize |
Number
Number of records per page. Maximum and default is 1000. You can also limit the page size between 1-1000
10
|
Response Codes
| Code | Definition |
|---|---|
200 |
OK Successfully returned response against an account. |
204 |
No Match Found There are no records available for this request. |
OTHERS |
Other common HTTP response codes Please see HTTP Response Codes to know more codes. |
FAQs
Please reach out to your Customer Success Manager for additional questions.
Q: What are Firmographics?
A: Firmographics are a collection of descriptive attributes used by B2B organizations to segment their target market and discover their ideal customers. Such data helps categorize companies according to geographic location, industry, customer base, type of organization, technologies used, etc. With this information at hand, you can build a more effective lead generation strategy and improve your marketing and sales campaigns. Know more about Firmographics.
Q: Will these API slow down my page load?
A: Not at all! The API is designed to load asynchronously in the background.
Q: How many API calls are made per visitor in Company Identification API?
A: One API call per visitor browsing your website.
Q: How fast is the response time for the API?
A: Generally, under 150ms depending on location, with under 50ms not uncommon in US. It is production ready, built to scale, and has already been deployed on hundreds of pages without issue.
Q: Do you support both client-side and server-side implementations?
A: Company Identification API is designed for client-side implementation to unlock use cases like real time web visitor de-anonymization, website personalization, etc. where latency is a important. We do not recommend server side implementation of this API. If you have a complex use case, please talk to our team.
For other APIs, we recommend server-side implementations only.
Q: I want to integrate with a solution outside of the 6sense Network. Can 6sense do it?
A: The answer is dependent on the solution and business constraints and sometimes requires development work but is most likely yes. Contact your 6sense Customer Success Manager for more details or an integration request.
Q: I’m on my mobile cellular network, will the API work?
A: Your cellular network will have an IP address that belongs to a cell company (like ATT). The API will most likely identify the mobile visitor as your mobile provider.
Q: I’m at my Company’s HQ, why is the data identifying me as a different company?
A: It’s likely that we are identifying the previous tenant/occupant of your HQ. It’s also likely that you share a block of IPs from another tenant in the building. It’s also likely that your ISP has made a recent change.
Q: What is your match rate?
A: 6sense delivers one of the highest match rates in the industry. The match rate depends on the type of traffic you are seeing. For example: If the website is primarily B2B, software and tech, and US based, it can be as high as 75%. However, we are constantly making improvements to our data to boost the match rate so please don't hesitate to give us feedback.
Q: Why is the data incorrect?
A: 6sense has the best in house data scientists, but we are only as good as our data that we receive. Furthermore, as we get our data from data vendors, we are at the mercy at how quickly the data vendors update them. Our machine learning algorithm is constantly getting better and will self-correct as we see more intent data on the B2B network.
Q: How often does the firmographic data update?
A: 6sense gets its data from data vendors generally monthly or quarterly.
Q: Do you have a static list of values that are populated in the Company Identification API?
A: Yes! See Available Data Values for Key Firmographic Properties. You would need a 6sense account to access this.