# LinkedIn Profile (`linkedin.profile`)

Full public LinkedIn member profile from a profile URL: headline, location, follower and connection counts, experience, education, skills and certifications.

Docs: https://primaryapi.com/docs/api-reference/linkedin/profile

- Endpoint: `POST https://api.primaryapi.com/v1/run/linkedin.profile`
- Category: Social · Platform: `linkedin` · Kind: lookup · Status: live
- Price: 5 credits per call; up to 7 credits if a call is retried elsewhere. A quote’s `maxCredits` is the most a given call can cost.
- Billing unit: per successful call
- Reliability: routed to a healthy upstream and retried automatically when an attempt fails; live 30-day status: `GET https://api.primaryapi.com/v1/status/apis?sku=linkedin.profile`
- Execution: synchronous (answers 202 only if it outlives the wait window)

## Input

| Field | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| `url` | string | yes |  | max 2048 chars | LinkedIn profile URL (https://www.linkedin.com/in/<id>) or its public identifier, e.g. "williamhgates". |

Unknown fields are rejected with `400 invalid_input`. The routing controls `preferLatencyUnderMs` and `maxCredits` may be sent in the same JSON body.

## Output

When `output.found` is `true`, `output.data` has this shape:

| Field | Type | Description |
|---|---|---|
| `id` | string \| null | LinkedIn member id |
| `publicIdentifier` | string \| null | Vanity handle from the profile URL |
| `url` | string \| null |  |
| `name` | string \| null |  |
| `firstName` | string \| null |  |
| `lastName` | string \| null |  |
| `headline` | string \| null |  |
| `about` | string \| null |  |
| `photo` | string \| null |  |
| `location` | string \| null | Location text as shown on the profile |
| `city` | string \| null |  |
| `state` | string \| null |  |
| `country` | string \| null |  |
| `countryCode` | string \| null |  |
| `connectionsCount` | integer \| null |  |
| `followerCount` | integer \| null |  |
| `openToWork` | boolean \| null |  |
| `hiring` | boolean \| null |  |
| `premium` | boolean \| null |  |
| `influencer` | boolean \| null |  |
| `creator` | boolean \| null |  |
| `verified` | boolean \| null |  |
| `currentPosition` | object \| null | Current employer, when shown |
| `currentPosition.companyName` | string \| null |  |
| `currentPosition.companyLinkedinUrl` | string \| null |  |
| `experience` | object[] |  |
| `experience[].title` | string \| null | Position title |
| `experience[].companyName` | string \| null |  |
| `experience[].companyLinkedinUrl` | string \| null |  |
| `experience[].companyId` | string \| null |  |
| `experience[].location` | string \| null |  |
| `experience[].duration` | string \| null | Duration as shown, e.g. "1 yr 7 mos" |
| `experience[].description` | string \| null |  |
| `experience[].employmentType` | string \| null |  |
| `experience[].workplaceType` | string \| null |  |
| `experience[].startDate` | string \| null | Date as LinkedIn shows it, e.g. "Jan 2024" or "Present". |
| `experience[].endDate` | string \| null | Date as LinkedIn shows it, e.g. "Jan 2024" or "Present". |
| `experience[].skills` | string[] |  |
| `education` | object[] |  |
| `education[].school` | string \| null |  |
| `education[].schoolUrl` | string \| null |  |
| `education[].degree` | string \| null |  |
| `education[].fieldOfStudy` | string \| null |  |
| `education[].startDate` | string \| null | Date as LinkedIn shows it, e.g. "Jan 2024" or "Present". |
| `education[].endDate` | string \| null | Date as LinkedIn shows it, e.g. "Jan 2024" or "Present". |
| `skills` | string[] |  |
| `topSkills` | string[] |  |
| `certifications` | object[] |  |
| `certifications[].title` | string \| null |  |
| `certifications[].issuedBy` | string \| null |  |
| `certifications[].issuedAt` | string \| null |  |
| `languages` | object[] |  |
| `languages[].name` | string \| null |  |
| `languages[].proficiency` | string \| null |  |
| `projects` | object[] |  |
| `publications` | object[] |  |
| `honorsAndAwards` | object[] |  |

When the thing you asked about does not exist (or a search matches nothing) the call still succeeds: `output.found` is `false`, `output.data` is `null` and `output.reason` says why (`not_found`, `private`, `no_results`, …). Misses are free unless the notes below say misses are billed.

## Example request

```bash
curl -sS -X POST "https://api.primaryapi.com/v1/run/linkedin.profile" \
  -H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/in/williamhgates"}'
```

## Example response

_Values are placeholders that follow the output schema; `credits` is what this call would cost at the usual price._

```json
{
  "output": {
    "found": true,
    "data": {
      "id": "string",
      "publicIdentifier": "string",
      "url": "https://www.linkedin.com/in/williamhgates",
      "name": "string",
      "firstName": "string",
      "lastName": "string",
      "headline": "string",
      "about": "string",
      "photo": "string",
      "location": "string",
      "city": "string",
      "state": "string",
      "country": "string",
      "countryCode": "string",
      "connectionsCount": 0,
      "followerCount": 0,
      "openToWork": true,
      "hiring": true,
      "premium": true,
      "influencer": true,
      "creator": true,
      "verified": true,
      "currentPosition": {
        "companyName": "string",
        "companyLinkedinUrl": "https://example.com"
      },
      "experience": [
        {
          "title": "string",
          "companyName": "string",
          "companyLinkedinUrl": "https://example.com",
          "companyId": "string",
          "location": "string",
          "duration": "string",
          "description": "string",
          "employmentType": "string",
          "workplaceType": "string",
          "startDate": "string",
          "endDate": "string",
          "skills": [
            "string"
          ]
        }
      ],
      "education": [
        {
          "school": "string",
          "schoolUrl": "https://example.com",
          "degree": "string",
          "fieldOfStudy": "string",
          "startDate": "string",
          "endDate": "string"
        }
      ],
      "skills": [
        "string"
      ],
      "topSkills": [
        "string"
      ],
      "certifications": [
        {
          "title": "string",
          "issuedBy": "string",
          "issuedAt": "string"
        }
      ],
      "languages": [
        {
          "name": "string",
          "proficiency": "string"
        }
      ],
      "projects": [
        {}
      ],
      "publications": [
        {}
      ],
      "honorsAndAwards": [
        {}
      ]
    }
  },
  "provider": "PrimaryAPI",
  "credits": 5,
  "items": 1,
  "requestId": "req_01JBXK6Y2N9V8T4R3Q2P1M0A7Z"
}
```

## Pricing and reliability

- Usual price: 5 credits per call
- Price ceiling: up to 7 credits if a call is retried elsewhere. A quote’s `maxCredits` is the most a given call can cost; the `maxCredits` routing control caps it per call
- Live 30-day status, success rate, uptime and latency: `GET https://api.primaryapi.com/v1/status/apis?sku=linkedin.profile`

## Errors to handle

`invalid_input`, `unauthorized`, `insufficient_balance`, `key_limit_reached`, `trial_cap_reached`, `forbidden`, `not_found`, `idempotency_conflict`, `rate_limited`, `all_sources_failed`, `service_unavailable`, `timeout`. See https://primaryapi.com/docs/errors.

## Notes

Experience, education and skill sections can be partly empty for some members; fields LinkedIn does not show stay null or empty. A profile that does not exist or is not public is a miss and costs nothing.

## Legal

Public LinkedIn data only. LinkedIn’s User Agreement restricts automated collection and LinkedIn enforces it; use the data for lawful purposes, keep copies only as long as you need them, and treat post and article text as the author’s content (analysis, not republication). Results contain personal data about identifiable people (GDPR, UK GDPR, CCPA): have a lawful basis, honour deletion requests, and never use it for spam or unsolicited bulk outreach.

