Skip to main content
The Meta Ads Scraper node searches the public Meta Ad Library for Facebook and Instagram ads matching a query you connect. It returns structured ad records, the actual creative images and videos from those ads, and a text summary. Runs are repeatable: the node maps your settings directly to an Ad Library search instead of improvising one.

​
When to use

  • Competitive creative research — see what ads a brand or competitor is running
  • Ad inspiration — browse real creatives by keyword or topic
  • Trend analysis — filter by platform, country, or date range to spot creative patterns
Common pattern: text_prompt → meta_ads_scraper.

​
Inputs

​
Query
text
required
The search query. Connect a Text Prompt node. Required.

​
Outputs

​
Results
any
Everything the scrape produced — ad records, creative images, videos, and the summary — as one connectable output. Connect it to an AI node’s Context input to analyse or rewrite the content.

​
Referencing results in prompts

Connect Results to a Generate Text node’s Context input. Each item gets a stable name you can use in your prompt — [post_1], [image_2], [text_1] — e.g. “Rewrite the copy of post_2 for our brand voice; ignore the rest.”

​
Configuration

​
Max Results
number
default:"10"
Maximum number of ads to return. Range: 1–50.
​
Platform
string
default:"Both"
Which platform to search: Facebook, Instagram, or Both.
​
Period
string
default:"Last 30 days"
Time window for results: Last 24 hours, Last 7 days, Last 30 days, or All time.
​
Ad Status
string
default:"All"
Filter by ad status: Active, Inactive, or All.
​
Country
string
default:"All countries"
Restrict results to a single country, or leave as All countries.
​
Media Type
string
default:"All"
Filter by creative type: All, Images, or Videos.

​
Analysis (optional)

Leave blank to get the default count summary at no extra cost.
​
Analysis Prompt
string
Custom instructions for the AI model. When set, the model reads all fetched ads and writes a summary following your instructions (e.g. “Summarise the messaging strategies used”). Adds 1 credit per run.
​
Analysis Model
string
default:"Gemini 2.5 Flash"
The AI model used to generate the analysis. Only applies when Analysis Prompt is set.
Results come from the public Meta Ad Library and reflect publicly available ad data. This node costs 1 credit per run, plus 1 additional credit when AI analysis is enabled.