> ## 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. # Scrape LinkedIn Profile > Extract detailed profile data from LinkedIn URLs Scrape comprehensive profile data directly from LinkedIn. This endpoint provides the most up-to-date profile information including recent posts and activity. ## Scrape LinkedIn Profile ```bash theme={null} curl -X GET "https://search.clado.ai/api/enrich/scrape?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 scrape | ### Examples **Scrape Profile Data:** ```bash theme={null} curl -X GET "https://search.clado.ai/api/enrich/scrape?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 | | 402 | Payment Required - Insufficient credits | | 429 | Too Many Requests - Rate limit exceeded | | 500 | Internal Server Error - Scraping service error | ## Rate Limits Rate limits vary by subscription tier: * **Free Tier**: 5 requests per minute * **Tier 1**: 15 requests per minute * **Tier 2**: 150 requests per minute * **Tier 3**: 300 requests per minute ## Notes * Costs **2 credits** per request * Provides the most current profile data available * Includes recent posts and activity when available * May take longer than database lookups due to real-time scraping * Some profiles may be private or have restricted access ## OpenAPI ````yaml GET /api/enrich/scrape 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/scrape: get: tags: - Enrichment summary: Scrape LinkedIn Profile description: >- Scrape profile data. Costs 2 credits. Rate limits vary by tier: 5/min (free), 15/min (Tier 1), 150/min (Tier 2), 300/min (Tier 3). operationId: scrapeLinkedInProfile parameters: - name: linkedin_url in: query required: true description: >- LinkedIn profile URL to scrape for detailed information (e.g., 'https://www.linkedin.com/in/username') schema: type: string responses: '200': description: Profile scraped content: application/json: schema: $ref: '#/components/schemas/ScrapeResponse' components: schemas: ScrapeResponse: 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: Alex Johnson headline: >- Co-Founder @ TechCorp Inc (YC X25) | Z-Fellow | prev. State University M&T summary: Working with great people is one of the best parts of life. location: San Francisco, California, United States title: Co-founder linkedin_profile_url: https://www.linkedin.com/in/alexjohnson linkedin_flagship_url: https://www.linkedin.com/in/alexjohnson profile_picture_url: >- https://media.licdn.com/dms/image/v2/D4E03AQGqQzDcBXRVhw/profile-displayphoto-scale_200_200/example.jpg num_of_connections: 500 last_updated: '' linkedin_url: https://www.linkedin.com/in/alexjohnson twitter_handle: '' websites: [] emails: [] criteria: {} experience: - employee_position_id: 1 employee_title: Co-founder employer_name: TechCorp Inc (YC X25) employee_description: Building people search, used to be called StartupCo techcorp.ai employer_linkedin_description: Software Development employer_linkedin_id: '97975821.0' employer_linkedin_url: https://www.linkedin.com/company/techcorp-inc employer_logo_url: >- https://awss3legacy.blob.core.windows.net/company-logo-permalinks-new/images/example.jpg start_date: 2025-02 end_date: '' employee_location: San Francisco Bay Area employer_company_ids: [] employer_company_website_domains: [] location: San Francisco Bay Area is_current: true education: - institute_name: State University degree_name: Bachelor of Science - BS, Computer Science field_of_study: '' institute_linkedin_id: '' institute_linkedin_url: https://www.linkedin.com/school/state-university institute_logo_url: >- https://awss3legacy.blob.core.windows.net/company-logo-permalinks-new/images/example.jpg start_date: '' end_date: '' description: null skills: - management - technology - science - program management - computer science languages: [] location: San Francisco, California, United States certifications: [] honors: [] posts: - post_url: >- https://www.linkedin.com/posts/alexjohnson_we-did-it-last-week-i-graduated-with-activity-7343065850410582018-bDZE title: >- We did it 🎓 Last week I graduated with honors from the State University Computer Science department. I'm incredibly grateful for these past two years. Along the way… action: Liked by order_in_profile: 1 securitySchemes: bearerAuth: type: http scheme: bearer description: API key authentication. Keys start with 'lk_'. ````