Skip to main content
People search, enrichment, and outreach. Get started with the clodo API
Clododocs
SupportDashboard
DocumentationAPI ReferenceGuides
Enrichment API

Email Enrichment

Find a professional email address from a profile URL or a name and company domain.

#Use case

Find a professional email address from a profile URL or a name and company domain.

#Endpoint

POST https://api-public.clodo.ai/api/public/v1/enrich/email/

Send your API key in the x-api-key header. See Authentication.

#Pricing

See Credits & Pricing for credit costs and charging behavior.

#Errors

For error responses and retry guidance, see Handling Errors.

POST /api/public/v1/enrich/email/ — sync. 5 credits per call.

#Request

Provide at least one of:

  • professional_url
  • first_name + last_name + company_name
  • first_name + last_name + domain

Use professional_url, or first_name + last_name + domain, to resolve an email. The name + company_name shape is accepted for compatibility, but without a profile URL or domain it returns 404 not_found. Completed lookups that find no match still cost 5 credits.

Field Type Notes
professional_url string LinkedIn URL.
first_name string Required when not using professional_url.
last_name string Required when not using professional_url.
company_name string Accepted with first_name + last_name, but cannot resolve an email without professional_url. Mutually exclusive with domain.
domain string e.g. acme.com. Pair with first_name + last_name. Must contain a dot.

#Response

{
  "email": "patrick@stripe.com"
}

A miss returns 404 not_found (see Status mapping below).

#Status mapping

Outcome HTTP Charged
Email found 200 OK 5 credits
No match found 404 not_found 5 credits
Invalid input 400 invalid_request 0
Upstream failure 502 upstream_error 0

#Examples

By LinkedIn URL:

curl -X POST https://api-public.clodo.ai/api/public/v1/enrich/email/ \
  -H "x-api-key: ck_live_..." \
  -H "Content-Type: application/json" \
  -d '{"professional_url": "https://www.linkedin.com/in/patrickcollison/"}'

By profile URL with name + company context:

curl -X POST https://api-public.clodo.ai/api/public/v1/enrich/email/ \
  -H "x-api-key: ck_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "professional_url": "https://www.linkedin.com/in/patrickcollison/",
    "first_name": "Patrick",
    "last_name": "Collison",
    "company_name": "Stripe"
  }'

By name + domain:

curl -X POST https://api-public.clodo.ai/api/public/v1/enrich/email/ \
  -H "x-api-key: ck_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Patrick",
    "last_name": "Collison",
    "domain": "stripe.com"
  }'

#Rate limit

Limit Value
Sustained rate 30 requests / minute
Burst 5 requests

Exceeding any returns 429.

clodo Docs