Skip to content

linkedin-ads.md

Latest commit

 

History

History
164 lines (121 loc) · 3.13 KB

linkedin-ads.md

File metadata and controls

164 lines (121 loc) · 3.13 KB

LinkedIn Ads

B2B advertising platform with professional targeting.

Capabilities

Integration Available Notes
API ✓ Marketing API for campaigns, audiences, analytics
MCP - Not available
CLI - Not available
SDK - API-only (community libraries available)

Authentication

  • Type: OAuth 2.0
  • Header: Authorization: Bearer {access_token}
  • Scopes: r_ads, r_ads_reporting, rw_ads

Common Agent Operations

Get ad accounts

GET https://api.linkedin.com/v2/adAccountsV2?q=search

Authorization: Bearer {access_token}

Get campaigns

GET https://api.linkedin.com/v2/adCampaignsV2?q=search&search.account.values[0]=urn:li:sponsoredAccount:{account_id}

Authorization: Bearer {access_token}

Get campaign analytics

GET https://api.linkedin.com/v2/adAnalyticsV2?q=analytics&pivot=CAMPAIGN&dateRange.start.year=2024&dateRange.start.month=1&dateRange.start.day=1&dateRange.end.year=2024&dateRange.end.month=1&dateRange.end.day=31&campaigns=urn:li:sponsoredCampaign:{campaign_id}&fields=impressions,clicks,costInLocalCurrency,conversions

Authorization: Bearer {access_token}

Create campaign

POST https://api.linkedin.com/v2/adCampaignsV2

Authorization: Bearer {access_token}

{
  "account": "urn:li:sponsoredAccount:{account_id}",
  "name": "Campaign Name",
  "type": "SPONSORED_UPDATES",
  "costType": "CPC",
  "unitCost": {
    "amount": "5.00",
    "currencyCode": "USD"
  },
  "dailyBudget": {
    "amount": "100.00",
    "currencyCode": "USD"
  },
  "status": "PAUSED"
}

Update campaign status

POST https://api.linkedin.com/v2/adCampaignsV2/{campaign_id}

Authorization: Bearer {access_token}

{
  "patch": {
    "$set": {
      "status": "ACTIVE"
    }
  }
}

Get creatives

GET https://api.linkedin.com/v2/adCreativesV2?q=search&search.campaign.values[0]=urn:li:sponsoredCampaign:{campaign_id}

Authorization: Bearer {access_token}

Get audience counts

POST https://api.linkedin.com/v2/audienceCountsV2

{
  "audienceCriteria": {
    "include": {
      "and": [{
        "or": {
          "urn:li:adTargetingFacet:titles": ["urn:li:title:123"]
        }
      }]
    }
  }
}

Key Metrics

Metric Description
impressions Ad impressions
clicks Total clicks
costInLocalCurrency Spend
conversions Conversion count
leadGenerationMailContactInfoShares Lead form submissions

Campaign Types

  • SPONSORED_UPDATES - Sponsored content
  • TEXT_AD - Text ads
  • SPONSORED_INMAILS - Message ads
  • DYNAMIC - Dynamic ads

Targeting Options

Job-Based

  • Job titles
  • Job functions
  • Seniority levels
  • Years of experience

Company-Based

  • Company names
  • Industries
  • Company size
  • Company followers

Professional

  • Skills
  • Groups
  • Schools
  • Degrees

When to Use

  • B2B advertising
  • Job title targeting
  • Account-based marketing
  • Lead generation campaigns

Rate Limits

  • 100 requests/day (basic)
  • 10,000 requests/day (Marketing Developer Platform)

Relevant Skills

  • ads
  • analytics