> ## Documentation Index > Fetch the complete documentation index at: https://docs.clado.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get LinkedIn Profile > Retrieve LinkedIn profile data from database 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](https://docs.clado.ai/api-reference/changelog) for migration details. ## Get LinkedIn Profile ```bash theme={null} 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:** ```bash theme={null} 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](/api-reference/endpoint/scrape-linkedin-profile) endpoint * End date of "1970-01-01T00:00:00" indicates current position ## OpenAPI ````yaml GET /api/enrich/linkedin openapi: 3.1.0 info: title: Clado Search & Enrichment API description: API for searching LinkedIn profiles and enriching contact information version: 1.0.0 servers: - url: https://search.clado.ai description: Production server security: - bearerAuth: [] paths: /api/enrich/linkedin: get: tags: - Enrichment summary: Get LinkedIn Profile from Database description: >- Get profile from database. Costs 1 credit. Rate limits vary by tier: 5/min (free), 20/min (Tier 1), 100/min (Tier 2), 200/min (Tier 3). operationId: getLinkedInProfile parameters: - name: linkedin_url in: query required: true description: >- LinkedIn profile URL to retrieve from database (e.g., 'https://www.linkedin.com/in/username') schema: type: string - name: legacy in: query required: false description: >- DEPRECATED: Return results in legacy format (default: true). Will be removed November 1st, 2025 schema: type: boolean default: true responses: '200': description: Profile retrieved content: application/json: schema: $ref: '#/components/schemas/LinkedInProfileResponse' components: schemas: LinkedInProfileResponse: type: object properties: profile: type: object properties: id: type: string description: Profile ID name: type: string description: Full name headline: type: string description: Professional headline summary: type: string description: Profile summary location: type: string description: Location title: type: string description: Current title linkedin_profile_url: type: string description: LinkedIn profile URL linkedin_flagship_url: type: string description: LinkedIn flagship URL profile_picture_url: type: string description: Profile picture URL num_of_connections: type: integer description: Number of connections last_updated: type: string description: Last updated timestamp linkedin_url: type: string description: LinkedIn URL twitter_handle: type: string description: Twitter handle websites: type: array items: type: string description: Associated websites emails: type: array items: type: string description: Email addresses criteria: type: object description: Criteria object experience: type: array items: type: object properties: employee_position_id: type: integer description: Position ID employee_title: type: string description: Job title employer_name: type: string description: Company name employee_description: type: string description: Job description employer_linkedin_description: type: string description: Company description employer_linkedin_id: type: string description: Company LinkedIn ID employer_linkedin_url: type: string description: Company LinkedIn URL employer_logo_url: type: string description: Company logo URL start_date: type: string description: Start date end_date: type: string description: End date employee_location: type: string description: Work location employer_company_ids: type: array items: type: string description: Company IDs employer_company_website_domains: type: array items: type: string description: Company domains location: type: string description: Location is_current: type: boolean description: Whether this is current position education: type: array items: type: object properties: institute_name: type: string description: Institution name degree_name: type: string description: Degree name field_of_study: type: string description: Field of study institute_linkedin_id: type: string description: Institution LinkedIn ID institute_linkedin_url: type: string description: Institution LinkedIn URL institute_logo_url: type: string description: Institution logo URL start_date: type: string description: Start date end_date: type: string description: End date description: type: string description: Education description skills: type: array items: type: string description: Skills list languages: type: array items: type: string description: Languages location: type: string description: Current location certifications: type: array items: type: object description: Certifications honors: type: array items: type: object description: Honors and awards posts: type: array items: type: object properties: post_url: type: string description: Post URL title: type: string description: Post title/content action: type: string description: Action type (Liked by, Shared by) order_in_profile: type: integer description: Order in profile description: Recent posts and activity example: 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 securitySchemes: bearerAuth: type: http scheme: bearer description: API key authentication. Keys start with 'lk_'. ````