# LinkedIn API

**Provider:** LinkedIn
**Category:** social
**Base URL:** `https://api.linkedin.com/v2`
**Auth:** oauth2 — `Authorization: Bearer AQX...`
**Rate Limit:** 100 calls/day per user (default) · Higher with partner approval
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://learn.microsoft.com/en-us/linkedin/

## Description

The LinkedIn API (v2) allows applications to post articles and rich media to LinkedIn, access member profiles (with consent), manage company page content and analytics, retrieve job listings, and run marketing campaigns. The API uses OAuth 2.0 for all user-scoped operations. Most endpoints require an approved LinkedIn Partner Program application for production access. Widely used for social media management tools, recruiting platforms, and B2B marketing automation.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://api.linkedin.com/v2/me` | Get the authenticated member's profile |
| POST | `https://api.linkedin.com/v2/ugcPosts` | Create a text or media post on LinkedIn |
| GET | `https://api.linkedin.com/v2/organizations/{org_id}` | Get company page details and follower count |
| GET | `https://api.linkedin.com/v2/jobPostings` | List job postings for a company |
| GET | `https://api.linkedin.com/v2/networkSizes/{member_urn}` | Get a member's 1st/2nd degree network size |

## Authentication

LinkedIn uses OAuth 2.0. Redirect users to LinkedIn's authorization endpoint. Use the returned code to exchange for an access token. Pass as Bearer in the Authorization header.

```
Authorization: Bearer AQX...
```

## Sample Request

```bash
curl "https://api.linkedin.com/v2/me?projection=(id,firstName,lastName,profilePicture)" \
  -H "Authorization: Bearer $LINKEDIN_ACCESS_TOKEN"
```

## Sample Response

```json
{
  "id": "ByunXV3vn7",
  "firstName": { "localized": { "en_US": "Kevin" } },
  "lastName":  { "localized": { "en_US": "Grace"  } },
  "profilePicture": {
    "displayImage": "urn:li:digitalmediaAsset:C5103AQE8df"
  }
}
```

## Pricing Details

Core APIs (profile, share) are free. Marketing APIs require LinkedIn Marketing Developer Program membership. Talent APIs require Recruiter license. Usage limits vary by product.

---

*Source: [API Map](https://apimap.dev/apis/linkedin/) — CC BY 4.0*