Skip to main content

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.

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.
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 and be accepted into the Talent Solutions Partner Program. Rate limits vary by partnership tier.
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 to work with exported CSV/JSON candidate data instead of direct API calls.

Prerequisites

1

LinkedIn partner application

Apply at LinkedIn Developer Portal → Talent Solutions Partner Program. Approval can take 2-4 weeks.
2

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.
3

Mavera API key

Get your key from Mavera dashboard.
4

Environment variables

export LINKEDIN_ACCESS_TOKEN="your_oauth_access_token"
export MAVERA_API_KEY="mvra_live_xxxxx"

Jobs

#JobLinkedIn DataMavera SurfaceOutput
1Job Distribution → Performance-Optimized DescriptionssimpleJobPostings + analyticsFocus Groups + GenerateIteratively optimized job descriptions
2Candidate Data → Talent PersonasExported profiles via RSCCustom Personas + Focus GroupsEmployer value prop validation

Access & Production Notes

RequirementDetail
Partner accessRequired for all Talent Solutions APIs. Apply via LinkedIn Developer Portal
OAuth scopesVaries by partnership tier. Minimum: r_liteprofile. Job posting: partnership-specific scopes
Rate limitsPartnership-tier dependent. Typically 100-500 req/day for job posting endpoints
Data retentionLinkedIn data must be deleted within 30 days per Terms of Service. Don’t persist raw profiles
RSC alternativeFor non-partners: export from LinkedIn Recruiter (CSV) and use Job 2 workflow
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.
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
  • For non-partners: use CSV export from Recruiter → parse → Mavera personas

All Integrations

LinkedIn Developer

Personas

Focus Groups

Generate

Mave Agent