Get LinkedIn Profile

Retrieve LinkedIn profile data from database

GET /api/enrich/linkedin

Get LinkedIn Profile from Database

cURL

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

200

{
  "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

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

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

Show child attributes

experience · object[]

Show child attributes

education · object[]

Show child attributes

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

Show child attributes