curl --request POST \
--url https://api.audiencelab.io/enrich \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"request_id": "req_123456",
"filter": {
"company_name": "Nike"
},
"is_or_match": false
}
'{
"request_id": "req_123456",
"timestamp": 1704067200000,
"found": 2,
"result": [
{
"email": "john.doe@example.com",
"first_name": "John",
"last_name": "Doe",
"business_email": "jdoe@acmecorp.com",
"sha256_email": "a665a45920422f9d417e4867efdc4fb8a04a1f3fff1fa07e998e86f7f7a27ae3",
"company_name": "Acme Corp",
"company_domain": "acmecorp.com",
"job_title": "Senior Software Engineer",
"industry": "Technology",
"city": "San Francisco",
"state": "CA",
"zip": "94105",
"address": "123 Market St",
"linkedin_url": "https://linkedin.com/in/johndoe"
},
{
"email": "jane.smith@example.com",
"first_name": "Jane",
"last_name": "Smith",
"business_email": "jsmith@acmecorp.com",
"sha256_email": "b665a45920422f9d417e4867efdc4fb8a04a1f3fff1fa07e998e86f7f7a27ae4",
"company_name": "Acme Corp",
"company_domain": "acmecorp.com",
"job_title": "Product Manager",
"industry": "Technology",
"city": "New York",
"state": "NY",
"zip": "10001",
"address": "456 Broadway",
"linkedin_url": "https://linkedin.com/in/janesmith"
}
]
}{
"message": "error message"
}{
"message": "error message"
}{
"message": "error message"
}Enrichment
Enrich contact
POST
/
enrich
curl --request POST \
--url https://api.audiencelab.io/enrich \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"request_id": "req_123456",
"filter": {
"company_name": "Nike"
},
"is_or_match": false
}
'{
"request_id": "req_123456",
"timestamp": 1704067200000,
"found": 2,
"result": [
{
"email": "john.doe@example.com",
"first_name": "John",
"last_name": "Doe",
"business_email": "jdoe@acmecorp.com",
"sha256_email": "a665a45920422f9d417e4867efdc4fb8a04a1f3fff1fa07e998e86f7f7a27ae3",
"company_name": "Acme Corp",
"company_domain": "acmecorp.com",
"job_title": "Senior Software Engineer",
"industry": "Technology",
"city": "San Francisco",
"state": "CA",
"zip": "94105",
"address": "123 Market St",
"linkedin_url": "https://linkedin.com/in/johndoe"
},
{
"email": "jane.smith@example.com",
"first_name": "Jane",
"last_name": "Smith",
"business_email": "jsmith@acmecorp.com",
"sha256_email": "b665a45920422f9d417e4867efdc4fb8a04a1f3fff1fa07e998e86f7f7a27ae4",
"company_name": "Acme Corp",
"company_domain": "acmecorp.com",
"job_title": "Product Manager",
"industry": "Technology",
"city": "New York",
"state": "NY",
"zip": "10001",
"address": "456 Broadway",
"linkedin_url": "https://linkedin.com/in/janesmith"
}
]
}{
"message": "error message"
}{
"message": "error message"
}{
"message": "error message"
}Authorizations
Body
application/json
Search filter parameters with field names as keys and single string values.
Available fields:
Personal Information:
uuid- Unique identifierfirst_name- First namelast_name- Last nameemail- Email addressemail_domain- Email domainsha256_email- SHA256 hash of emailphone- Phone number
Location Information:
personal_zip- Personal ZIP/postal codepersonal_address- Personal street addresspersonal_state- Personal state/provincepersonal_city- Personal city
Company Information:
company_name- Company namecompany_domain- Company domain name
Social/Professional:
linkedin_url- LinkedIn profile URL
Show child attributes
Show child attributes
Example:
{
"first_name": "John",
"last_name": "Doe",
"email": "user@example.com",
"phone": "555-123-4567",
"company_name": "Nike",
"personal_city": "San Francisco",
"company_domain": "nike.com"
}
Determines how multiple criteria are combined:
true: OR logic - returns contacts matching ANY of the criteriafalse: AND logic - returns contacts matching ALL of the criteria
Example:
false
Optional request ID for tracking
Example:
"req_123456"
Optional array of field names to include in the response. If not specified, all available fields are returned.
Available output fields:
company- Company namejob_title- Job title/positionfirst_name- First namelast_name- Last nameb2b_email- Business email addresspersonal_email- Personal email addressb2b_phone- Business phone numberpersonal_phone- Personal phone numbersha256- SHA256 hash identifierlinkedin_url- LinkedIn profile URLaddress- Street addresscity- Citystate- State/provincezip- ZIP/postal codeindustry- Industry classificationcompany_domain- Company domain
Available options:
company, job_title, first_name, last_name, b2b_email, personal_email, b2b_phone, personal_phone, sha256, linkedin_url, address, city, state, zip, industry, company_domain Example:
[
"first_name",
"last_name",
"b2b_email",
"company",
"job_title"
]
Response
Successfully retrieved enriched contact data
Request ID if provided in the request
Example:
"req_123456"
Unix timestamp in milliseconds
Example:
1704067200000
Number of matching records found
Example:
2
Array of enriched contact records with complete profile information
Example:
[
{
"email": "john.doe@example.com",
"first_name": "John",
"last_name": "Doe",
"business_email": "jdoe@acmecorp.com",
"sha256_email": "a665a45920422f9d417e4867efdc4fb8a04a1f3fff1fa07e998e86f7f7a27ae3",
"company_name": "Acme Corp",
"company_domain": "acmecorp.com",
"job_title": "Senior Software Engineer",
"industry": "Technology",
"city": "San Francisco",
"state": "CA",
"zip": "94105",
"address": "123 Market St",
"linkedin_url": "https://linkedin.com/in/johndoe"
},
{
"email": "jane.smith@example.com",
"first_name": "Jane",
"last_name": "Smith",
"business_email": "jsmith@acmecorp.com",
"sha256_email": "b665a45920422f9d417e4867efdc4fb8a04a1f3fff1fa07e998e86f7f7a27ae4",
"company_name": "Acme Corp",
"company_domain": "acmecorp.com",
"job_title": "Product Manager",
"industry": "Technology",
"city": "New York",
"state": "NY",
"zip": "10001",
"address": "456 Broadway",
"linkedin_url": "https://linkedin.com/in/janesmith"
}
]

