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

# LinkedIn Talent Solutions

> Integrate Mavera with LinkedIn Talent Solutions — job distribution optimization and candidate data talent personas

## Overview

Pull data from **LinkedIn Talent Solutions** (Job Postings, Candidate Exports, Application Analytics) → analyze with **Mavera** (Focus Groups, Custom Personas, Generate) → iterate job descriptions for higher apply rates and build talent personas grounded in real candidate profiles.

<Info>
  **LinkedIn Talent Solutions API** — Base URL: `https://api.linkedin.com/rest/`. Auth: OAuth 2.0 (3-legged). Access: **Restricted to approved LinkedIn partners** — you must apply via the [LinkedIn Developer Portal](https://developer.linkedin.com/) and be accepted into the Talent Solutions Partner Program. Rate limits vary by partnership tier.
</Info>

<Warning>
  LinkedIn's Talent Solutions APIs require partner approval. If you don't have partner access, use the **RSC (Recruiter System Connect) export** workflow in [Job 2](/integrations/linkedin-talent/talent-pipeline-personas) to work with exported CSV/JSON candidate data instead of direct API calls.
</Warning>

***

## Prerequisites

<Steps>
  <Step title="LinkedIn partner application">Apply at [LinkedIn Developer Portal](https://developer.linkedin.com/) → Talent Solutions Partner Program. Approval can take 2-4 weeks.</Step>
  <Step title="OAuth 2.0 app">Create an app in the LinkedIn Developer Portal with the `r_liteprofile`, `w_member_social`, and talent-specific scopes granted by your partnership.</Step>
  <Step title="Mavera API key">Get your key from [Mavera dashboard](https://app.mavera.io/settings/api-keys).</Step>

  <Step title="Environment variables">
    ```bash theme={"dark"}
    export LINKEDIN_ACCESS_TOKEN="your_oauth_access_token"
    export MAVERA_API_KEY="mvra_live_xxxxx"
    ```
  </Step>
</Steps>

***

## Jobs

| # | Job                                                                                                                 | LinkedIn Data                 | Mavera Surface                 | Output                                 |
| - | ------------------------------------------------------------------------------------------------------------------- | ----------------------------- | ------------------------------ | -------------------------------------- |
| 1 | [Job Distribution → Performance-Optimized Descriptions](/integrations/linkedin-talent/job-description-optimization) | simpleJobPostings + analytics | Focus Groups + Generate        | Iteratively optimized job descriptions |
| 2 | [Candidate Data → Talent Personas](/integrations/linkedin-talent/talent-pipeline-personas)                          | Exported profiles via RSC     | Custom Personas + Focus Groups | Employer value prop validation         |

***

## Access & Production Notes

| Requirement         | Detail                                                                                         |
| ------------------- | ---------------------------------------------------------------------------------------------- |
| **Partner access**  | Required for all Talent Solutions APIs. Apply via LinkedIn Developer Portal                    |
| **OAuth scopes**    | Varies by partnership tier. Minimum: `r_liteprofile`. Job posting: partnership-specific scopes |
| **Rate limits**     | Partnership-tier dependent. Typically 100-500 req/day for job posting endpoints                |
| **Data retention**  | LinkedIn data must be deleted within 30 days per Terms of Service. Don't persist raw profiles  |
| **RSC alternative** | For non-partners: export from LinkedIn Recruiter (CSV) and use Job 2 workflow                  |

<Warning>
  LinkedIn enforces strict data usage policies. Never cache candidate profile data beyond 30 days. Never share LinkedIn data with third parties. Mavera receives only aggregated, anonymized attributes — never profile URLs, names, or contact info.
</Warning>

**Checklist:**

* Apply for LinkedIn partner access (2-4 week approval)
* Use OAuth 2.0 with PKCE for production; refresh tokens before expiry
* Include `LinkedIn-Version` header on all API calls
* Strip PII before sending to Mavera
* Monitor Mavera credits at [Dashboard](https://app.mavera.io/settings/usage)
* For non-partners: use CSV export from Recruiter → parse → Mavera personas

***

<CardGroup cols={3}>
  <Card title="All Integrations" icon="plug" href="/integrations" />

  <Card title="LinkedIn Developer" icon="linkedin" href="https://developer.linkedin.com/" />

  <Card title="Personas" icon="user" href="/features/personas" />

  <Card title="Focus Groups" icon="users" href="/features/focus-groups" />

  <Card title="Generate" icon="wand-magic-sparkles" href="/features/generate" />

  <Card title="Mave Agent" icon="brain" href="/features/mave-agent" />
</CardGroup>