LinkedIn Matched Audiences - B2B Ad Targeting

Create and manage LinkedIn Matched Audiences for B2B advertising. Upload contact lists, company lists, website retargeting segments. Direct integration with LinkedIn Marketing API.

Features

Audience Management

• create_audience - Create a new matched audience
• get_audience - Get details of a specific audience
• list_audiences - List all matched audiences
• update_audience - Update audience name/description
• delete_audience - Delete a matched audience

Data Upload

• upload_contacts - Upload email contacts (auto-hashes)
• upload_companies - Upload company targeting list
• get_audience_count - Get matched audience size

Advanced Features

• create_lookalike - Create lookalike from source audience

Quick Start

{
  "input": "your input here"
}

Demo Mode

Set demoMode: true to test with sample data (no charges). When you're ready for real results, set demoMode: false or omit it.

{
  "demoMode": true,
  ...
}

Input Parameters

Parameter	Type	Required	Description
See input schema

Output Format

Audience Object

{
  "id": "urn:li:dmpSegment:123456",
  "name": "High Value Prospects",
  "description": "Decision makers at target accounts",
  "type": "CONTACT_TARGETING",
  "status": "READY",
  "matchedCount": 4520,
  "uploadStatus": "COMPLETE",
  "createdAt": "2024-01-20T14:30:00Z",
  "lastModifiedAt": "2024-01-21T10:15:00Z"
}

Upload Response

{
  "audienceId": "urn:li:dmpSegment:123456",
  "recordsUploaded": 5000,
  "recordsMatched": 4520,
  "recordsFailed": 12,
  "status": "PROCESSING"
}

Pricing

This actor uses pay-per-event billing: $0.01 per query (all tasks)

Use Cases

ABM Campaign

1. Create list of target account companies
2. Use upload_companies to create audience
3. Run ads to employees at target accounts

Lead Nurturing

1. Export leads from CRM/marketing automation
2. Use upload_contacts with email list
3. Retarget leads with LinkedIn ads

Expand Reach

1. Build audience of best customers
2. Use create_lookalike
3. Reach similar professionals

---

Common Problems & Solutions

"Invalid API key" error

Cause: Your API key is wrong, expired, or doesn't have the right permissions. Fix: Double-check your API key. Make sure you copied it exactly without extra spaces.

"Rate limit exceeded" error

Cause: You've hit the API's rate limits. Fix: Wait a few minutes, then try again. Consider reducing the number of concurrent requests.

Empty or incomplete results

Cause: The target may have anti-scraping protection or the data doesn't exist. Fix:

• Check if the URL/search query is correct
• Try with different parameters
• Some sites may block automated access

Demo data showing instead of real results

Cause: demoMode is still set to true. Fix: Set demoMode: false and provide your API key(s).

---

Built by John Rippy | Actor Arsenal