n8n-nodes-scrapeunblocker-meta-ad-library

This is an n8n community node. It lets you get an advertiser's Facebook and Instagram ads from Meta's public Ad Library in your n8n workflows as JSON: ad copy, call to action, creative format, image and video URLs, landing page, platforms and run dates. Useful for competitor-ad monitoring and creative research.

The node runs the Meta Ad Library Scraper Actor by ScrapeUnblocker on the Apify platform with your own Apify account, waits for the run to finish and returns every scraped record as an n8n item.

n8n is a fair-code licensed workflow automation platform.

Installation
Credentials
Operations
Output
Example workflow
Pricing
Compatibility
Resources
Version history

Installation

Follow the installation guide in the n8n community nodes documentation. The npm package name is n8n-nodes-scrapeunblocker-meta-ad-library.

Credentials

The node authenticates with an Apify API token. Every run starts on the Apify account that owns the token and is billed to that account (see Pricing).

1. Create an Apify account (skip if you already have one)

1. Go to console.apify.com/sign-up and sign up with email, Google or GitHub.
2. Confirm your email address if Apify asks you to.

The free Apify plan needs no credit card and includes a monthly usage credit, which is enough to try the node. Current plan limits are listed on apify.com/pricing.

2. Get your API token

1. Open Apify Console and go to Settings → API & Integrations, or open console.apify.com/settings/integrations directly.
2. Find the Personal API tokens section.
3. Either use the existing token (the one marked Default API token created on sign up): click the eye icon to reveal it or the copy icon to copy it.
4. Or create a dedicated token for n8n (recommended, so you can revoke it without affecting anything else):
   1. Click + Add new token (the button may read Create new token).
   2. In the Create a new personal API token dialog, enter a Description such as n8n.
   3. Optionally switch on Set expiration date and pick a date.
   4. Leave Limit token permissions switched off. A token with limited permissions may not be allowed to run this Actor or read its results.
   5. Click Create and copy the new token.

The token starts with apify_api_. Treat it like a password: anyone who has it can run Actors on your account. You can revoke or rotate it on the same page at any time.

Working in an Apify organization? Switch to the organization in Apify Console first and copy a token from its API & Integrations page, so runs are billed to the organization.

3. Add the credential in n8n

1. Add the Meta Ad Library Scraper node to a workflow and open it.
2. In Credential to connect with, choose Create new credential. (You can also create an Apify API credential from the n8n credentials list.)
3. Paste the token into API Key and click Save. n8n checks the token right away; an invalid token shows Authorization failed - please check your credentials.

Already have an Apify API credential in n8n (for example from the official Apify node)? This node uses the same credential type, so you can simply select it.

Operations

Pick a Resource and an Operation. Each n8n input item starts one Apify run. List fields accept several values separated by commas or new lines, or an array returned by an expression.

Options

How a run works

1. The node starts the Actor on your Apify account with the fields you set.
2. It waits for the run to finish.
3. It returns every record from the run's dataset as a separate n8n item.

The run is also visible in Apify Console under Runs. If a run fails or times out, the node error links to the run log and tells you whether any results were saved before it stopped.

Stopping the n8n execution only stops the node from waiting: the Apify run keeps going and its results are still charged. To stop it, abort the run in Apify Console under Runs, and use Timeout (Seconds) to cap long runs up front.

Use as an AI Agent tool

The node can be attached to an n8n AI Agent as a tool, so the agent can call it on its own.

Output

• One item per ad, with ad copy, title, caption, call to action, display format, image and video creative URLs, landing page URL, platforms, start and end dates and whether the ad is still active.
• The advertiser's Page name, Page ID, Page URL and like count, and the ad archive ID. Use the Page ID as Advertiser to get only that Page's ads.

Fields of a returned item: ad_archive_id, collation_id, page_id, page_name, page_profile_uri, page_like_count, is_active, started_running, ended, platforms, display_format, is_dynamic, ad_text, title, caption, cta_text, cta_type, link_url, link_description, creatives, categories, currency, reach_estimate.

Example item (shortened):

{
  "ad_archive_id": "1301132848794012",
  "collation_id": null,
  "page_id": "721404351056614",
  "page_name": "IControl: Easy Widgets Themes",
  "page_profile_uri": "https://www.facebook.com/61578892468353/",
  "page_like_count": 4713,
  "is_active": true,
  "started_running": "2026-05-20",
  "ended": "2026-09-29",
  "platforms": [
    "FACEBOOK",
    "INSTAGRAM",
    "..."
  ],
  "display_format": "IMAGE",
  "is_dynamic": false,
  "ad_text": null,
  "title": "iControl: Easy Widgets Themes",
  "...": "..."
}

Example workflow

To try the node in a minute, copy the workflow below, paste it into the n8n editor (Ctrl+V / Cmd+V), open the Meta Ad Library Scraper node, select your Apify API credential and click Execute workflow.

{
  "nodes": [
    {
      "parameters": {},
      "name": "When clicking 'Execute workflow'",
      "type": "n8n-nodes-base.manualTrigger",
      "typeVersion": 1,
      "position": [
        0,
        0
      ]
    },
    {
      "parameters": {
        "resource": "ad",
        "operation": "getAll",
        "advertiser": "Nike",
        "maxAds": 3,
        "options": {}
      },
      "name": "Meta Ad Library Scraper",
      "type": "n8n-nodes-scrapeunblocker-meta-ad-library.metaAdLibraryScraper",
      "typeVersion": 1,
      "position": [
        220,
        0
      ]
    }
  ],
  "connections": {
    "When clicking 'Execute workflow'": {
      "main": [
        [
          {
            "node": "Meta Ad Library Scraper",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  }
}

Pricing

The node itself is free. The Actor is paid per result on Apify: $0.45 per 1,000 ads plus a tiny start fee per run ($0.00005), charged to the Apify account of your token. Every item the node returns counts as one result. The current price is always shown on the Actor page, and your spending is visible in Apify Console.

Compatibility

Tested with n8n 2.40 (self-hosted).

Resources

• Meta Ad Library Scraper Actor on Apify
• Apify API tokens documentation
• n8n community nodes documentation
• ScrapeUnblocker - the anti-bot scraping API behind the Actor

Version history

• 0.1.0: Initial release
• 0.1.1: First release published from GitHub Actions with an npm provenance statement
• 0.1.2: Node category renamed to Marketing & Content, the name n8n's verification scanner accepts