Get Contact Information

curl --request GET \
  --url https://search.clado.ai/api/enrich/contacts \
  --header 'Authorization: Bearer <token>'

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))

}

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
        }
      ]
    }
  ]
}

GET

api

enrich

contacts

Get Contact Information

curl --request GET \
  --url https://search.clado.ai/api/enrich/contacts \
  --header 'Authorization: Bearer <token>'

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))

}

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.

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
email	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)

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

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

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')

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

data

object[]

Array of contact information found

Show child attributes

⌘I

Getting Started

Search API

Deep Research

Enrichment API

Platform API

Get Contact Information

Get Contact Information

Query Parameters

Examples

Response Format

Success Response

Response Fields

Error Responses

Rate Limits

Notes

Pricing

Other Information

Authorizations

Query Parameters

Response

​Get Contact Information

​Query Parameters

​Examples

​Response Format

​Success Response

​Response Fields

​Error Responses

​Rate Limits

​Notes

​Pricing

​Other Information

Authorizations

Query Parameters

Response

Get Contact Information

Query Parameters

Examples

Response Format

Success Response

Response Fields

Error Responses

Rate Limits

Notes

Pricing

Other Information