NAV
API DOCS
cURL XHR Postman NodeJS Python

Introduction

Welcome to 6sense, a leading ABM platform helping B2B organizations achieve predictable revenue growth by putting the power of AI, big data, and machine learning behind every member of the revenue team.

6sense uncovers anonymous buying behaviour, prioritizes accounts for sales and marketing, and enables them to engage resistant buying teams with personalized, multi-channel, multi-touch campaigns. 6sense helps revenue teams know everything they need to know about their buyers so they can easily do anything needed to generate more opportunities, increase deal size, get into opportunities sooner, and compete and win more often.

API Overview

The 6sense API is the easiest way to connect with the 6sense platform. It's an HTTP-based API that your apps can use to programmatically. Based on your API endpoint, APIs can return informations like firmographic data, product scoring data and if you have multiple segments published in 6sense ABM platform for APIs then you can also get those. All you need is to pass IP address or email or company Name or any other required input data mentioned in each APIs.

APIs essentially allows two application to communicate with each other. External applications generally uses APIs to request data from 6sense system.

API Overview

List of 6sense APIs

API Name How it helps?
Company Details API Company Details API (previously known as 6signal API) help you identify your anonymous website visitor or leads by taking an IP as input and returns firmographs, segments and scores associated with that IP. In order to consume this API, you would need 6sense Platform Package.
Lead Scoring API Lead Scoring API help you to score your leads using email id on real time basis. In order to consume this API, you would need 6sense Advance Package. This API returns our predictive scores at the product level.
Lead Enrichment API Lead Enrichment API help you to enrich your lead using email id. In order to consume this API, you would need 6sense Essentials Package. This API returns firmographic and your Segments (published in 6sense ABM Platform for APIs).
Lead Enrichment & Scoring API Lead Enrichment and Scoring API (previously known as Real Time Scoring API or RTS) is a combo API for Lead enrichment and Lead scoring in a single response. This API returns firmographs, segments (published in 6sense ABM Platform for APIs) and scores from email id of your customers. You can store these details in your CRM or any other system to have more information about your Lead. In order to consume this API, you would need 6sense Essential + Advance Package.
If your organization doesn’t have access to the 6sense ABM platform, click here to contact.

Let’s start with the First Step!

Get your API Token

An API Token is an alphanumeric 40 character long key phrase randomly generated by 6sense, which will allow your organization to access 6sense APIs and the information we provide through them. API tokens are specific to a given API. An API token will work for the APIs for which it was created and provide information as per your Current 6sense Package for/on that API. Package information is mentioned in each APIs.

This is the most important step to connect to any of the 6sense APIs and without this none of the API works.

  1. You can go to the API Token Management page in the 6sense ABM Platform and find your API tokens.
  2. Example Token API Token Example
  3. Copy your API token.

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 and country are required fields and cannot 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 on the latest stable version as we will deprecate the older versions which are no longer recommended to use.

API Current stable Version
Company Details API v3
Lead Scoring API v2
Lead Enrichment API v2
Lead Enrichment & Scoring API v2

Company Details API

Company Details API (previously known as 6signal API) will help you get company informations from that IP of your user.

How Company Details API can help you?

Please review the Version Information before using this API.

HTTP Request

Company Details API data at the account level can be retrieved from the following endpoint:

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
  • When you send a customer's data
    format: <partner_name>-<customer_name>-<customer_api_token>
  • When you send a data, that is not associated with any customer
    format: <partner_name>-<partner_api_token>

Response Data

Sample Response

{
    "company": {
        "company_match": "Match",
        "additional_comment": "Company name or domain match was found",
        "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
This field will help you identify if an IP is a "Match" or "Non-actionable Match" or "No Match"
"Match" or "Non-actionable Match" or "No Match"
additional_comment
String
This field is a supportive field for company_match and provides a reason for each values.
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".
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
Head office of the company
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
Total Employee count
201
employee_range
String
Range for Employee count
100 - 249
annual_revenue
String
Approx. 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 Head Quarter
North America
country_iso_code
String
Country ISO code
US
phone
String
Available Contact number
(415) 212-9225
is_blacklisted
Boolean
Excluded in your 6sense Platform settings (True or False)
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
If you have 6sense predictive package then we will also return our predictive scores at the product level. You will get Scores Information only if you have enabled it in the API Settings & Configurations. Read more
For example, if your company sells 2 products 'ace' and 'grace' you will have 2 product level predictive scores. You may have only one product or many products we will return the predictive scoring for each product you've configured. Below are the variables for each product score.
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
Name of your Product
ace
intent_score
Number
Ranging from 0 to 100. Higher the score, better the conversion.
81
buying_stage
String
Buying stage (Purchase or Decision or Consideration or Awareness) for this product for the above account.
It might also return “Target” if the intent score is very low.
Purchase
profile_score
Number
Ranging from 0 to 100. Higher the score, better the profile fitment.
73
profile_fit
String
Strong or Moderate or Weak profile fit.
Strong
product_display_name
String
Name of your product displayed externally.
ace
Segments
Beyond firmographic identification, we also provide account level segments as configured within the 6sense ABM Platform. This will show segments that you've Published to APIs. Below are the segment information that you will receive in the API response.
Below are sample values for these parameters.
ids
Array
Id for single or multiple segments
12121 or 456456, 119900, 226688,
names
Array
Name of each corresponding segment
“Web Visitors Last 30 days”, “second”, “third”
list
Array
Combined response for Name and id of segments
"name": "Web Visitors Last 30 days", "id": 123123
confidence
String
The Confidence score (Very High or High or Moderate or Low) is a result returned in the Company Details API that represents 6sense 's confidence in the accuracy of the identity of the account.
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.
error iconCurrently, 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.

Lead Scoring API

Lead Scoring API help you to score your leads using email id on real time basis. In order to consume this API, you would need 6sense Advance Package. This API returns our predictive scores at the product level. API Token is auto-generated as per your Current 6sense Package. In case you want to create or delete these 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
email
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

{
  "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"
    }
  ]
}

Score for each product: If you have 6sense predictive package then we will also return our predictive scores at the product level. You will get Scores Information only if you have enabled it in the API Settings & Configurations. Read more
For example, if your company sells 2 products 'ace' and 'grace' you will have 2 product level predictive scores. You may have only one product or many products we will return the predictive scoring for each product you've configured. Below are the variables for each product score.

Parameters
product
String
Name of your Product
ace
company_intent_score
Number
Ranging from 0 to 100. Higher the score, better the conversion.
81
company_buying_stage
String
Buying stage (Purchase or Decision or Consideration or Awareness) for this product for the above account.
It might also return “Target” if the intent score is very low.
Purchase
company_profile_score
Number
Ranging from 0 to 100. Higher the score, better the profile fitment.
73
company_profile_fit
String
Strong or Moderate or Weak profile fit.
Strong
contact_intent_score
Number
Ranging from 0 to 100. Higher the score, better the buying intent.
0
contact_grade
String
contact_grade (D or C or B or A) for this account.
D
contact_profile_score
Number
Ranging from 0 to 100. Higher the score, better the profile fitment.
51
contact_profile_fit
String
Strong or Moderate or Weak profile fit.
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.
error iconIn 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 Enrichment API

Lead Enrichment API help you to enrich your lead using email id. In order to consume this API, you would need 6sense Essentials Package. This API returns firmographic and your Segments (published in 6sense ABM Platform for APIs). API Token is auto-generated as per your Current 6sense Package. In case you want to create or delete these 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/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\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/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"
          },
          {
            "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/enrichment",
          "protocol": "https",
          "host": [
            "scribe",
            "6sense",
            "com"
          ],
          "path": [
            "v2",
            "people",
            "enrichment"
          ],
          "query": [
            {
              "key": "country",
              "value": "",
              "disabled": true
            }
          ]
        }
      },
      "response": []
    }
  ]
}
Parameters
email
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 list of company variables that will be available in the API response.

Parameters
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
Head office of the company
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
Total Employee count
201
employee_range
String
Range for Employee count
100 - 249
annual_revenue
String
Approx. 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 Head Quarter
North America
country_iso_code
String
Country ISO code
US
phone
String
Available Contact number
(415) 212-9225
is_blacklisted
Boolean
Excluded (True or False)
True
Segments
Beyond firmographic identification, we also provide account level segments as configured within the 6sense ABM Platform. This will show segments that you've Published to APIs. Below are the segment information that you will receive in the API response.
Below are sample values for these parameters.
ids
Array
Id for single or multiple segments
12121 or 456456, 119900, 226688,
names
Array
Name of each corresponding segment
“Web Visitors Last 30 days”, “second”, “third”
list
Array
Combined response for Name and id of segments
"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.
error iconIn 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 Enrichment and Scoring API

Lead Enrichment and Scoring API (previously known as Real Time Scoring API or RTS) is a combo API for Lead enrichment and Lead scoring in a single response. This API returns firmographs, segments (published in 6sense ABM Platform for APIs) and scores from email id of your customers. You can store these details in your CRM or any other system to have more information about your Lead. API Token is auto-generated as per your Current 6sense Package. In case you want to create or delete these 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
email
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"
  },
  "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 list of company variables that will be available in the API response.
Below are sample values for these parameters.
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
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
Total Employee count
201
employee_range
String
Range for Employee count
100 - 249
annual_revenue
String
Approx. 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 Head Quarter
North America
country_iso_code
String
Country ISO code
US
phone
String
Available Contact number
(415) 212-9225
is_blacklisted
Boolean
Excluded (True or False)
True
Score for each product
If you have 6sense predictive package then we will also return our predictive scores at the product level. You will get Scores Information only if you have enabled it in the API Settings & Configurations. Read more
For example, if your company sells 2 products 'ace' and 'grace' you will have 2 product level predictive scores. You may have only one product or many products we will return the predictive scoring for each product you've configured. Below are the variables for each product score.
Below are sample values for these parameters.
product
String
Name of your Product
ace
company_intent_score
Number
Ranging from 0 to 100. Higher the score, better the conversion.
81
company_buying_stage
String
Buying stage (Purchase or Decision or Consideration or Awareness) for this product for the above account.
It might also return “Target” if the intent score is very low.
Purchase
company_profile_score
Number
Ranging from 0 to 100. Higher the score, better the profile fitment.
73
company_profile_fit
String
Strong or Moderate or Weak profile fit.
Strong
contact_intent_score
Number
Ranging from 0 to 100. Higher the score, better the buying intent.
0
contact_grade
String
contact_grade (D or C or B or A) for this account.
D
contact_profile_score
String
Ranging from 0 to 100. Higher the score, better the profile fitment.
51
contact_profile_fit
String
Strong or Moderate or Weak profile fit.
Moderate
Segments
Beyond firmographic identification, we also provide account level segments as configured within the 6sense ABM Platform. This will show segments that you've Published to APIs. Below are the segment information that you will receive in the API response.
Below are sample values for these parameters.
ids
Array
Id for single or multiple segments
12121 or 456456, 119900, 226688,
names
Array
Name of each corresponding segment
“Web Visitors Last 30 days”, “second”, “third”
list
Array
Combined response for Name and id of segments
"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.
error iconIn 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.

FAQs

These FAQs should answer most of your queries but if you still have any other queries, please reach out to your Success Manager.

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 Details API?
A: One API call per visitor browsing your website.

: 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 and 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: Yes! you can implement these APIs as per your Tech Stack requirement.

Q: I want to integrate with a solution outside 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 in 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 rate 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 Details API?
A: Yes! See the attachment below, or check out our Dojo for the list of static firmographic attributes. Available Data Values for Key Firmographic Properties. You would need 6sense account to access this.