Enrichment API
Single Contact Enrichment
Search for a contact using criteria such as first name,
last name, company name, and more. 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 in the request.
Request
POST
/contact
business_emailstringin body
The work email address of the person.
Max Length:
255
Example:
john.doe@example.com
company_domainstringin body
The domain of the company associated with the person.
Max Length:
255
Example:
https://example.com
company_namestringin body
The name of the company where the person works.
Max Length:
255
Min Length: 1
Example:
ExampleCorp
first_namestringin body
The first name of the person you are searching for.
Max Length:
255
Min Length: 1
Example:
John
last_namestringin body
The last name of the person you are searching for.
Max Length:
255
Min Length: 1
Example:
Doe
linkedin_urlstringin body
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
Response
200
400
401
403
429
Single Contact Enrichment Success data.
contactobjectrequired
companyobjectrequired
Detailed information about the company where the contact is employed.
Includes the company’s name, description, website, location, and other key attributes.
credit_chargedbooleanrequired
Credit charged for email OR contact phone OR Mobile phone.
Example:
true
departmentstringrequired
The department where the contact works. Provides insight into the specific division or function of the individual’s role.
Example:
General Management
emailstringrequired
The contact's professional email address. Essential for direct communication and correspondence with the individual.
Example:
john.doe@example.com
errorstringrequired
Reason of error if contact is not enriched.
Example:
You have run out of API credits. Some of the submitted records were not enriched. Please contact support to purchase more credits.
first_namestringrequired
The first name of the contact. This identifies the individual's personal name for more specific searches and personalization.
Example:
John
job_levelstringrequired
The hierarchical level of the contact’s position. Shows the seniority and rank of the individual within the organization.
Example:
Executive
last_namestringrequired
The last name of the contact. Provides the surname for precise identification and to complement the first name.
Example:
Doe
linkedinstringrequired
The URL to the contact’s LinkedIn profile. Offers a link to their professional networking page for more details and connections.
Example:
https://www.linkedin.com/in/johndoe
locationobjectrequired
The contact’s physical address details including country, state, and zip code. Provides geographic context about the individual’s location.
mobile_phonestringrequired
The contact's mobile phone number. Allows for personal communication with the individual on their mobile device.
Example:
+18005555678
office_phonestringrequired
The contact's office telephone number. Used for reaching the individual at their business location.
Example:
+18005551234
titlestringrequired
The contact’s job title. Indicates the individual’s position or role within their organization.
Example:
Chief Executive Officer
remaining_creditsnumberrequired
Remaining contact credits after contact enrichment.
Example:
10
Request Sample
curl -X POST "https://api.selling.com/contact" \
-H "Authorization: Bearer your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"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",
"metadata": {
"mobile_phone_enrichment": true,
"mobile_phone_exists": true,
"business_email_exists": true
}
}'Response Sample
{
"contact": {
"error": "You have run out of API credits. Some of the submitted records were not enriched. Please contact support to purchase more credits.",
"credit_charged": true,
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@example.com",
"office_phone": "+18005551234",
"mobile_phone": "+18005555678",
"location": {
"country": "United States",
"state": "California",
"zip_code": "90001"
},
"title": "Chief Executive Officer",
"job_level": "Executive",
"department": "General Management",
"linkedin": "https://www.linkedin.com/in/johndoe",
"company": {
"name": "ExampleCorp",
"description": "ExampleCorp is a leading provider of business solutions...",
"website": "https://example.com",
"employees_category": "500-1,000",
"revenue_category": "$10 – 49 M",
"location": {
"country": "United States",
"state": "California",
"zip_code": "90001"
}
}
},
"remaining_credits": 10
}