ScavioInstall

Summary

Searches the Meta Ad Library for ads matching a required keyword or phrase. You can filter by status, ad type, country, media type, or phrase-matching mode, and use a returned cursor to request the next page.

Inputs

• Query (required) — Keyword or phrase to search for, such as “skincare serum”.
• Active Status — Choose active, inactive, or all ads; defaults to all.
• Ad Type — Choose all ads or political and issue ads; defaults to all. Spend, reach, impressions, and paid-for-by disclosure are available for political and issue ads; those fields are null for commercial ads.
• Country — Two-letter country code to search; defaults to US.
• Cursor — Use the response’s next_cursor value to fetch the next page. A cursor carries its own filters, so other filter values are ignored when it is supplied. The first page contains 30 ads and later pages contain 10 each.
• Media Type — Filter by creative media type: all, image, image and meme, meme, none, or video. Defaults to all.
• Search Type — Match the query as unordered keywords or as an exact phrase; defaults to unordered keywords.

Output shape

A response containing matching ad data and pagination information.

The operation’s pagination uses next_cursor; provide it as Cursor to continue. Political-ad reporting fields are null for commercial ads.

Links

• n8n community nodes installation guide