Get Contact Information
curl --request GET \
--url https://search.clado.ai/api/enrich/contacts \
--header 'Authorization: Bearer <token>'import requests
url = "https://search.clado.ai/api/enrich/contacts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://search.clado.ai/api/enrich/contacts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://search.clado.ai/api/enrich/contacts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://search.clado.ai/api/enrich/contacts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://search.clado.ai/api/enrich/contacts")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://search.clado.ai/api/enrich/contacts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"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
}
]
}
]
}Enrichment API
Get Contact Information
Find email addresses and phone numbers for LinkedIn profiles
GET
/
api
/
enrich
/
contacts
Get Contact Information
curl --request GET \
--url https://search.clado.ai/api/enrich/contacts \
--header 'Authorization: Bearer <token>'import requests
url = "https://search.clado.ai/api/enrich/contacts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://search.clado.ai/api/enrich/contacts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://search.clado.ai/api/enrich/contacts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://search.clado.ai/api/enrich/contacts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://search.clado.ai/api/enrich/contacts")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://search.clado.ai/api/enrich/contacts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"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.
Note:
Get Only Emails:
Get Only Phone Numbers:
Get Both Email and Phone Numbers:
Get Contact Info by Email:
Get Contact Info by Phone:
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
| Parameter | Type | Required | Description |
|---|---|---|---|
| linkedin_url | string | One of these | LinkedIn profile URL to enrich |
| string | One of these | Email address to find profile | |
| phone | string | One of these | Phone number to find profile |
| email_enrichment | boolean | Optional | If true, returns emails (costs 4 credits if email found) |
| phone_enrichment | boolean | Optional | If true, returns phone numbers (costs 10 credits if phone found) |
- Exactly one of
linkedin_url,email, orphonemust be provided. - Both
email_enrichmentandphone_enrichmentcan 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"
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"
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"
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"
curl -X GET "https://search.clado.ai/api/enrich/[email protected]" \
-H "Authorization: Bearer YOUR_API_KEY"
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
| Field | Type | Description |
|---|---|---|
data | array | Array containing contact information (always has one item) |
data.error | boolean | Whether an error occurred during lookup |
data.contacts | array | Array of contact information (emails/phones) |
data.contacts.type | string | Contact type: "email" or "phone" |
data.contacts.value | string | The actual email address or phone number |
data.contacts.rating | integer | Confidence score from 0-100 (higher is better) |
data.contacts.subType | string | Contact classification: "personal", "work", "verified", "mobile", "work_phone" |
data.social | array | Array of social media profiles found |
data.social.link | string | URL of the social media profile |
data.social.type | string | Platform type (e.g., "li" for LinkedIn) |
data.social.rating | integer | Confidence score from 0-100 |
data.provider | string | Data source (optional): "database_verified", "database_bouncer_verified", etc. |
Error Responses
| Status Code | Description |
|---|---|
| 400 | Bad Request - Must provide exactly one of: LinkedIn URL, email, or phone |
| 401 | Unauthorized - API key missing or invalid |
| 402 | Payment Required - Insufficient credits or requires paid plan |
| 500 | Internal 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
API key authentication. Keys start with 'lk_'.
Query Parameters
LinkedIn profile URL to get contact information for (e.g., 'https://www.linkedin.com/in/username')
Email address to find profile and get contact information (e.g., '[email protected]')
Phone number to find profile and get contact information (e.g., '+1234567890')
If true, returns emails (costs 4 credits if email found). Can be combined with phone_enrichment to request both
If true, returns phone numbers (costs 10 credits if phone found). Can be combined with email_enrichment to request both
Response
Contact info retrieved
Array of contact information found
Show child attributes
Show child attributes