# LinkedIn Profile

Scrape public LinkedIn profile information by public URL or numeric member ID, including experience, education, and skills.

- **Documentation:** [https://scrappa.co/docs/linkedin-api/linkedin_profile](https://scrappa.co/docs/linkedin-api/linkedin_profile)
- **API group:** LinkedIn API
- **Endpoint:** `GET https://scrappa.co/api/linkedin/profile`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string | No | LinkedIn profile URL. Required when profile_id is omitted. |
| `profile_id` | string | No | Numeric LinkedIn member ID. Required when url is omitted. |
| `use_cache` | boolean | No | Whether to use cached results (default: false) |
| `maximum_cache_age` | integer | No | Maximum age of cached results in seconds |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/linkedin/profile?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fwilliamhgates%2F"
```

## Example response

```json
{
    "success": true,
    "profile_id": "251749025",
    "url": "https://www.linkedin.com/in/williamhgates",
    "name": "Bill Gates",
    "image": "https://media.licdn.com/dms/image/v2/C4E03AQH...",
    "location": "Seattle, WA",
    "followers": 35000000,
    "connections": "500+",
    "about": "Co-chair of the Bill & Melinda Gates Foundation...",
    "job_titles": [
        "Co-chair",
        "Founder",
        "Co-founder"
    ],
    "experience": [
        {
            "company": "Bill & Melinda Gates Foundation",
            "url": "https://www.linkedin.com/company/bill-&-melinda-gates-foundation",
            "start_date": 2000,
            "end_date": null
        }
    ],
    "education": [
        {
            "school": "Harvard University",
            "url": "https://www.linkedin.com/school/harvard-university",
            "start_date": 1973,
            "end_date": 1975
        }
    ],
    "articles": [
        {
            "title": "The Future of Innovation",
            "url": "https://www.linkedin.com/pulse/future-innovation",
            "date_published": "2024-01-15",
            "likes": 12500,
            "image": "https://media.licdn.com/article-image.jpg"
        }
    ],
    "activity": [
        {
            "title": "Shared a post about climate change",
            "activityType": "Shared post",
            "link": "https://www.linkedin.com/posts/activity-123",
            "image": "https://media.licdn.com/activity-image.jpg"
        }
    ],
    "publications": [
        {
            "name": "How to Avoid a Climate Disaster",
            "url": "https://www.linkedin.com/pulse/climate-disaster"
        }
    ],
    "projects": [
        {
            "name": "Breakthrough Energy",
            "url": "https://www.linkedin.com/projects/breakthrough-energy",
            "dateRange": "2015 - Present",
            "description": "Investing in clean energy innovation",
            "contributors": [
                {
                    "name": "John Smith",
                    "link": "https://www.linkedin.com/in/johnsmith",
                    "image": "https://media.licdn.com/contributor.jpg"
                }
            ]
        }
    ],
    "recommendations": [
        {
            "name": "Jane Doe",
            "link": "https://www.linkedin.com/in/janedoe",
            "image": "https://media.licdn.com/recommender.jpg",
            "text": "Bill is an inspiring leader..."
        }
    ],
    "similar_profiles": [
        {
            "name": "Satya Nadella",
            "url": "https://www.linkedin.com/in/satya-nadella",
            "location": "Redmond, WA"
        }
    ],
    "skills": [
        "Philanthropy",
        "Technology",
        "Leadership",
        "Public Speaking"
    ],
    "cached": false
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | Neither url nor profile_id was supplied, or the supplied value is invalid. |
| 404 | Profile Not Found | LinkedIn does not know this profile. This is a definitive answer — retrying will return 404 again. |
| 503 | LinkedIn Temporarily Unavailable | The upstream service is temporarily unavailable. Please retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)