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

# Meta Ads scraper

> Search the public Meta Ad Library and return real ad creatives for a query.

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

<ParamField body="Query" type="text" required>
  The search query. Connect a Text Prompt node. Required.
</ParamField>

## Outputs

<ParamField body="Results" type="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.
</ParamField>

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

<ParamField body="Max Results" type="number" default="10">
  Maximum number of ads to return. Range: 1 to 50.
</ParamField>

<ParamField body="Platform" type="string" default="Both">
  Which platform to search: **Facebook**, **Instagram**, or **Both**.
</ParamField>

<ParamField body="Period" type="string" default="Last 30 days">
  Time window for results: **Last 24 hours**, **Last 7 days**, **Last 30 days**, or **All time**.
</ParamField>

<ParamField body="Ad Status" type="string" default="All">
  Filter by ad status: **Active**, **Inactive**, or **All**.
</ParamField>

<ParamField body="Country" type="string" default="All countries">
  Restrict results to a single country, or leave as **All countries**.
</ParamField>

<ParamField body="Media Type" type="string" default="All">
  Filter by creative type: **All**, **Images**, or **Videos**.
</ParamField>

### Analysis (optional)

Leave blank to get the default count summary at no extra cost.

<ParamField body="Analysis Prompt" type="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.
</ParamField>

<ParamField body="Analysis Model" type="string" default="Gemini 2.5 Flash">
  The AI model used to generate the analysis. Only applies when Analysis Prompt is set.
</ParamField>

<Note>
  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.
</Note>