Enrichment API
Bulk Contact Enrichment Submission
Perform a bulk search for multiple contacts using criteria such as first name,
last name, company name, and more. The API supports filtering based on available contact data,
such as work emails and mobile phones. Additionally, you can pass custom metadata using custom fields.
Note: At least one combination of linkedin_url, business_email,
or (first_name + last_name + company_domain) or (first_name + last_name + company_name) is required.
Request
POST
/contacts
contactsarrayrequiredin body
business_emailstring
The work email address of the person.
Max Length:
255
Example:
john.doe@example.com
company_domainstring
The domain of the company associated with the person.
Max Length:
255
Example:
https://example.com
company_namestring
The name of the company where the person works.
Max Length:
255
Min Length: 1
Example:
ExampleCorp
custom_fieldsobjectrequired
A dictionary of custom metadata associated with the company. This can include fields like Salesforce IDs, external IDs, or other user-defined data.
Example:
{"id":"id_123","salesforce_key":"key_123"}
first_namestring
The first name of the person you are searching for.
Max Length:
255
Min Length: 1
Example:
John
last_namestring
The last name of the person you are searching for.
Max Length:
255
Min Length: 1
Example:
Doe
linkedin_urlstring
The LinkedIn profile URL of the person.
Max Length:
255
Example:
https://www.linkedin.com/in/johndoe
metadataobjectin body
business_email_existsboolean
Filters results to include only contacts with a work email addresses.
Useful for ensuring the returned contacts have valid business emails.
Default:
false
Example:
true
mobile_phone_enrichmentboolean
Indicates whether to enrich the contact with mobile phone numbers if available.
This is an optional enhancement to the search results.
Example:
true
mobile_phone_existsboolean
Filter results to only return contacts with mobile phone numbers.
Can only be included in the request along with mobile_phone_enrichment=true.
Example:
true
real_time_verificationboolean
Sends contacts through real-time verification. Mandatory parameter to ensure users specify what they need.
Example:
true
Response
200
400
401
403
429
Bulk Contact Enrichment Success data.
download_urlstringrequired
A URL link where you can download the results of the bulk contact enrichment
job once processing is complete. This link will become available after the job is finished.
Example:
https://api.selling.com/contacts/results/77f3a5bb-c06f-4caa-ac88-f844ab0ec173.json
expiration_datestringrequired
The Unix Timestamp representing the date and time until which the results of the bulk contact enrichment job will be accessible for download. After this time, the results will no longer be available.
Example:
2220091200
job_idstringrequired
A unique identifier for the background process handling the bulk contact enrichment request. Use this ID to track and access the results.
Example:
77f3a5bb-c06f-4caa-ac88-f844ab0ec173
Request Sample
curl -X POST "https://api.selling.com/contacts" \
-H "Authorization: Bearer your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"contacts": [
{
"first_name": "John",
"last_name": "Doe",
"company_name": "ExampleCorp",
"company_domain": "https://example.com",
"business_email": "john.doe@example.com",
"linkedin_url": "https://www.linkedin.com/in/johndoe",
"custom_fields": {
"id": "id_123",
"salesforce_key": "key_123"
}
}
],
"metadata": {
"mobile_phone_enrichment": true,
"mobile_phone_exists": true,
"business_email_exists": true,
"real_time_verification": true
}
}'Response Sample
{
"job_id": "77f3a5bb-c06f-4caa-ac88-f844ab0ec173",
"download_url": "https://api.selling.com/contacts/results/77f3a5bb-c06f-4caa-ac88-f844ab0ec173.json",
"expiration_date": 2220091200
}