Skip to main content
GET
/
api
/
enrich
/
linkedin
Get LinkedIn Profile from Database
curl --request GET \
  --url https://search.clado.ai/api/enrich/linkedin \
  --header 'Authorization: Bearer <token>'
{
  "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. The legacy parameter currently defaults to true but will be removed. Please migrate to the modern format by setting legacy=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

ParameterTypeRequiredDescription
linkedin_urlstringYesLinkedIn profile URL to retrieve
legacybooleanNoDEPRECATED: 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 CodeDescription
400Bad Request - Missing or invalid LinkedIn URL
401Unauthorized - API key missing or invalid
404Not Found - Profile not in database
500Internal 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

Authorization
string
header
required

API key authentication. Keys start with 'lk_'.

Query Parameters

linkedin_url
string
required

LinkedIn profile URL to retrieve from database (e.g., 'https://www.linkedin.com/in/username')

legacy
boolean
default:true

DEPRECATED: Return results in legacy format (default: true). Will be removed November 1st, 2025

Response

200 - application/json

Profile retrieved

profile
object
experience
object[]
education
object[]
skills
string[]

Skills list

languages
string[]

Languages

location
string

Current location

certifications
object[]

Certifications

honors
object[]

Honors and awards

posts
object[]

Recent posts and activity