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": "http://company-logo-permalinks-new.s3.us-east-1.amazonaws.com/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": "http://company-logo-permalinks-new.s3.us-east-1.amazonaws.com/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.

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

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

Notes

  • This endpoint is free - no credits are consumed
  • Rate limited to 20 requests per minute per API key
  • Provides cached profile data for faster response times
  • 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')

Response

200 - application/json

Profile retrieved

The response is of type object.