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

# Meta Ads Library

> Search and retrieve ads from Meta's Ad Library

The **Meta Ads Library** node lets you search and retrieve ads from Meta's Ad Library. Access publicly available ad data across Facebook, Instagram, and other Meta platforms for competitive analysis, research, and monitoring purposes.

***

## When to Use It

* Research competitor advertising strategies and creative approaches
* Monitor ad trends across Facebook, Instagram, and Meta platforms
* Analyze advertising activity for specific brands or pages
* Gather competitive intelligence for campaign planning
* Track political and issue-based advertising transparency
* Study ad creative performance across different media types

***

## Inputs

| Field                 | Type           | Required | Description                                                         |
| --------------------- | -------------- | -------- | ------------------------------------------------------------------- |
| **Search Mode**       | Select         | Yes      | Choose how to configure the search                                  |
| **Group Similar Ads** | Switch         | No       | Show only one ad per creative group instead of duplicate variations |
| **Limit**             | Dynamic-number | No       | Maximum number of results to return (1-1000, default: 50)           |

### Search Mode Options

#### Manual Configuration

Configure search parameters individually:

| Field                   | Type         | Required | Description                                                        |
| ----------------------- | ------------ | -------- | ------------------------------------------------------------------ |
| **Search Query**        | Dynamic-text | No       | Keyword or phrase to search for in ads. Use quotes for exact match |
| **Facebook Page ID**    | Dynamic-text | No       | Search ads from a specific Facebook page                           |
| **Country**             | Select       | No       | Filter ads by country (default: All Countries)                     |
| **Ad Type**             | Select       | No       | Filter by type of advertisements (default: All Ad Types)           |
| **Ad Status**           | Select       | No       | Filter ads by their current status (default: Active Ads Only)      |
| **Media Type**          | Select       | No       | Filter ads by media content type (default: All Media Types)        |
| **Publisher Platforms** | Multi-select | No       | Select which platforms to search ads from                          |
| **Date Range**          | Date-range   | No       | Filter ads by date range                                           |

#### Paste Meta Ads Library URL

| Field                    | Type         | Required | Description                    |
| ------------------------ | ------------ | -------- | ------------------------------ |
| **Meta Ads Library URL** | Dynamic-text | Yes      | Full URL from Meta Ads Library |

### Ad Type Options

| Type                      | Description                                                          |
| ------------------------- | -------------------------------------------------------------------- |
| **All Ad Types**          | Include all types of advertisements                                  |
| **Political & Issue Ads** | Only political and issue-based advertisements requiring transparency |

### Ad Status Options

| Status                | Description                             |
| --------------------- | --------------------------------------- |
| **Active Ads Only**   | Currently running advertisements        |
| **Inactive Ads Only** | Ads that are no longer active           |
| **All Ads**           | Both active and inactive advertisements |

### Media Type Options

| Type                | Description                             |
| ------------------- | --------------------------------------- |
| **All Media Types** | Include all media formats               |
| **Video Ads**       | Advertisements containing video content |
| **Image Ads**       | Static image advertisements             |
| **Meme Ads**        | Meme-style advertisements               |
| **Images & Memes**  | Both image and meme formats             |
| **No Media**        | Text-only advertisements without media  |

### Publisher Platform Options

Select from:

* **Facebook** - Ads on Facebook platform
* **Instagram** - Ads on Instagram platform
* **Audience Network** - Ads on Meta's Audience Network
* **Messenger** - Ads in Messenger
* **Threads** - Ads on Threads platform

### Country Options

Choose from "All Countries" or select specific countries to filter ads by geographic targeting.

***

## Output

Returns structured data containing ad information including:

* Ad creative content and media (images, videos, text)
* Advertiser/page information
* Platform placement details
* Date ranges and activity periods
* Targeting and demographic information
* Ad status and performance indicators
* Media URLs and creative assets

***

## Credit Cost

* **Cost**: 1 credit per 10 ads retrieved
* **Minimum**: 5 credits per run
* **Examples**:
  * 1-50 ads = 5 credits
  * 51-100 ads = 10 credits
  * 101-150 ads = 15 credits

***

## How to Get URLs

1. Visit the [Meta Ad Library](https://www.facebook.com/ads/library/)
2. Use the search filters to find ads (keyword, page, country, date range, etc.)
3. Configure your desired filters and search parameters
4. Once you see the results you want, copy the full URL from your browser's address bar
5. Paste this URL into the node when using "Paste Meta Ads Library URL" mode

**Example URL format:**

```
https://www.facebook.com/ads/library/?q=nike&country=US
```

***

## How to Find Facebook Page ID

1. Go to the Meta Ad Library and search for a brand or company
2. Click on "See All" next to their ads or go to their page view
3. Look at the URL - the Page ID appears after `view_all_page_id=`
4. Copy this number (e.g., 107884398698308) to use in the Facebook Page ID field

**Example:**

```
https://www.facebook.com/ads/library/?active_status=all&ad_type=all&country=ALL&view_all_page_id=107884398698308
```

The Page ID is: `107884398698308`

***

## FAQs

<Accordion title="How do I find a Facebook Page ID?">
  There are several ways to find a Facebook Page ID:

  **Method 1: From Meta Ad Library**

  1. Go to the [Meta Ad Library](https://www.facebook.com/ads/library/)
  2. Search for the brand or company name
  3. Click "See All" next to their ads or view their page ads
  4. Look at the URL - the Page ID appears after `view_all_page_id=`
  5. Copy the number (e.g., 107884398698308)

  **Method 2: From Facebook Page**

  1. Go to the Facebook page you want the ID for
  2. Right-click and "View Page Source" or use browser developer tools
  3. Search for "page\_id" in the source code
  4. The ID will be a long number

  **Method 3: Using Facebook's Graph API Explorer**

  1. Go to Facebook's Graph API Explorer
  2. Enter the page username or name in the search
  3. The response will include the page ID

  **Example Page ID:** `107884398698308` (Nike's page)
</Accordion>

<Accordion title="What's the difference between Search Query and Facebook Page ID?">
  * **Search Query**: Searches for ads containing specific keywords or phrases across all advertisers
  * **Facebook Page ID**: Retrieves all ads from a specific Facebook page/advertiser

  You can use both together to find ads from a specific page that contain certain keywords, or use them separately.
</Accordion>

<Accordion title="Which search mode should I use?">
  * **Manual Configuration**: Use when you want fine control over search parameters or need to search programmatically with dynamic inputs
  * **Paste URL**: Use when you've already found the ads you want in the Meta Ad Library and want to extract the same results
</Accordion>

<Accordion title="What does 'Group Similar Ads' do?">
  When enabled, this option shows only one representative ad from each creative group, reducing duplicate variations of the same ad. This is useful when you want to see unique creative concepts rather than all variations of the same ad with minor differences.
</Accordion>

<Accordion title="Can I search across multiple platforms at once?">
  Yes. Use the Publisher Platforms multi-select field to choose which Meta platforms to include in your search (Facebook, Instagram, Audience Network, Messenger, Threads). If no platforms are selected, all platforms are included.
</Accordion>

<Accordion title="Are there any limitations on the data I can access?">
  Yes. The Meta Ad Library shows:

  * Only ads that are currently active or were recently active
  * Ads that meet Meta's transparency requirements
  * Limited historical data (typically recent months/years)
  * Public information only (no private targeting details)

  Political and issue ads have additional transparency requirements and longer retention periods.
</Accordion>

<Accordion title="How do I search for exact phrases?">
  Use quotes around your search query to find ads containing the exact phrase. For example:

  * `nike air max` - finds ads containing these words in any order
  * `"nike air max"` - finds ads containing this exact phrase
</Accordion>

<Accordion title="Can I filter by specific date ranges?">
  Yes. Use the Date Range field in Manual Configuration mode to specify custom start and end dates. This helps you analyze advertising activity during specific periods, such as holiday campaigns or product launches.
</Accordion>

<Accordion title="What's the difference between Active and Inactive ads?">
  * **Active Ads**: Currently running and visible to users
  * **Inactive Ads**: No longer running but still visible in the Ad Library for transparency
  * **All Ads**: Includes both active and inactive advertisements

  Note that inactive ads may have limited availability depending on how long ago they stopped running.
</Accordion>