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.

LinkedIn Campaign Manager holds your highest-intent B2B signals — ad impressions by seniority, lead gen form fills with job titles, and creative performance by industry vertical. These four jobs pull that data through Mavera’s surfaces (Focus Groups, Personas, Mave Agent, Generate) so every sponsored post, lead nurture, and content brief is grounded in real campaign intelligence.

API Reference Card

DetailValue
Base URLhttps://api.linkedin.com/rest/
AuthOAuth 2.0 (3-legged) — Authorization: Bearer {token} + LinkedIn-Version: 202401 header
Rate limitsDaily, unpublished — varies by endpoint and app tier; throttled via X-Li-Throttle headers
Mavera basehttps://app.mavera.io/api/v1
Mavera authAuthorization: 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

1

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

3-legged OAuth token

Complete the Authorization Code Flow to obtain an access token. Store the refresh token for automated renewal.
3

Mavera API key

Get your key from Mavera dashboard.
4

Environment variables

export LINKEDIN_ACCESS_TOKEN="AQV..." and export MAVERA_API_KEY="mvra_live_xxxxx"

Jobs

#JobLinkedIn DataMavera SurfaceOutput
1Sponsored Content → Focus GroupCreatives from ad accountsFocus Groups + PersonasB2B persona feedback on ad relevance
2Lead Gen → Persona EnrichmentLead gen form responsesPersona Discovery + Custom PersonasEnriched personas by title/industry/size
3Campaign Analytics → Content BriefAnalytics pivoted by industry/function/seniorityMave Agent + GenerateSegment-specific content briefs
4Ad Copy GenerationExisting ad copy + metricsGenerate + Brand VoiceNew ad copy with brand voice

Rate Limits & Production Notes

LinkedIn EndpointLimitStrategy
Creatives / CampaignsDaily quota (unpublished)Cache responses; batch requests
Ad AnalyticsDaily quotaRun overnight; store results locally
Lead Gen FormsDaily quotaPaginate with start/count; cache
LinkedIn does not publish exact rate limits for Marketing API endpoints. Monitor X-Li-Throttle-* response headers and respect Retry-After on 429s. For production, implement exponential backoff starting at the Retry-After value.
Checklist: Secure tokens in env vars or secrets manager. Implement OAuth refresh token rotation — access tokens expire after 60 days. Include LinkedIn-Version header on every call. Monitor Mavera credits at Dashboard. Cache LinkedIn data locally for daily jobs.

All Integrations

LinkedIn Marketing API

Personas

Focus Groups

Brand Voice

Mave Agent