API Reference Card
| Detail | Value |
|---|---|
| Base URL | https://api.linkedin.com/rest/ |
| Auth | OAuth 2.0 (3-legged) — Authorization: Bearer {token} + LinkedIn-Version: 202401 header |
| Rate limits | Daily, unpublished — varies by endpoint and app tier; throttled via X-Li-Throttle headers |
| Mavera base | https://app.mavera.io/api/v1 |
| Mavera auth | Authorization: Bearer mvra_live_... |
All examples use two environment variables:
LINKEDIN_ACCESS_TOKEN and MAVERA_API_KEY. LinkedIn tokens expire — use the refresh token flow for production jobs. Never commit tokens.Prerequisites
LinkedIn Marketing API access
Create an app at LinkedIn Developers with the Advertising API product. Request access to
r_ads, r_ads_reporting, r_ads_leadgen_automation, and r_organization_social scopes.3-legged OAuth token
Complete the Authorization Code Flow to obtain an access token. Store the refresh token for automated renewal.
Mavera API key
Get your key from Mavera dashboard.
Jobs
| # | Job | LinkedIn Data | Mavera Surface | Output |
|---|---|---|---|---|
| 1 | Sponsored Content → Focus Group | Creatives from ad accounts | Focus Groups + Personas | B2B persona feedback on ad relevance |
| 2 | Lead Gen → Persona Enrichment | Lead gen form responses | Persona Discovery + Custom Personas | Enriched personas by title/industry/size |
| 3 | Campaign Analytics → Content Brief | Analytics pivoted by industry/function/seniority | Mave Agent + Generate | Segment-specific content briefs |
| 4 | Ad Copy Generation | Existing ad copy + metrics | Generate + Brand Voice | New ad copy with brand voice |
Rate Limits & Production Notes
| LinkedIn Endpoint | Limit | Strategy |
|---|---|---|
| Creatives / Campaigns | Daily quota (unpublished) | Cache responses; batch requests |
| Ad Analytics | Daily quota | Run overnight; store results locally |
| Lead Gen Forms | Daily quota | Paginate with start/count; cache |
LinkedIn-Version header on every call. Monitor Mavera credits at Dashboard. Cache LinkedIn data locally for daily jobs.