Get LinkedIn Profile from Database
curl --request GET \
--url https://search.clado.ai/api/enrich/linkedin \
--header 'Authorization: Bearer <token>'import requests
url = "https://search.clado.ai/api/enrich/linkedin"
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/linkedin', 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/linkedin",
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/linkedin"
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/linkedin")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://search.clado.ai/api/enrich/linkedin")
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{
"profile": {
"id": "647479454",
"name": "Sarah Wilson",
"headline": "Senior Data Scientist @ InnovateTech | Z-Fellow | prev. Research University PhD",
"summary": "Data science leader with expertise in machine learning and analytics.",
"location": "New York, New York, United States",
"title": "Senior Data Scientist",
"linkedin_profile_url": "https://www.linkedin.com/in/sarahwilson",
"linkedin_flagship_url": "https://www.linkedin.com/in/sarahwilson",
"profile_picture_url": "https://media.licdn.com/dms/image/v2/D4E03AQGqQzDcBXRVhw/profile-displayphoto-scale_200_200/example.jpg",
"num_of_connections": 750,
"last_updated": "",
"linkedin_url": "https://www.linkedin.com/in/sarahwilson",
"twitter_handle": "",
"websites": [],
"emails": [],
"criteria": {}
},
"experience": [
{
"employee_position_id": 1,
"employee_title": "Senior Data Scientist",
"employer_name": "InnovateTech",
"employee_description": "Leading data science initiatives and ML model development",
"employer_linkedin_description": "Technology",
"employer_linkedin_id": "12345678.0",
"employer_linkedin_url": "https://www.linkedin.com/company/innovatetech",
"employer_logo_url": "https://awss3legacy.blob.core.windows.net/company-logo-permalinks-new/images/example.jpg",
"start_date": "2021-01",
"end_date": "",
"employee_location": "New York, NY",
"employer_company_ids": [],
"employer_company_website_domains": [],
"location": "New York, NY",
"is_current": true
}
],
"education": [
{
"institute_name": "Research University",
"degree_name": "PhD",
"field_of_study": "Statistics",
"institute_linkedin_id": "",
"institute_linkedin_url": "https://www.linkedin.com/school/research-university",
"institute_logo_url": "https://awss3legacy.blob.core.windows.net/company-logo-permalinks-new/images/example.jpg",
"start_date": "2015-09",
"end_date": "2019-12",
"description": null
}
],
"skills": [
"Data Science",
"Machine Learning",
"Python",
"R",
"Statistics",
"AI Ethics"
],
"languages": [],
"location": "New York, New York, United States",
"certifications": [],
"honors": [],
"posts": [
{
"post_url": "https://www.linkedin.com/posts/sarahwilson_data-science-ethics-activity-7343065850410582018-bDZE",
"title": "Excited to share insights on responsible AI deployment and ethical considerations in machine learning systems...",
"action": "Shared by",
"order_in_profile": 1
}
]
}Enrichment API
Get LinkedIn Profile
Retrieve LinkedIn profile data from database
GET
/
api
/
enrich
/
linkedin
Get LinkedIn Profile from Database
curl --request GET \
--url https://search.clado.ai/api/enrich/linkedin \
--header 'Authorization: Bearer <token>'import requests
url = "https://search.clado.ai/api/enrich/linkedin"
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/linkedin', 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/linkedin",
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/linkedin"
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/linkedin")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://search.clado.ai/api/enrich/linkedin")
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{
"profile": {
"id": "647479454",
"name": "Sarah Wilson",
"headline": "Senior Data Scientist @ InnovateTech | Z-Fellow | prev. Research University PhD",
"summary": "Data science leader with expertise in machine learning and analytics.",
"location": "New York, New York, United States",
"title": "Senior Data Scientist",
"linkedin_profile_url": "https://www.linkedin.com/in/sarahwilson",
"linkedin_flagship_url": "https://www.linkedin.com/in/sarahwilson",
"profile_picture_url": "https://media.licdn.com/dms/image/v2/D4E03AQGqQzDcBXRVhw/profile-displayphoto-scale_200_200/example.jpg",
"num_of_connections": 750,
"last_updated": "",
"linkedin_url": "https://www.linkedin.com/in/sarahwilson",
"twitter_handle": "",
"websites": [],
"emails": [],
"criteria": {}
},
"experience": [
{
"employee_position_id": 1,
"employee_title": "Senior Data Scientist",
"employer_name": "InnovateTech",
"employee_description": "Leading data science initiatives and ML model development",
"employer_linkedin_description": "Technology",
"employer_linkedin_id": "12345678.0",
"employer_linkedin_url": "https://www.linkedin.com/company/innovatetech",
"employer_logo_url": "https://awss3legacy.blob.core.windows.net/company-logo-permalinks-new/images/example.jpg",
"start_date": "2021-01",
"end_date": "",
"employee_location": "New York, NY",
"employer_company_ids": [],
"employer_company_website_domains": [],
"location": "New York, NY",
"is_current": true
}
],
"education": [
{
"institute_name": "Research University",
"degree_name": "PhD",
"field_of_study": "Statistics",
"institute_linkedin_id": "",
"institute_linkedin_url": "https://www.linkedin.com/school/research-university",
"institute_logo_url": "https://awss3legacy.blob.core.windows.net/company-logo-permalinks-new/images/example.jpg",
"start_date": "2015-09",
"end_date": "2019-12",
"description": null
}
],
"skills": [
"Data Science",
"Machine Learning",
"Python",
"R",
"Statistics",
"AI Ethics"
],
"languages": [],
"location": "New York, New York, United States",
"certifications": [],
"honors": [],
"posts": [
{
"post_url": "https://www.linkedin.com/posts/sarahwilson_data-science-ethics-activity-7343065850410582018-bDZE",
"title": "Excited to share insights on responsible AI deployment and ethical considerations in machine learning systems...",
"action": "Shared by",
"order_in_profile": 1
}
]
}Retrieve LinkedIn profile data from our database. This endpoint provides fast access to previously scraped profile information.
🚨 DEPRECATION NOTICE: The legacy response format will be deprecated on November 1st, 2025. Thelegacyparameter currently defaults totruebut will be removed. Please migrate to the modern format by settinglegacy=false. See https://docs.clado.ai/api-reference/changelog for migration details.
Get LinkedIn Profile
curl -X GET "https://search.clado.ai/api/enrich/linkedin?linkedin_url=https://www.linkedin.com/in/alexjohnson" \
-H "Authorization: Bearer YOUR_API_KEY"
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| linkedin_url | string | Yes | LinkedIn profile URL to retrieve |
| legacy | boolean | No | DEPRECATED: Return results in legacy format (default: true). Will be removed November 1st, 2025 |
Examples
Get Profile from Database:curl -X GET "https://search.clado.ai/api/enrich/linkedin?linkedin_url=https://www.linkedin.com/in/alexjohnson" \
-H "Authorization: Bearer YOUR_API_KEY"
Error Responses
| Status Code | Description |
|---|---|
| 400 | Bad Request - Missing or invalid LinkedIn URL |
| 401 | Unauthorized - API key missing or invalid |
| 404 | Not Found - Profile not in database |
| 500 | Internal Server Error - Database error |
Rate Limits
Rate limits vary by subscription tier:- Free Tier: 5 requests per minute
- Tier 1: 20 requests per minute
- Tier 2: 100 requests per minute
- Tier 3: 200 requests per minute
Notes
- This endpoint costs 1 credit
- Data may be older than real-time scraping
- If profile not found, consider using the Scrape LinkedIn Profile endpoint
- End date of “1970-01-01T00:00:00” indicates current position
Authorizations
API key authentication. Keys start with 'lk_'.
Query Parameters
LinkedIn profile URL to retrieve from database (e.g., 'https://www.linkedin.com/in/username')
DEPRECATED: Return results in legacy format (default: true). Will be removed November 1st, 2025
Response
200 - application/json
Profile retrieved
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Skills list
Languages
Current location
Certifications
Honors and awards
Recent posts and activity
Show child attributes
Show child attributes