Similar Contacts

The Similar Contacts API lets you fetch lookalike contacts using the same parameters as the Enrichment API.

To get more detail about the API parameters, response types and sample calls, click the arrow to the right on the card below.

Get similar contacts

GET https://api.exactbuyer.com/v1/similar-contacts

This endpoint allows you to find similar contacts for a given social profile/email/phone.

Query Parameters

Name	Type	Description
first_name	string	The first name of the person to look up.
last_name	string	The last name of the person to look up.
company_name	string	The name of a company where the person works at.
company_domain	string	The website of a company where the person works at.
phone	string	The phone number to look up.
email	string	The email address to look up.
social_profile	string	The social profile to lookup e.g. linkedin profile URL
size	Int	Number of similar companies in the output. Maximum: 10 Default: 10

Headers

Name	Type	Description
X-API-Key	string	Your API key

200 Fetched similar contacts successfully.

[
    {
        "job_title": "Founder and Lead Consultant",
        "linkedin": [
            "linkedin.com/in/cynthia-ruff"
        ],
        "location": "atlanta, georgia, united states",
        "name": "Cynthia Ruff",
        "similarity_score": 1.74
    },
    {
        "job_title": "Chief Evangelist Officer",
        "linkedin": [
            "linkedin.com/in/thomasmschwab",
            "linkedin.com/in/tom-schwab-a2944310"
        ],
        "location": "kalamazoo, michigan, united states",
        "name": "Thomas Schwab",
        "similarity_score": 1.63
    },
    {
        "job_title": "Co-Founder & CTO",
        "linkedin": [
            "linkedin.com/in/hassan-chahrour-4b49b817"
        ],
        "location": "New York, United States of America",
        "name": "Hassan Chahrour",
        "similarity_score": 1.62
    },
    {
        "job_title": "Co-Founder & CTO",
        "linkedin": [
            "linkedin.com/in/hassanchr"
        ],
        "location": "New York, United States of America",
        "name": "Hassan Chahrour",
        "similarity_score": 1.62
    },
    {
        "job_title": "Co-Founder & CEO",
        "linkedin": [
            "linkedin.com/in/markeld",
            "linkedin.com/in/markellos-diorinos-aa6aa9"
        ],
        "location": "Athens Metropolitan Area, Greece",
        "name": "Markellos Diorinos",
        "similarity_score": 1.61
    },
    {
        "job_title": "Co-Founder & CMO",
        "linkedin": [
            "linkedin.com/in/jakubzajicek"
        ],
        "location": "Czechia, Czech Republic",
        "name": "Jakub Zajicek",
        "similarity_score": 1.52
    },
    {
        "job_title": "Co-Founder & CPO",
        "linkedin": [
            "linkedin.com/in/jasondebacco",
            "linkedin.com/in/jason-debacco-983b885"
        ],
        "location": "Caldwell, United States of America",
        "name": "Jason Debacco",
        "similarity_score": 1.51
    },
    {
        "job_title": "Founder",
        "linkedin": [
            "linkedin.com/in/frankovidal"
        ],
        "location": "canada",
        "name": "Franko Vidal",
        "similarity_score": 1.48
    },
    {
        "job_title": "Co-Founder and CEO",
        "linkedin": [
            "linkedin.com/in/katebradley",
            "linkedin.com/in/kate-bradley-chernis-2b0b8a3"
        ],
        "location": "New York City Metropolitan Area, United States of America",
        "name": "Kate Chernis",
        "similarity_score": 1.48
    },
    {
        "job_title": "Board Member",
        "linkedin": [
            "linkedin.com/in/alexharrisjdmba"
        ],
        "location": "San Francisco, United States of America",
        "name": "Alex Harris",
        "similarity_score": 0.53
    }
]

404 Could not fetch the contacts.

{
    "errorText": "No contact found for [e-mail]"
}

API Response

Similar Contacts

[
    {
        "job_title": "Founder and Lead Consultant",
        "linkedin": [
            "linkedin.com/in/cynthia-ruff"
        ],
        "location": "atlanta, georgia, united states",
        "name": "Cynthia Ruff",
        "similarity_score": 1.74
    },
    {
        "job_title": "Chief Evangelist Officer",
        "linkedin": [
            "linkedin.com/in/thomasmschwab",
            "linkedin.com/in/tom-schwab-a2944310"
        ],
        "location": "kalamazoo, michigan, united states",
        "name": "Thomas Schwab",
        "similarity_score": 1.63
    },
    {
        "job_title": "Co-Founder & CTO",
        "linkedin": [
            "linkedin.com/in/hassan-chahrour-4b49b817"
        ],
        "location": "New York, United States of America",
        "name": "Hassan Chahrour",
        "similarity_score": 1.62
    },
    {
        "job_title": "Co-Founder & CTO",
        "linkedin": [
            "linkedin.com/in/hassanchr"
        ],
        "location": "New York, United States of America",
        "name": "Hassan Chahrour",
        "similarity_score": 1.62
    },
    {
        "job_title": "Co-Founder & CEO",
        "linkedin": [
            "linkedin.com/in/markeld",
            "linkedin.com/in/markellos-diorinos-aa6aa9"
        ],
        "location": "Athens Metropolitan Area, Greece",
        "name": "Markellos Diorinos",
        "similarity_score": 1.61
    },
    {
        "job_title": "Co-Founder & CMO",
        "linkedin": [
            "linkedin.com/in/jakubzajicek"
        ],
        "location": "Czechia, Czech Republic",
        "name": "Jakub Zajicek",
        "similarity_score": 1.52
    },
    {
        "job_title": "Co-Founder & CPO",
        "linkedin": [
            "linkedin.com/in/jasondebacco",
            "linkedin.com/in/jason-debacco-983b885"
        ],
        "location": "Caldwell, United States of America",
        "name": "Jason Debacco",
        "similarity_score": 1.51
    },
    {
        "job_title": "Founder",
        "linkedin": [
            "linkedin.com/in/frankovidal"
        ],
        "location": "canada",
        "name": "Franko Vidal",
        "similarity_score": 1.48
    },
    {
        "job_title": "Co-Founder and CEO",
        "linkedin": [
            "linkedin.com/in/katebradley",
            "linkedin.com/in/kate-bradley-chernis-2b0b8a3"
        ],
        "location": "New York City Metropolitan Area, United States of America",
        "name": "Kate Chernis",
        "similarity_score": 1.48
    },
    {
        "job_title": "Board Member",
        "linkedin": [
            "linkedin.com/in/alexharrisjdmba"
        ],
        "location": "San Francisco, United States of America",
        "name": "Alex Harris",
        "similarity_score": 0.53
    }
]

Minimum Inputs

The minimum combination of inputs that must be present in a request to return valid similar contacts is mentioned below:

email OR social_profile OR phone OR (
    first_name AND last_name AND (company_domain OR company_name)) 

Examples

Get similar contacts via LinkedIn profile

Python

import requests

url = "https://api.exactbuyer.com/v1/similar-contacts"

headers = {
  'X-API-Key': 'YOUR_API_KEY'
}

params = {
    'social_profile': 'https://www.linkedin.com/in/edankrolewicz/',
}

response = requests.get(
  url,
  headers=headers,
  params=params)

print(response.text)

cURL

curl --location --request GET 'https://api.exactbuyer.com/v1/similar-contacts?social_profile=https://www.linkedin.com/in/edankrolewicz/' \
--header 'X-API-Key: YOUR_API_KEY'

Javascript

const myHeaders = new Headers();
myHeaders.append("X-API-Key", "YOUR_API_KEY");


const requestOptions = {
  method: 'GET',
  headers: myHeaders,
  redirect: 'follow'
};

fetch("https://api.exactbuyer.com/v1/similar-contacts?social_profile=https://www.linkedin.com/in/edankrolewicz/", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

Get similar contacts via first name, last name & company domain.

Python

import requests

url = "https://api.exactbuyer.com/v1/similar-contacts"

headers = {
  'X-API-Key': 'YOUR_API_KEY'
}

params = {
    'first_name': 'edan',
    'last_name': 'krolewicz',
    'company_domain': 'exactbuyer.com',
    'required': 'work_email, personal_email'
}

response = requests.get(
  url,
  headers=headers,
  params=params)

print(response.text)

cURL

curl --location --request GET 'https://api.exactbuyer.com/v1/similar-contacts?last_name=krolewicz&first_name=edan&company_domain=exactbuyer.com' \
--header 'X-API-Key: YOUR_API_KEY'

Javascript

const myHeaders = new Headers();
myHeaders.append("X-API-Key", "YOUR_API_KEY");


const requestOptions = {
  method: 'GET',
  headers: myHeaders,
  redirect: 'follow'
};

fetch("https://api.exactbuyer.com/v1/similar-contacts?last_name=krolewicz&first_name=edan&company_domain=exactbuyer.com", requestOptions)  
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));