> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dumplingai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get LinkedIn Profile

> Retrieve LinkedIn profile metadata, experience, and statistics for a public profile URL.

## Description

This endpoint retrieves comprehensive public profile information from LinkedIn including recent posts, experience, education, and activity. Perfect for lead research, content analysis, and professional networking insights.

## Endpoint

```
POST https://app.dumplingai.com/api/v1/linkedin/profile
```

## Headers

* **Content-Type:** `application/json`
* **Authorization:** Bearer `<API_KEY>` (required)

## Request Body

```json theme={null}
{
  "url": "string" // Required. LinkedIn profile URL
}
```

## Responses

### Success (200)

Returns comprehensive profile information including posts, experience, and education.

```json theme={null}
{
  "success": true,
  "name": "Sarah Chen",
  "image": "https://media.licdn.com/dms/image/v2/C4E03AQH3Vz1qV_rNVQ/profile-displayphoto-shrink_200_200/profile-displayphoto-shrink_200_200/0/1633389534107?e=2147483647&v=beta&t=8x4PIfTIYFOvpI1QRCDyAhNprZv0NY9kAp4EOdvUxLQ",
  "location": "San Francisco, California, United States",
  "followers": 12847,
  "connections": "500+",
  "about": "Full-stack developer passionate about creating accessible web experiences. Currently building developer tools at a fast-growing startup. Love mentoring new developers and contributing to open source projects.",
  "recentPosts": [
    {
      "title": "Just shipped a new feature that reduces our app's bundle size by 40%! Key takeaways: 1) Tree shaking works wonders 2) Dynamic imports for route splitting 3) Analyzing bundle with webpack-bundle-analyzer changed everything",
      "activityType": "Posted by Sarah Chen",
      "link": "https://www.linkedin.com/posts/sarahchen-dev_webdev-performance-javascript-activity-7333305862695919617-zTPI",
      "image": "https://static.licdn.com/aero-v1/sc/h/53n89ecoxpr1qrki1do3alazb"
    },
    {
      "title": "Mentored 3 amazing junior developers this month through our company's mentorship program. Watching them grow from struggling with async/await to confidently building full features is incredibly rewarding 🚀",
      "activityType": "Posted by Sarah Chen",
      "link": "https://www.linkedin.com/posts/sarahchen-dev_mentorship-webdevelopment-career-activity-7325898973485879296-jTB4",
      "image": "https://static.licdn.com/aero-v1/sc/h/53n89ecoxpr1qrki1do3alazb"
    }
  ],
  "experience": [
    {
      "@type": "Organization",
      "name": "TechFlow",
      "url": "https://www.linkedin.com/company/techflow-inc",
      "location": "San Francisco, California",
      "member": {
        "@type": "OrganizationRole",
        "description": "Senior Full Stack Developer leading frontend architecture for a developer productivity platform. Built React components used by 50K+ developers daily. Reduced page load times by 60% through performance optimizations."
      }
    },
    {
      "@type": "Organization", 
      "name": "StartupCo",
      "member": {
        "@type": "OrganizationRole",
        "description": "Full Stack Developer building customer-facing features with React, Node.js, and PostgreSQL. Shipped 15+ features from concept to production. Collaborated with designers to implement pixel-perfect UIs."
      }
    }
  ],
  "education": [
    {
      "@type": "EducationalOrganization",
      "name": "University of California, Berkeley",
      "url": "https://www.linkedin.com/school/uc-berkeley/",
      "member": {
        "@type": "OrganizationRole",
        "startDate": 2016,
        "endDate": 2020
      }
    }
  ],
  "activity": [
    {
      "title": "Great thread on React Server Components by @dan_abramov. The mental model shift from 'components run on client' to 'some components run on server' is huge...",
      "activityType": "Shared by Sarah Chen",
      "link": "https://www.linkedin.com/posts/sarahchen-dev_react-servercomponents-webdev-activity-7328134812047704064-4NUL",
      "image": "https://media.licdn.com/dms/image/sync/v2/D4D27AQGJaeiyu-gbrA/articleshare-shrink_1280_800/B4DZbLDrHUHsAU-/0/1747163460743?e=2147483647&v=beta&t=rZtGF2kjhFfLy-TZil0d_bakH4UfHnK-dcxEsrZSl5s"
    }
  ],
  "articles": [
    {
      "headline": "Building Accessible React Components: A Practical Guide",
      "author": "Sarah Chen",
      "datePublished": "2024-09-15T13:08:55.000+00:00",
      "image": "https://media.licdn.com/dms/image/v2/C5612AQG9YbLJodxr8g/article-cover_image-shrink_720_1280/article-cover_image-shrink_720_1280/0/1520096757452?e=2147483647&v=beta&t=USPma8tkR65yot8_Ye0zDfH2llLpTrZdZGHtbzmPjQ0",
      "articleBody": "Accessibility isn't just a nice-to-have—it's essential for creating inclusive web experiences..."
    }
  ],
  "projects": [
    {
      "name": "DevTools Dashboard",
      "url": "https://github.com/sarahchen/devtools-dashboard",
      "dateRange": "2024 - Present",
      "description": "Open source developer productivity dashboard built with React, TypeScript, and Vite. Features real-time metrics, customizable widgets, and GitHub integration.",
      "contributors": [
        {
          "name": "Alex Rodriguez",
          "link": "https://www.linkedin.com/in/alexrodriguez-dev",
          "image": "https://media.licdn.com/dms/image/v2/C5603AQFFdhmfyyiZig/profile-displayphoto-shrink_400_400/profile-displayphoto-shrink_400_400/0/1581292451105?e=2147483647&v=beta&t=IwghMTQZZjJzIGbN6e1IYfWVBDAkgLP_kSJJPOkzQDg"
        }
      ]
    }
  ],
  "recommendations": [
    {
      "name": "Mike Johnson",
      "link": "https://www.linkedin.com/in/mikejohnson-tech",
      "image": "https://static.licdn.com/aero-v1/sc/h/9c8pery4andzj6ohjkjp54ma2",
      "text": "Sarah is an exceptional developer with a rare combination of technical expertise and mentorship skills. She consistently delivers high-quality code while helping junior developers grow. Any team would be lucky to have her."
    }
  ]
}
```

* **Content-Type:** application/json
* **X-RateLimit-Limit:** The rate limit for the user
* **X-RateLimit-Remaining:** The remaining number of requests for the user

### Bad Request (400)

Returned if the request is invalid or missing required parameters.

```json theme={null}
{
  "error": "'url' parameter is required and must be a non-empty string. Please provide a LinkedIn profile URL."
}
```

### Bad Gateway (502)

Returned if the external service is unavailable or returns invalid data.

```json theme={null}
{
  "error": "Failed to retrieve LinkedIn profile information"
}
```

### Internal Server Error (500)

Returned if there's an unexpected server error.

```json theme={null}
{
  "error": "An unexpected server error occurred while fetching LinkedIn profile information"
}
```

## Example Request

```bash theme={null}
curl -X POST https://app.dumplingai.com/api/v1/linkedin/profile \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
  "url": "https://www.linkedin.com/in/sarahchen-dev"
}'
```

## Example Response

```json theme={null}
{
  "success": true,
  "name": "Sarah Chen",
  "image": "https://media.licdn.com/dms/image/v2/C4E03AQH3Vz1qV_rNVQ/profile-displayphoto-shrink_200_200/profile-displayphoto-shrink_200_200/0/1633389534107?e=2147483647&v=beta&t=8x4PIfTIYFOvpI1QRCDyAhNprZv0NY9kAp4EOdvUxLQ",
  "location": "San Francisco, California, United States",
  "followers": 12847,
  "connections": "500+",
  "about": "Full-stack developer passionate about creating accessible web experiences...",
  "recentPosts": [
    {
      "title": "Just shipped a new feature that reduces our app's bundle size by 40%!",
      "activityType": "Posted by Sarah Chen",
      "link": "https://www.linkedin.com/posts/sarahchen-dev_webdev-performance-javascript-activity-7333305862695919617-zTPI"
    }
  ],
  "experience": [
    {
      "@type": "Organization",
      "name": "TechFlow",
      "url": "https://www.linkedin.com/company/techflow-inc",
      "location": "San Francisco, California"
    }
  ]
}
```

## Notes

* The `url` parameter must be a valid LinkedIn profile URL (contains 'linkedin.com/in/')
* This endpoint returns only publicly available information visible in an incognito browser
* Unfortunately, LinkedIn no longer shows work history or job titles publicly for most profiles
* The response includes recent posts, activity, education, and publicly visible experience
* Some profile sections may be empty if the user has privacy restrictions
* This endpoint uses **10 credits** per request
* Profile data may vary based on user privacy settings

## Rate Limiting

Rate limit headers (`X-RateLimit-Limit` and `X-RateLimit-Remaining`) are included in the response to indicate the user's current rate limit status.


## OpenAPI

````yaml POST /api/v1/linkedin/profile
openapi: 3.0.3
info:
  title: DumplingAI API
  version: 1.0.0
  description: >
    REST API for DumplingAI's content intelligence and automation platform.

    All endpoints are grouped under `/api/v1`; most are secured via Bearer API
    keys unless an operation explicitly sets `security: []`.
servers:
  - url: https://app.dumplingai.com
    description: Production
security:
  - bearerAuth: []
tags:
  - name: YouTube
    description: Access metadata, search results, and transcripts from YouTube.
  - name: TikTok
    description: Retrieve TikTok profile, video, follower, and transcript data.
  - name: LinkedIn
    description: Programmatically fetch LinkedIn company and profile data.
  - name: Search
    description: Search-orientated endpoints spanning web, news, maps, and autocomplete.
  - name: Google
    description: Integrations with Google business listings and location data.
  - name: Scraping
    description: Webpage capture, crawling, and structured content extraction utilities.
  - name: Documents
    description: Document processing, conversion, and metadata utilities.
  - name: AI
    description: DumplingAI agent and knowledge base endpoints.
  - name: Developer Tools
    description: Utilities for executing sandboxed code via API.
paths:
  /api/v1/linkedin/profile:
    post:
      tags:
        - LinkedIn
      summary: Get LinkedIn profile
      description: >-
        Retrieve LinkedIn profile metadata, experience, and statistics for a
        public profile URL.
      operationId: getLinkedInProfile
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LinkedInProfileRequest'
            examples:
              default:
                value:
                  url: https://www.linkedin.com/in/elenaverna/
      responses:
        '200':
          description: LinkedIn profile returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LinkedInProfileResponse'
        '400':
          description: Invalid request payload.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Missing or invalid API key.
        '500':
          description: Unexpected server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    LinkedInProfileRequest:
      type: object
      required:
        - url
      properties:
        url:
          type: string
          format: uri
          description: Full LinkedIn profile URL (`https://www.linkedin.com/in/...`).
        requestSource:
          $ref: '#/components/schemas/RequestSource'
      additionalProperties: false
    LinkedInProfileResponse:
      type: object
      properties:
        success:
          type: boolean
        name:
          type: string
        image:
          type: string
          format: uri
          nullable: true
        location:
          type: string
          nullable: true
        followers:
          type: integer
          nullable: true
        connections:
          type: string
          nullable: true
        about:
          type: string
          nullable: true
        recentPosts:
          type: array
          items:
            type: object
            properties:
              title:
                type: string
              activityType:
                type: string
                nullable: true
              link:
                type: string
                format: uri
                nullable: true
              image:
                type: string
                format: uri
                nullable: true
            required:
              - title
            additionalProperties: false
        activity:
          type: array
          items:
            type: object
            additionalProperties: true
        experience:
          type: array
          items:
            type: object
            additionalProperties: true
        articles:
          type: array
          items:
            type: object
            additionalProperties: true
        education:
          type: array
          items:
            type: object
            additionalProperties: true
        publications:
          type: array
          items:
            type: object
            additionalProperties: true
        projects:
          type: array
          items:
            type: object
            additionalProperties: true
        recommendations:
          type: array
          items:
            type: object
            additionalProperties: true
        similarProfiles:
          type: array
          items:
            type: object
            additionalProperties: true
      required:
        - success
      additionalProperties: true
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Human-readable description of what went wrong.
      required:
        - error
    RequestSource:
      type: string
      description: Optional identifier describing where the API request originated.
      enum:
        - API
        - WEB
        - MAKE_DOT_COM
        - ZAPIER
        - N8N
        - PLAYGROUND
        - DEFAULT_AUTOMATION
        - AGENT_PREVIEW
        - AGENT_LIVE
        - AUTOPILOT
        - STUDIO
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key

````