Bulk Enrichment

The Bulk enrichment API lets you look up multiple people at once. You can enrich up to 1000 profiles in a single API call.

At the moment, the real-time & waterfall options are only available in the single contact 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.

Bulk Enrich Contacts

POST https://api.exactbuyer.com/v1/bulk-enrich

This endpoint allows you to enrich multiple contacts at once.

Headers

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

Request Body

Name	Type	Description
required_fields	array	A list of certain fields which must be present in each enriched contact. If the required_fields are specified, a match will only be considered successful if it contains all of these fields. Possible values for each field_type entry in the required_fields list: email: Require any email work_email: Require work email personal_email: Require personal email phone: Require phone number social_profile: Require any social profile e.g. linkedin profile
query_list	array	A list of emails/social profiles/phones to enrich. Up to 1000 inputs can be provided in one request.

200 The enriched contacts will be returned in the same order as the query list in the request. If a record isn't enriched, the 'enriched_contact' object will contain null.

{
  "contacts": [
        {
          "enriched_contact": {
              "full_name": ...,
              .....
            },
          "value": "linkedin.com/in/edankrolewicz"
        },
        {
          "enriched_contact": null,
          "value": "linkedin.com/in/randomlinkedinaddress"
        }
    ],
  "records_enriched": 1
}

API Response

/*The enriched contacts will be returned in the same order as the query list in the request. If a record isn't enriched, the 'enriched_contact' object will contain null. */
{
  "contacts": [
        {
          "enriched_contact": {
              'full_name': ...,
              .....
            },
          "value": "linkedin.com/in/edankrolewicz"
        },
        {
          "enriched_contact": null,
          "value": "linkedin.com/in/randomlinkedinaddress"
        }
    ],
  "records_enriched": 1
}

Request Format

query_list

This array will contain all the targets that a user wants to enrich. These may be in the form of email/social profile/phone

[
  {
      "field_type": "social_profile",
      "value": "linkedin.com/in/edankrolewicz"
  },
  {
      "field_type": "phone",
      "value": "[phone]"
  },
  {
      "field_type": "email",
      "value": "[e-mail]"
  }
]

required_fields

Specify the fields that MUST be present in all enrichments from our API response. The below example tells the ExactBuyer API to return the four fields for all enriched entities. Detailed explanation here

[
  {
    "field_type": "social_profile"
  },
  {
    "field_type": "work_email"
  },
  {
    "field_type": "personal_email"
  },
  {
    "field_type": "phone",
  }
]

Credit Deduction:

The credits deducted will be equal to the amount of records that the bulk enrichment API was successfully able to enrich. This means that if the API was able to find data for the required_fields that were sent as parameters then it will deduct one credit per enrichment.

It does not matter if the contact was previously enriched in the past 30 days through another API, if enrichment is successful for this contact in the bulk enrichment then a credit will be deducted against it.

Examples

Python

import requests
import json

url = "https://api.exactbuyer.com/v1/bulk-enrich"

required_fields = json.dumps([
    {
        "field_type": "social_profile"
    }
])

query_list = json.dumps([{
  "value": "linkedin.com/in/edankrolewicz",
  "field_type": "social_profile"
}])

payload = {
  'required_fields': required_fields,
  'query_list': query_list
}

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

response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)

cURL

curl --location --request POST 'https://api.exactbuyer.com/v1/bulk-enrich' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'required_fields="[
    {
        \"field_type\": \"social_profile\"
    }
]"' \
--form 'query_list="[{
  \"value\": \"linkedin.com/in/edankrolewicz\",
  \"field_type\": \"social_profile\"
}]"'

Javascript

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

const formdata = new FormData();

const required_fields = JSON.stringify([
    {
        "field_type": "social_profile"
    }
]);

const query_list = JSON.stringify([{
  "value": "linkedin.com/in/edankrolewicz",
  "field_type": "social_profile"
}])

formdata.append("required_fields", required_fields);
formdata.append("query_list", query_list);

const requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: formdata,
  redirect: 'follow'
};

fetch("https://api.exactbuyer.com/v1/bulk-enrich", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));