Meta Ads

The Meta Ads node searches Meta's public Ad Library and returns the matching Facebook and Instagram ads as a JSON list. Each ad carries the advertiser's Page, the ad copy, headline, call to action, landing link, image and video links, run dates and whether it is still active. Wire the list into a Generate Text - Any LLM node for competitive analysis, or into Extract Field to run one generation per ad.

When to use it

• Research how competitors advertise a product category, with a keyword search.
• Follow the newest creatives of a specific brand, by advertiser or Facebook Page.
• Start a creative workflow from real ad copy and visuals, then remix them.
• Send yourself a recurring digest of new ads, with a Schedule Trigger.

Quick start

Search by

The Keyword and Facebook Page URLs fields accept {}. The text of a node connected to the Keyword / Page URLs input replaces {}, so a Text or List node can drive the search.

In Advertiser mode, you can also connect a Text or List node to the input instead of picking advertisers. Each line is then matched to a Facebook Page when the node runs: the verified match, or else the first match. The result lists the Pages it found in resolvedAdvertisers.

Settings

Inputs

Outputs

The featured ad is the one shown on the node card. Choose it with the thumbnail strip, the ‹ › arrows or a click on a row in the Results tab. A workflow run features the first returned ad.

Each ad in the JSON output has these fields:

{
  "adArchiveId": "866569929827744",
  "adLibraryUrl": "https://www.facebook.com/ads/library/?id=866569929827744",
  "pageName": "Nike",
  "pageId": "15087023444",
  "startDate": "2026-09-01T07:00:00.000Z",
  "endDate": null,
  "isActive": true,
  "platforms": ["FACEBOOK", "INSTAGRAM"],
  "text": "Just do it.",
  "title": "Air Max",
  "caption": "nike.com",
  "ctaText": "Shop now",
  "linkUrl": "https://nike.com/airmax",
  "images": ["https://…/creative.jpg"],
  "videos": ["https://…/creative.mp4"],
  "videoPreviews": ["https://…/poster.jpg"],
  "collationCount": 3
}

Each ad also has a format and a creatives list, with the kind, link, size and format of each creative. When AI analysis is on, each analysed ad has an analysis object with the analyst's findings.

Results

The node card features one ad: its creative, advertiser, headline, copy, format, platforms, run dates and call to action. The Results tab of the settings panel lists every ad, in a List, Grid or Raw JSON view, and can filter them by format. Every row links to the ad's own page in the Ad Library.

A run that returns nothing, or fails, keeps the previous good results on the node. When you change an input, those results are marked as stale until the next run.

Creatives in your library

Meta's image and video links expire within days. After every run, the node copies each returned ad's images and video posters into your library. They count toward your storage, and they stay out of the media picker until you click Save to library on an ad.

The featured ad's video is copied only when the Creative video output is connected, because videos are large. Turn on Copy all videos to your library to copy the video of every returned ad. When your storage is full, the ads keep their original Meta links, which expire, and the run still succeeds. Use those creatives in the same workflow rather than keeping the links.

Credits

The price depends on the number of ads you request: Ads per source times the number of sources, rounded up to the next tier. A keyword search is one source, and each Page or picked advertiser is one source. The Run button on the node shows the exact price before you run it.

• The requested batch is charged. A narrow period or a quiet keyword may return fewer ads than requested.
• AI analysis adds a charge for every ad, by the tier of the analysis model: economy, standard or premium. It is reserved for the whole requested batch and settled for the ads actually analysed. An ad the model failed on, or one that a long run had no time left for, is refunded.
• Advertisers from the input. When a Text or List node supplies the advertiser names, the number of sources is known only when the node runs. Until then, the estimate on the node assumes one source.
• The advertiser lookup is free.

On a self-hosted install, the Meta Ads node needs the web-scraping key described in Provider keys, or a connection to Nodaro Cloud.

Tips

• Study retired creatives. Set Ad status to Inactive with a long period to see the ads an advertiser has already stopped.
• Fan out per ad. Use Extract Field on images or text before a List node to run one generation per ad.
• Use the video posters. The videoPreviews of a brand's video ads make good reference frames for new concepts.

Troubleshooting

From the API

POST /v1/meta-ads-scrape runs the node from code. The API has two modes, keyword search and Pages: send a picked advertiser as its Facebook Page address. A run that copies every video and analyses every ad often takes longer than the limit of about 100 seconds on a single HTTP request, so send "respondAsync": true. The call then answers at once with a jobId, and you read the ads from the completed job with GET /v1/jobs/:id.

Without the flag, the request stays open until the run is done. A run that outlasts the request limit is cut off on the way back, although the job completes and is charged. See Run a single node and Jobs.