GET
/
api
/
enrich
/
contacts
Get Contact Information
curl --request GET \
  --url https://search.clado.ai/api/enrich/contacts \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "error": false,
      "contacts": [
        {
          "type": "email",
          "value": "[email protected]",
          "rating": 100,
          "subType": "work"
        },
        {
          "type": "phone",
          "value": "+1-555-123-4567",
          "rating": 90,
          "subType": "mobile"
        }
      ],
      "social": [
        {
          "link": "https://www.linkedin.com/in/alexjohnson",
          "type": "li",
          "rating": 100
        }
      ]
    }
  ]
}
Retrieve contact information (emails and phone numbers) for a LinkedIn profile. You can optionally specify whether to get emails, phone numbers, or both using the enrichment parameters. When both are requested, the system uses a waterfall approach through multiple data sources to maximize the likelihood of finding both types of contact information.

Get Contact Information

# By LinkedIn URL
curl -X GET "https://search.clado.ai/api/enrich/contacts?linkedin_url=https://www.linkedin.com/in/alexjohnson" \
  -H "Authorization: Bearer YOUR_API_KEY"

# By Email
curl -X GET "https://search.clado.ai/api/enrich/[email protected]" \
  -H "Authorization: Bearer YOUR_API_KEY"

# By Phone
curl -X GET "https://search.clado.ai/api/enrich/contacts?phone=+1234567890" \
  -H "Authorization: Bearer YOUR_API_KEY"

Query Parameters

ParameterTypeRequiredDescription
linkedin_urlstringOne of theseLinkedIn profile URL to enrich
emailstringOne of theseEmail address to find profile
phonestringOne of thesePhone number to find profile
email_enrichmentbooleanOptionalIf true, returns emails (costs 4 credits if email found)
phone_enrichmentbooleanOptionalIf true, returns phone numbers (costs 10 credits if phone found)
Note:
  • Exactly one of linkedin_url, email, or phone must be provided.
  • Both email_enrichment and phone_enrichment can be true at the same time to request both types of contact info.
  • If both are false (default), returns all available contact info.
  • When both enrichments are requested, the system attempts to find both but only charges for what’s actually found.

Examples

Get Contact Info by LinkedIn URL (all contact info):
curl -X GET "https://search.clado.ai/api/enrich/contacts?linkedin_url=https://www.linkedin.com/in/alexjohnson" \
  -H "Authorization: Bearer YOUR_API_KEY"
Get Only Emails:
curl -X GET "https://search.clado.ai/api/enrich/contacts?linkedin_url=https://www.linkedin.com/in/alexjohnson&email_enrichment=true" \
  -H "Authorization: Bearer YOUR_API_KEY"
Get Only Phone Numbers:
curl -X GET "https://search.clado.ai/api/enrich/contacts?linkedin_url=https://www.linkedin.com/in/alexjohnson&phone_enrichment=true" \
  -H "Authorization: Bearer YOUR_API_KEY"
Get Both Email and Phone Numbers:
curl -X GET "https://search.clado.ai/api/enrich/contacts?linkedin_url=https://www.linkedin.com/in/alexjohnson&email_enrichment=true&phone_enrichment=true" \
  -H "Authorization: Bearer YOUR_API_KEY"
Get Contact Info by Email:
curl -X GET "https://search.clado.ai/api/enrich/[email protected]" \
  -H "Authorization: Bearer YOUR_API_KEY"
Get Contact Info by Phone:
curl -X GET "https://search.clado.ai/api/enrich/contacts?phone=+14155552671" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Format

Success Response

{
  "data": [
    {
      "error": false,
      "contacts": [
        {
          "type": "email",
          "value": "[email protected]",
          "rating": 100,
          "subType": "work"
        },
        {
          "type": "phone",
          "value": "+1-555-123-4567",
          "rating": 90,
          "subType": "mobile"
        }
      ],
      "social": [
        {
          "link": "https://www.linkedin.com/in/alexjohnson",
          "type": "li",
          "rating": 100
        }
      ],
      "provider": "database_verified"
    }
  ]
}

Response Fields

FieldTypeDescription
dataarrayArray containing contact information (always has one item)
data.errorbooleanWhether an error occurred during lookup
data.contactsarrayArray of contact information (emails/phones)
data.contacts.typestringContact type: "email" or "phone"
data.contacts.valuestringThe actual email address or phone number
data.contacts.ratingintegerConfidence score from 0-100 (higher is better)
data.contacts.subTypestringContact classification: "personal", "work", "verified", "mobile", "work_phone"
data.socialarrayArray of social media profiles found
data.social.linkstringURL of the social media profile
data.social.typestringPlatform type (e.g., "li" for LinkedIn)
data.social.ratingintegerConfidence score from 0-100
data.providerstringData source (optional): "database_verified", "database_bouncer_verified", etc.

Error Responses

Status CodeDescription
400Bad Request - Must provide exactly one of: LinkedIn URL, email, or phone
401Unauthorized - API key missing or invalid
402Payment Required - Insufficient credits or requires paid plan
500Internal Server Error - Enrichment service error

Rate Limits

Rate limits vary by subscription tier:
  • Free Tier: 0 requests per minute (not available)
  • Tier 1: 5 requests per minute
  • Tier 2: 60 requests per minute
  • Tier 3: 120 requests per minute

Notes

Pricing

  • Default (all contact info): 4 credits per request
  • Email enrichment only: 4 credits if email is found, 0 credits if not found
  • Phone enrichment only: 10 credits if phone is found, 0 credits if not found
  • Both email and phone enrichment: Only charged for what’s found
    • Both found: 14 credits (4 for email + 10 for phone)
    • Only email found: 4 credits
    • Only phone found: 10 credits
    • Neither found: 0 credits

Other Information

  • Requires purchased credits (not available on free trial)
  • Rating scores range from 0 to 100 (higher is better)
  • Multiple email addresses and phone numbers may be returned with different ratings
  • Social media profiles may also be included in the response
  • Both email and phone enrichment can be requested simultaneously
  • When both are requested, the system uses a waterfall approach to maximize success rate

Authorizations

Authorization
string
header
required

API key authentication. Keys start with 'lk_'.

Query Parameters

linkedin_url
string

LinkedIn profile URL to get contact information for (e.g., 'https://www.linkedin.com/in/username')

email
string

Email address to find profile and get contact information (e.g., '[email protected]')

phone
string

Phone number to find profile and get contact information (e.g., '+1234567890')

email_enrichment
boolean
default:false

If true, returns emails (costs 4 credits if email found). Can be combined with phone_enrichment to request both

phone_enrichment
boolean
default:false

If true, returns phone numbers (costs 10 credits if phone found). Can be combined with email_enrichment to request both

Response

Contact info retrieved

The response is of type object.