ExactBuyer Docs
1.0.0
Search
K

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.
post
https://api.exactbuyer.com
/v1/bulk-enrich
Bulk Enrich Contacts
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": "+1-773-474-9362"
},
{
"field_type": "email",
"value": "[email protected]"
}
]

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
cURL
Javascript
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 --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\"
}"'
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));