> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# LinkedIn Ads Library

> Search and retrieve ads from LinkedIn's Ads Library to analyze competitor campaigns

The **LinkedIn Ads Library** node lets you search and retrieve ads from LinkedIn's Ads Library. Access publicly available professional ad data from LinkedIn for competitive analysis, research, and B2B marketing intelligence. This is an **AI-powered node** that can understand natural language search queries.

***

## When to Use It

* Research competitor B2B advertising strategies on LinkedIn
* Monitor professional ad trends and creative approaches
* Analyze advertising activity for specific brands or companies
* Gather competitive intelligence for LinkedIn campaign planning
* Study sponsored content and ad creative performance
* Track advertiser activity in your industry or niche

***

## Inputs

| Field          | Type   | Required | Description                                                    |
| -------------- | ------ | -------- | -------------------------------------------------------------- |
| **Input Mode** | Select | Yes      | Choose how to configure the search                             |
| **Limit**      | Number | No       | Maximum number of results to return (default: 25, minimum: 25) |

### Input Mode Options

#### URL Mode

Parse an existing LinkedIn Ads Library URL:

| Field                        | Type | Required | Description                                    |
| ---------------------------- | ---- | -------- | ---------------------------------------------- |
| **LinkedIn Ads Library URL** | Text | Yes      | Full URL from LinkedIn Ads Library search page |

#### Manual Configuration

Configure search parameters individually:

| Field              | Type       | Required | Description                                                                                      |
| ------------------ | ---------- | -------- | ------------------------------------------------------------------------------------------------ |
| **Search Keyword** | Text       | No\*     | Keyword or phrase to search for in ads                                                           |
| **Advertiser**     | Text       | No\*     | Company or advertiser name to search for (e.g., 'microsoft', 'salesforce')                       |
| **Country**        | Text       | No       | Country filter - use 'ALL' for all countries or comma-separated country codes (e.g., 'US,CA,GB') |
| **Date Range**     | Date Range | No       | Custom date range to filter ads by when they were active                                         |

\*Either Search Keyword or Advertiser must be provided for manual configuration.

### Country Code Examples

| Country            | Code | Country       | Code |
| ------------------ | ---- | ------------- | ---- |
| **United States**  | US   | **Canada**    | CA   |
| **United Kingdom** | GB   | **Germany**   | DE   |
| **France**         | FR   | **Australia** | AU   |
| **India**          | IN   | **Japan**     | JP   |

***

## Output

Returns a list of LinkedIn ads with detailed information:

```json theme={"dark"}
{
  "ads": [
    {
      "ad_id": "123456",
      "advertiser_name": "Microsoft",
      "ad_text": "Transform your business with AI-powered solutions",
      "headline": "Microsoft AI for Business",
      "call_to_action": "Learn More",
      "image_url": "https://media.licdn.com/...",
      "landing_page_url": "https://microsoft.com/ai-business",
      "first_shown": "2024-10-01",
      "last_shown": "2024-10-15",
      "countries": ["US", "CA", "GB"],
      "ad_format": "Single Image",
      "engagement_metrics": {
        "impressions_range": "10K-50K",
        "clicks_range": "500-1K"
      }
    }
  ],
  "total_found": 47,
  "search_params": {
    "keyword": "AI solutions",
    "advertiser": "microsoft",
    "country": "US,CA,GB"
  }
}
```

### Output Fields:

| Field                   | Description                                 |
| ----------------------- | ------------------------------------------- |
| **ad\_id**              | Unique identifier for the ad                |
| **advertiser\_name**    | Company or brand name running the ad        |
| **ad\_text**            | Main ad copy/description text               |
| **headline**            | Ad headline or title                        |
| **call\_to\_action**    | CTA button text (Learn More, Sign Up, etc.) |
| **image\_url**          | URL to the ad creative image                |
| **landing\_page\_url**  | Destination URL when ad is clicked          |
| **first\_shown**        | Date when ad first appeared                 |
| **last\_shown**         | Date when ad was last seen                  |
| **countries**           | List of countries where ad was shown        |
| **ad\_format**          | Type of ad (Single Image, Video, Carousel)  |
| **engagement\_metrics** | Estimated engagement ranges                 |

***

## Credit Cost

* **Cost per run**: 5 credits

***

## FAQs

<Accordion title="What's the difference between URL mode and manual configuration?">
  **URL Mode:**

  * Copy/paste a LinkedIn Ads Library URL directly
  * Automatically extracts all search parameters from the URL
  * Fastest way to replicate an existing search
  * Perfect when you've already found what you're looking for in the LinkedIn Ads Library

  **Manual Configuration:**

  * Set up search parameters individually
  * More control over specific search criteria
  * Better for programmatic searches
  * Ideal for building automated competitive monitoring workflows

  **When to use each:**

  * **URL Mode**: Quick research, replicating searches, one-time analysis
  * **Manual Mode**: Automated workflows, systematic monitoring, API integrations
</Accordion>

<Accordion title="How do I find specific advertisers or companies?">
  **Using the Advertiser Field:**

  * Enter the company name exactly as it appears on LinkedIn
  * Try variations: 'Microsoft', 'microsoft', 'Microsoft Corporation'
  * Use partial names: 'micro' might find Microsoft-related advertisers
  * Check the company's LinkedIn page for their exact business name

  **Search Tips:**

  * **Exact company names work best**: 'salesforce' vs 'Salesforce.com'
  * **Try both branded and legal names**: 'Google' vs 'Google LLC'
  * **Use subsidiary names**: 'YouTube' for Google's video platform ads
  * **Check different name formats**: 'AWS' vs 'Amazon Web Services'

  **Troubleshooting:**

  * If no results, try the keyword search instead with the company name
  * Some companies may not have active LinkedIn ads
  * Verify the company actually advertises on LinkedIn
  * Try searching with broader industry terms first
</Accordion>

<Accordion title="What types of ads can I find in LinkedIn's Ads Library?">
  **Ad Formats Available:**

  * **Sponsored Content**: Native posts in LinkedIn feeds
  * **Single Image Ads**: Standard image-based advertisements
  * **Video Ads**: Video content in feeds and messaging
  * **Carousel Ads**: Multiple images or cards in one ad
  * **Text Ads**: Simple text-based sidebar advertisements
  * **Dynamic Ads**: Personalized ads using LinkedIn profile data

  **Content Types:**

  * **B2B Software**: CRM, marketing tools, business applications
  * **Professional Services**: Consulting, legal, financial services
  * **Education**: Online courses, certifications, training programs
  * **Recruitment**: Job postings, employer branding campaigns
  * **Events**: Webinars, conferences, professional events
  * **Thought Leadership**: Industry insights, whitepapers, reports

  **Industries Commonly Found:**

  * Technology and software companies
  * Professional services firms
  * Educational institutions and training providers
  * Recruitment and HR companies
  * Financial services and consulting
  * B2B marketplaces and platforms
</Accordion>

<Accordion title="How can I use this for competitive analysis?">
  **Competitor Research Strategies:**

  **Monitor Direct Competitors:**

  ```
  Search by Advertiser: [Competitor Company Name]
  Date Range: Last 30 days
  Review: Ad copy, messaging, offers, landing pages
  ```

  **Industry Trend Analysis:**

  ```
  Search Keyword: [Industry Terms]
  Country: [Your Target Markets]
  Analyze: Common messaging themes, visual styles, CTAs
  ```

  **Campaign Timeline Tracking:**

  ```
  Search: Specific competitor
  Date Range: Last 6 months
  Track: Campaign evolution, seasonal patterns, product launches
  ```

  **Creative Intelligence:**

  * **Ad Copy Analysis**: Headlines, descriptions, value propositions
  * **Visual Trends**: Image styles, brand colors, design approaches
  * **CTA Patterns**: Most common call-to-action buttons
  * **Landing Page Strategies**: Destination URLs and conversion paths
  * **Targeting Insights**: Countries and demographics being targeted

  **Workflow Integration:**

  * **Weekly Monitoring**: Schedule automated competitor searches
  * **Campaign Planning**: Use insights for your own campaign strategy
  * **Content Creation**: Identify gaps and opportunities in messaging
  * **Market Research**: Understand industry advertising trends
</Accordion>

<Accordion title="What are the search limitations and best practices?">
  **Search Limitations:**

  * **Minimum 25 results**: Each search returns at least 25 ads (5 credits)
  * **Public ads only**: Only shows ads in LinkedIn's public transparency database
  * **Recent ads**: Focus on currently active or recently active advertisements
  * **Geographic availability**: Some ads may be region-specific

  **Search Best Practices:**

  **Effective Keyword Selection:**

  * **Use industry terms**: 'CRM software', 'marketing automation'
  * **Try branded keywords**: Company names, product names
  * **Test variations**: Singular/plural, synonyms, related terms
  * **Avoid too broad**: 'marketing' vs 'email marketing software'

  **Country Targeting:**

  * **Start broad**: Use 'ALL' to see global patterns
  * **Narrow down**: Focus on your target markets
  * **Compare regions**: See how messaging varies by geography
  * **Use codes**: 'US,CA,GB' for North America + UK

  **Date Range Strategy:**

  * **Recent trends**: Last 30 days for current campaigns
  * **Seasonal analysis**: Compare same periods year-over-year
  * **Campaign lifecycle**: 3-6 months to see full campaign evolution
  * **Product launch**: Narrow ranges around known launch dates

  **Optimization Tips:**

  * **Start with competitors**: Direct competitor analysis first
  * **Expand to keywords**: Broader industry trend analysis second
  * **Monitor regularly**: Set up recurring searches for ongoing intelligence
  * **Document insights**: Track changes over time for better analysis
</Accordion>